Payment Errors

Errors specific to the Payment Initiation product

PAYMENT_BLOCKED

The payment was blocked for violating compliance rules.
Common causes
Troubleshooting steps
1http code 400
2{
3 "error_type": "PAYMENT_ERROR",
4 "error_code": "PAYMENT_BLOCKED",
5 "error_message": "payment blocked",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

PAYMENT_CANCELLED

The payment was cancelled.
Sample user-facing error message
Payment cancelled: Try making your payment again or select a different bank to continue.
Common causes
  • The payment was cancelled by the user during the authorisation process
Troubleshooting steps
1http code 400
2{
3 "error_type": "PAYMENT_ERROR",
4 "error_code": "PAYMENT_CANCELLED",
5 "error_message": "user cancelled the payment",
6 "display_message": "Try making your payment again or select a different bank to continue.",
7 "request_id": "HNTDNrA8F1shFEW"
8}

PAYMENT_INSUFFICIENT_FUNDS

The account has insufficient funds to complete the payment.
Sample user-facing error message
Insufficient funds: There isn't enough money in this account to complete the payment. Try again, or select another account or bank.
Common causes
  • The account selected has insufficient funds to complete the payment.
Troubleshooting steps
1http code 400
2{
3 "error_type": "PAYMENT_ERROR",
4 "error_code": "PAYMENT_INSUFFICIENT_FUNDS",
5 "error_message": "insufficient funds to complete the request",
6 "display_message": "There isn't enough money in this account to complete the payment. Try again, or select another account or bank.",
7 "request_id": "HNTDNrA8F1shFEW"
8}

PAYMENT_INVALID_RECIPIENT

The recipient was rejected by the chosen institution.
Sample user-facing error message
Payment failed: Try making your payment again or select a different bank to continue.
Common causes
  • The recipient name is too long or contains special characters.
  • The address is too long or contains special characters.
  • The account number is invalid.
Troubleshooting steps
1http code 400
2{
3 "error_type": "PAYMENT_ERROR",
4 "error_code": "PAYMENT_INVALID_RECIPIENT",
5 "error_message": "payment recipient invalid",
6 "display_message": "The payment recipient is invalid for the selected institution. Create a new payment with a different recipient.",
7 "request_id": "HNTDNrA8F1shFEW"
8}

PAYMENT_INVALID_REFERENCE

The reference was rejected by the chosen institution.
Sample user-facing error message
Payment failed: Try making your payment again or select a different bank to continue.
Common causes
  • The reference is too long or contains special characters.
Troubleshooting steps
1http code 400
2{
3 "error_type": "PAYMENT_ERROR",
4 "error_code": "PAYMENT_INVALID_REFERENCE",
5 "error_message": "payment reference invalid",
6 "display_message": "The payment reference is invalid for the selected institution. Create a new payment with a different reference.",
7 "request_id": "HNTDNrA8F1shFEW"
8}

PAYMENT_INVALID_SCHEDULE

The schedule was rejected by the chosen institution.
Sample user-facing error message
Payment failed: Try making your payment again or select a different bank to continue.
Common causes
  • The chosen institution does not support negative payment execution days.
  • The first payment date is a holiday or on a weekend.
Troubleshooting steps
1http code 400
2{
3 "error_type": "PAYMENT_ERROR",
4 "error_code": "PAYMENT_INVALID_SCHEDULE",
5 "error_message": "payment schedule invalid",
6 "display_message": "The payment schedule is invalid for the selected institution. Create a new payment with a different schedule.",
7 "request_id": "HNTDNrA8F1shFEW"
8}

PAYMENT_REJECTED

The payment was rejected by the chosen institution.
Sample user-facing error message
Payment failed: Try making your payment again or select a different bank to continue.
Common causes
  • The amount was too large.
  • The payment was considered suspicious by the institution.
Troubleshooting steps
1http code 400
2{
3 "error_type": "PAYMENT_ERROR",
4 "error_code": "PAYMENT_REJECTED",
5 "error_message": "payment rejected",
6 "display_message": "The payment was rejected by the institution. Try again, or select another account or bank.",
7 "request_id": "HNTDNrA8F1shFEW"
8}

PAYMENT_SCHEME_NOT_SUPPORTED

The requested payment scheme is not supported by the chosen institution.
Sample user-facing error message
Payment failed: Try making your payment again or select a different bank to continue.
Common causes
Troubleshooting steps
1http code 400
2{
3 "error_type": "PAYMENT_ERROR",
4 "error_code": "PAYMENT_SCHEME_NOT_SUPPORTED",
5 "error_message": "payment scheme not supported",
6 "display_message": "The payment scheme is not supported by the institution. Either change scheme or select another institution.",
7 "request_id": "HNTDNrA8F1shFEW"
8}