Skip to content

Payout response codes

Last updated: 9th August 2022

After you've sent your payout request and got a successful response, you will receive a webhook notification that will tell you the status of your payout and include a response code and summary:

  • If your payout is successful, you will receive a payment_paid webhook, with a 10000 response code and the Approved summary.
  • If your payout is declined, you will receive a payment_declined webhook with a 50001-50399 response code and a summary explaining the reason for the decline.
  • If your payout is returned, you will receive a payment_returned webhook with 50401-50599 response code and a summary explaining the reason for the return.

Below, you'll find all the response codes you could receive and their summaries.


Payment paid

CodeSummary

Approval response

10000

Approved

Payment declined

CodeSummary

Decline responses

50001

Compliance error

50002

Sanctions screening rejected error

50020

Recipient error

50021

Invalid recipient error

50022

Unsupported recipient error

50023

Recipient limit error

50070

Sender error

50100

Instruction error

50101

Instruction amount limit error

50102

Instruction amount limit sender error

50103

Instruction amount limit recipient error

50104

Velocity limit

50105

Velocity limit sender error

50106

Velocity limit recipient limit error

50150

Processing error

50180

Validation error

50200

Configuration error

50240

Cancellation error

50260

Returned error

50399

Unmapped response


Payment returned

CodeSummary

Return responses

50401

Bank details invalid

50402

Account not found

50403

Account inactive

50404

Account dormant

50405

Account number invalid

50406

Branch not found

50407

Branch code invalid

50408

Branch code required

50409

Bank code invalid

50410

Bank code required

50441

Account type required

50451

Account holder details invalid

50452

Account holder identification number required

50453

Account holder type not supported

50454

Account holder type not allowed

50466

Account closed

50471

Account blocked

50481

Invalid debtor account type

50491

Account holder billing address details incorrect

50492

Account holder billing address details required

50494

Account holder billing address can not be PO box

50501

Unsupported characters

50511

Invalid amount

50512

Minimum amount not met

50513

Exceeded transaction value

50514

Exceeded daily limit

50515

Exceeded weekly limit

50517

Exceeded monthly limit

50531

Recalled

50599

Unknown reason