Payment Errors

Errors specific to the Payment Initiation product

PAYMENT_BLOCKED

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

PAYMENT_INSUFFICIENT_FUNDS

The payment was unable to be completed because the chosen account did not have enough funds.
Client-Side
Common causes
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "PAYMENT_ERROR",
"error_code": "PAYMENT_INSUFFICIENT_FUNDS",
"error_message": "insufficient funds to complete the request",
"display_message": "There isn't enough money in this account to complete the payment. Try again, or select another account or bank.",
"request_id": "HNTDNrA8F1shFEW"
}

PAYMENT_INVALID_RECIPIENT

The recipient was rejected by the chosen institution.
Client-Side
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
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "PAYMENT_ERROR",
"error_code": "PAYMENT_INVALID_RECIPIENT",
"error_message": "payment recipient invalid",
"display_message": "The payment recipient is invalid for the selected institution. Create a new payment with a different recipient.",
"request_id": "HNTDNrA8F1shFEW"
}

PAYMENT_INVALID_REFERENCE

The reference was rejected by the chosen institution.
Client-Side
Common causes
  • The reference is too long or contains special characters.
Troubleshooting steps
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "PAYMENT_ERROR",
"error_code": "PAYMENT_INVALID_REFERENCE",
"error_message": "payment reference invalid",
"display_message": "The payment reference is invalid for the selected institution. Create a new payment with a different reference.",
"request_id": "HNTDNrA8F1shFEW"
}

PAYMENT_INVALID_SCHEDULE

The schedule was rejected by the chosen institution.
Client-Side
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
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "PAYMENT_ERROR",
"error_code": "PAYMENT_INVALID_SCHEDULE",
"error_message": "payment schedule invalid",
"display_message": "The payment schedule is invalid for the selected institution. Create a new payment with a different schedule.",
"request_id": "HNTDNrA8F1shFEW"
}