Plaid logo
Docs
ALL DOCS

Errors

  • Overview
  • Item errors
  • Institution errors
  • API errors
  • Assets errors
  • Payment errors
  • Transactions errors
  • Transfer errors
  • Income errors
  • Sandbox errors
  • Invalid Request errors
  • Invalid Input errors
  • Invalid Result errors
  • Rate Limit Exceeded errors
  • Link web errors
  • Recaptcha errors
  • OAuth errors
  • Microdeposits errors
  • Partner errors
Plaid logo
Docs
Plaid.com
Get API keys
Open nav

Payment Errors

Errors specific to the Payment Initiation product

PAYMENT_BLOCKED

The payment was blocked for violating compliance rules.
Common causes
  • The payment amount value when calling /payment_initiation/payment/create was too high.
  • Too many payments were created in a short period of time.
Troubleshooting steps
Copy
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}
Was this helpful?

PAYMENT_CANCELLED

The payment was cancelled.
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
Copy
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}
Was this helpful?

PAYMENT_INSUFFICIENT_FUNDS

The account has insufficient funds to complete the payment.
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
Copy
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}
Was this helpful?

PAYMENT_INVALID_RECIPIENT

The recipient was rejected by the chosen institution.
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
Copy
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}
Was this helpful?

PAYMENT_INVALID_REFERENCE

The reference was rejected by the chosen institution.
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
Copy
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}
Was this helpful?

PAYMENT_INVALID_SCHEDULE

The schedule was rejected by the chosen institution.
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
Copy
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}
Was this helpful?

PAYMENT_REJECTED

The payment was rejected by the chosen institution.
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
Copy
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}
Was this helpful?

PAYMENT_SCHEME_NOT_SUPPORTED

The requested payment scheme is not supported by the chosen institution.
User-facing error message
Payment failed: Try making your payment again or select a different bank to continue.
Common causes
  • The payment scheme specified when calling /payment_initiation/payment/create is not supported by the institution.
  • Scheme automatic downgrade failed.
Troubleshooting steps
Copy
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}
Was this helpful?
Developer community
GitHub
GitHub
Stack Overflow
Stack Overflow
YouTube
YouTube
Twitter
Twitter
Discord
Discord