Errors

Error Object Format

📘

Nested Errors

Plastiq Connect can return multiple errors in a single payload. These errors are contained within the details array.

{
  "code": "ERROR_CODE",
  "message": "Error code explanation",
  "details": [
    {
      "details": "Example issue with request: request.somePart"
    }
  ],
  "statusCode": 400,
  "traceId": "fe278caa-e01d-4910-b975-5c19c21a6d8e"
}

Generic Error Codes

Payment Method Errors

Payment Method creation and mutation requests generate granular errors that enable integrating platforms to provide better feedback to their end-users

Payment Errors

Payment creation and mutation requests generate granular errors that enable integrating platforms to provide better feedback to their end-users.

Synchronous Card Payment Errors

The Payment Method utilized to create a Payment will largely determine whether the feedback will be synchronous or asynchronous. Card Payments will return synchronous feedback from the card processor at the time of charge attempt.

Please see the section below on synchronous card Payment errors.

Asynchronous Bank Account Payment Errors

Bank account Payments will mostly return asynchronous feedback from our banking partner when the ACH pull is attempted.

For more details about codes returned for bank account Payments, please see the section on Test Bank Accounts.