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

code

statusCode

message

VALIDATION_ERROR

400

Validation error

AUTHORIZATION_ERROR

401

Authorization error

FORBIDDEN_ERROR

403

Forbidden error

NOT_FOUND_ERROR

404

Not found error

INTERNAL_SERVER_ERROR

500

Internal 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 Code

statusCode

CREATE_PAYMENT_METHOD_FAILED

400

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.

code

message

PAYMENT_METHOD_DECLINED

The card has been declined. Please review the card information, contact the card issuer, or use another card before creating the payment method.

PROCESSOR_CHARGE_ERROR

The payment could not be processed. Please reach out to Plastiq support for additional information before creating the payment method.

PAYMENT_METHOD_ERROR

The 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_INVALID

The card could not be verified. Please review the card information, contact the card issuer, or use another card before creating the payment method.

PROCESSOR_OUTAGE

The 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
Did this page help you?