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

codestatusCodemessage
VALIDATION_ERROR400Validation error
AUTHORIZATION_ERROR401Authorization error
FORBIDDEN_ERROR403Forbidden error
NOT_FOUND_ERROR404Not found error
INTERNAL_SERVER_ERROR500Internal Server Error

Payment Method Errors

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

Top-level Error CodestatusCode
CREATE_PAYMENT_METHOD_FAILED400

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.

codemessage
PAYMENT_METHOD_DECLINEDThe card has been declined. Please review the card information, contact the card issuer, or use another card before creating the payment method.
PROCESSOR_CHARGE_ERRORThe payment could not be processed. Please reach out to Plastiq support for additional information before creating the payment method.
PAYMENT_METHOD_ERRORThe card could not be verified. Please review the card information, use another card, or contact the card issuer for more information before creating the payment method.
PAYMENT_METHOD_INVALIDThe card could not be verified. Please review the card information, contact the card issuer, or use another card before creating the payment method.
PROCESSOR_OUTAGEThe card processor is experiencing a temporary outage. Please wait a moment before creating the payment method.

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.


What’s Next