API Reference

Pay Run Entities

Where a status is a Processing status it is in a state that might change.

StatusPhaseDescriptionPay RunBatchGroupPayable
InvalidFinalEntity is not valid for payment. Generally represents a validation error or other backend issue during payable creation.
OpenReady to be paid.
ProcessedFInalProcessing has been concluded.
CancelledFinalEntity has been cancelled and can no longer be paid.
PartiallyProcessedProcessingProcessing is partially complete. Some child entities have been processed.
PartiallyProcessedAndCancelledProcessingProcessing is partially complete and has been cancelled. Some child entities have been processed, the remainder have been cancelled and can no longer be paid.
UserInitiationInProgressProcessingThe user initiation phase of payment is currently underway. Generally this means the user is in the process of authorising a batch.
UserInitiationInProgressAndCancelledProcessingThe user initiation phase of paying a batch is currently underway and the entity has been cancelled. Because the user is in the process of authorising payments and the entity will transition to Processed, TransfersInProgress, Cancelled or PartiallyProcessedAndCancelled once complete
TransfersInProgressProcessingUser initiation is complete and the transfer of funds is now in progress. The batch will transition to Processed, TransfersInProgress, TransfersInProgressAndCancelled, Cancelled or Open.
TransfersInProgressAndCancelledProcessingUser initiation is complete and the transfer of funds is now in progress and/or the pay run has been cancelled. The pay run will transition to Processed, PartiallyProcessedAndCancelled or Cancelled once transfer is complete or fails.

Pay Run States

Pay Run States

Batch, Group and Payable States

Batch, Group and Payable States

Authorisation

StatusDescription
CreatedNew authorisation attempt has been created
UserAuthorisingUser authorisation in progress
BankAuthorisingUser authorisation complete, bank authorisation and verification in progress
AwaitingMultiAuthAuthorisation is blocked awaiting one or more additional authentications
ProcessedPayment initiation complete
FailedAuthorisation failed
CancelledAuthorisation attempt cancelled by user
TimedOutAuthorisation timed out

Authorisation States

Authorisation States

Organisation Onboarding

StatusDescription
InitiatedOrganisation onboarding initiated
AuthenticatedOrganisation user authenticated
BankSelectedOrganisation user selected bank
AccountsConnectedOrganisation user bank accounts connected
CompleteOrganisation onboarding complete

Organisation Onboarding States

Event Payloads

AccountsConnected

{
    BankAccountIds: ["bb523a39-0e22-45cd-8c20-73302e87296a", "21ae3b48-ccb3-4cb1-9c7f-2640d3811e29"]
}

Bank Account

StatusDescription
ActiveThe bank account has a valid consent
DisconnectedThe bank account's consent has expired or been revoked