Payment Errors - Method API Docs

Request Errors

The request to the /payments endpoint failed. These are the sub_type that can be returned.

`INVALID_REQUEST`

The request body failed basic validation for the specific API endpoint.

`NOT_FOUND`

The requested resource does not exist.

`INVALID_AMOUNT_TYPE`

Amount type should be integers expressed as decimals.

`INVALID_AMOUNT`

The minimum amount for a payment is 100 cents ($1.00). The maximum amount for a payment is 100,000,000 cents ($1,000,000.00).

`INVALID_ACH_DESCRIPTION`

The ACH description should be a string with a maximum of 10 characters.

`INVALID_SOURCE`

Source Account provided is invalid. Account either doesn’t exist or is not active.

`INVALID_SOURCE_HOLDER_CAPABILITIES`

Source Account holder is not allowed to send funds.

`INVALID_SOURCE_HOLDER_LIMITED`

Source Account holder is limited to sending funds from Accounts linked using Method Link (Plaid / MX).

`INVALID_SOURCE_LIABILITY`

Source Account cannot be of type liability.

`INVALID_DESTINATION`

Destination Account provided is invalid. Account either doesn’t exist or is not active.

`INVALID_DESTINATION_HOLDER`

Destination Account holder is not allowed to receive funds.

`INVALID_ACH_DESTINATION_NOT_ALLOWED`

Payments to an ACH destination account are not enabled. Contact support to enable this capability.

`INVALID_TEST_DESTINATION`

Destination Account was created before live mode was enabled.

`INVALID_TEST_SOURCE`

Source Account was created before live mode was enabled.

`INVALID_TRANSFER`

Cannot transfer funds between the same Account.

`MAX_AMOUNT_EXCEEDED`

The organization’s max one-time transfer amount exceeded.

`MAX_DAILY_VOLUME_EXCEEDED`

The organization’s max 24-hour total transfer volume has been exceeded. Contact support to extend this limit.

`MAX_DAILY_ACH_DESTINATION_VOLUME_EXCEEDED`

The organization’s max 24-hour total transfer volume to ACH destination accounts has been exceeded. Contact support to extend this limit.

`MAX_DAILY_ACH_INDI_SOURCE_VOLUME_EXCEEDED`

The organization’s max 24-hour total transfer volume from ACH source accounts held by an individual has been exceeded. Contact support to extend this limit.

`MAX_REQUEST_LIMIT`

The organization’s monthly payment request limit has been reached. Contact support to extend this limit.

`MAX_PAYMENT_METADATA_SIZE_EXCEEDED`

Max metadata object size of 1KB exceeded.

`INVALID_SOURCE_CAPABILITIES`

Source Account is not verified to send payments.

`INVALID_DESTINATION_CAPABILITIES`

Destination Account is not verified to receive payments.

`INVALID_DESTINATION_BALANCE`

Destination Account has a balance of $0.

`INVALID_SOURCE_SINGLE_USE_CLEARING`

Source Account is a single-use clearing account, and has already been used for a payment.

`INTERNAL_ERROR_DESTINATION`

The payment could not be deleted due to an unexpected error on the destination side. Retry the request; contact support if it persists.

`INTERNAL_ERROR_SOURCE`

The payment could not be deleted due to an unexpected error on the source side. Retry the request; contact support if it persists.

`INVALID_DESTINATION_CONNECTION`

The payment connection for this destination account is currently unavailable.

`INVALID_DESTINATION_HOLDER_KYC_STATUS`

The destination account holder failed KYC status evaluation and the Entity has been disabled.

`INVALID_REVERSAL_ACCOUNT`

The reversal account provided is invalid.

`INVALID_REVERSAL_ACCOUNT_CAPABILITIES`

The reversal account is not verified to receive funds. Select another reversal account.

`INVALID_REVERSAL_ACCOUNT_HOLDER`

The reversal account holder is not allowed to receive funds. Verify that the Entity is complete.

`INVALID_REVERSAL_ACCOUNT_HOLDER_KYC_STATUS`

The reversal account holder failed KYC status evaluation and the Entity has been disabled.

`INVALID_REVERSAL_ACCOUNT_LIABILITY`

Liability accounts cannot be used as a reversal account; use an ACH or wire account.

`INVALID_SOURCE_HOLDER_KYC_STATUS`

The source account holder failed KYC status evaluation and the Entity has been disabled.

`INVALID_SOURCE_NOT_ALLOWED`

The source account is not an allowed payment source.

`INVALID_SOURCE_WIRE`

Wire accounts cannot be used as a payment source. Only ACH accounts can be used as a source.

`INVALID_STATUS`

The payment cannot be deleted. Payments can be canceled only while pending, or stopped and reversed only when sent by paper check and not yet cashed.

Resource Errors

Errors set on a Payment’s error property for processes that are unsuccessful.

`10001 – PAYMENT_INSUFFICIENT_FUNDS`

Payment failed due to insufficient funds from the source Account.

{
  "type": "PAYMENT_FAILED",
  "code": 10001,
  "sub_type": "PAYMENT_INSUFFICIENT_FUNDS",
  "message": "Payment failed due to insufficient funds from the source account."
}

`10002 – PAYMENT_UNAUTHORIZED`

The Payment was unauthorized by the source or destination Account holder.

{
  "type": "PAYMENT_FAILED",
  "code": 10002,
  "sub_type": "PAYMENT_UNAUTHORIZED",
  "message": "Payment failed due to a report by the source or destination account holder as unauthorized."
}

`10003 – PAYMENT_INVALID_ACCOUNT`

The Payment failed due to an invalid source or destination Account. The Account is either inactive or does not exist.

{
  "type": "PAYMENT_FAILED",
  "code": 10003,
  "sub_type": "PAYMENT_INVALID_ACCOUNT",
  "message": "Payment failed due to an invalid source or destination account."
}

`10004 – PAYMENT_INSUFFICIENT_FUNDS`

Payment was canceled due to insufficient funds from the source Account.

{
  "type": "PAYMENT_CANCELED",
  "code": 10004,
  "sub_type": "PAYMENT_INSUFFICIENT_FUNDS",
  "message": "Payment was canceled due to insufficient funds from the source account."
}

`10005 – PAYMENT_UNAUTHORIZED_SOURCE`

The Payment failed due to a report by the source Account holder as unauthorized.

{
  "type": "PAYMENT_FAILED",
  "code": 10005,
  "sub_type": "PAYMENT_UNAUTHORIZED_SOURCE",
  "message": "Payment failed due to a report by the source account holder as unauthorized."
}

`10006 – PAYMENT_UNAUTHORIZED_DESTINATION`

The Payment failed due to a report by the destination Account holder as unauthorized.

{
  "type": "PAYMENT_FAILED",
  "code": 10006,
  "sub_type": "PAYMENT_UNAUTHORIZED_DESTINATION",
  "message": "Payment failed due to a report by the destination account holder as unauthorized."
}

`10007 – PAYMENT_INVALID_SOURCE_ACCOUNT`

The source Account is invalid. The Account is either inactive or does not exist.

{
  "type": "PAYMENT_FAILED",
  "code": 10007,
  "sub_type": "PAYMENT_INVALID_SOURCE_ACCOUNT",
  "message": "Payment failed due to an invalid source account."
}

`10008 – PAYMENT_INVALID_DESTINATION_ACCOUNT`

The destination Account is invalid. The Account is either inactive or does not exist.

{
  "type": "PAYMENT_FAILED",
  "code": 10008,
  "sub_type": "PAYMENT_INVALID_DESTINATION_ACCOUNT",
  "message": "Payment failed due to an invalid destination account."
}

`10009 – PAYMENT_REJECTED_BY_DESTINATION_INSTITUTION`

The Payment was rejected by the destination Account’s FI.

{
  "type": "PAYMENT_FAILED",
  "code": 10009,
  "sub_type": "PAYMENT_REJECTED_BY_DESTINATION_INSTITUTION",
  "message": "Payment failed due to a rejection by the destination account's financial institution."
}

`10010 – PAYMENT_REJECTED_INVALID_AMOUNT`

The payment failed due to a rejection by the destination account’s financial institution to accept the payment amount.

{
  "type": "PAYMENT_FAILED",
  "code": 10010,
  "sub_type": "PAYMENT_REJECTED_INVALID_AMOUNT",
  "message": "Payment failed due to a rejection by the destination account's financial institution to accept the payment amount."
}

`10011 – PAYMENT_STOPPED_BY_REQUEST`

The payment failed as it was stopped by request before completion.

{
  "type": "PAYMENT_FAILED",
  "code": 10011,
  "sub_type": "PAYMENT_STOPPED_BY_REQUEST",
  "message": "Payment failed as it was stopped by request before completion."
}

​Request Errors

​INVALID_REQUEST

​NOT_FOUND

​INVALID_AMOUNT_TYPE

​INVALID_AMOUNT

​INVALID_ACH_DESCRIPTION

​INVALID_SOURCE

​INVALID_SOURCE_HOLDER_CAPABILITIES

​INVALID_SOURCE_HOLDER_LIMITED

​INVALID_SOURCE_LIABILITY

​INVALID_DESTINATION

​INVALID_DESTINATION_HOLDER

​INVALID_ACH_DESTINATION_NOT_ALLOWED

​INVALID_TEST_DESTINATION

​INVALID_TEST_SOURCE

​INVALID_TRANSFER

​MAX_AMOUNT_EXCEEDED

​MAX_DAILY_VOLUME_EXCEEDED

​MAX_DAILY_ACH_DESTINATION_VOLUME_EXCEEDED

​MAX_DAILY_ACH_INDI_SOURCE_VOLUME_EXCEEDED

​MAX_REQUEST_LIMIT

​MAX_PAYMENT_METADATA_SIZE_EXCEEDED

​INVALID_SOURCE_CAPABILITIES

​INVALID_DESTINATION_CAPABILITIES

​INVALID_DESTINATION_BALANCE

​INVALID_SOURCE_SINGLE_USE_CLEARING

​INTERNAL_ERROR_DESTINATION

​INTERNAL_ERROR_SOURCE

​INVALID_DESTINATION_CONNECTION

​INVALID_DESTINATION_HOLDER_KYC_STATUS

​INVALID_REVERSAL_ACCOUNT

​INVALID_REVERSAL_ACCOUNT_CAPABILITIES

​INVALID_REVERSAL_ACCOUNT_HOLDER

​INVALID_REVERSAL_ACCOUNT_HOLDER_KYC_STATUS

​INVALID_REVERSAL_ACCOUNT_LIABILITY

​INVALID_SOURCE_HOLDER_KYC_STATUS

​INVALID_SOURCE_NOT_ALLOWED

​INVALID_SOURCE_WIRE

​INVALID_STATUS

​Resource Errors

​10001 – PAYMENT_INSUFFICIENT_FUNDS

​10002 – PAYMENT_UNAUTHORIZED

​10003 – PAYMENT_INVALID_ACCOUNT

​10004 – PAYMENT_INSUFFICIENT_FUNDS

​10005 – PAYMENT_UNAUTHORIZED_SOURCE

​10006 – PAYMENT_UNAUTHORIZED_DESTINATION

​10007 – PAYMENT_INVALID_SOURCE_ACCOUNT

​10008 – PAYMENT_INVALID_DESTINATION_ACCOUNT

​10009 – PAYMENT_REJECTED_BY_DESTINATION_INSTITUTION

​10010 – PAYMENT_REJECTED_INVALID_AMOUNT

​10011 – PAYMENT_STOPPED_BY_REQUEST