Payment Intents Error Reference
The table below outlines the error codes returned by our Payment Intents API. These codes are designed to surface issues such as empty or malformed requests, invalid or inactive merchant credentials, missing required fields (e.g., title, amount, intent ID, or payment types), and operations not permitted due to the current intent status or expiration state. Each error is paired with an HTTP status code to indicate the type of failure encountered.
| Error Code | Description | Status Code |
|---|---|---|
| Key_InvalidRequest | The request payload is empty or missing required fields. Ensure you include all necessary parameters in your request. | 400 |
| Key_InvalidMerchant | The merchant credentials provided are invalid or unrecognized. Verify your merchant ID and API key. | 400 |
| Key_MerchantInActive | The merchant account is currently inactive. Contact support to reactivate your account before proceeding. | 400 |
| Key_TitleCanNotbeNullOrEmpty | The payment intent’s title is required and cannot be null or empty. Provide a valid title for the intent. | 400 |
| Key_InvalidAmount | The amount specified is invalid. It must be a positive number within the allowed range. | 400 |
| Key_IntentCannotBeNullOrEmpty | The payment intent ID is required and cannot be null or empty. Specify a valid intent identifier. | 400 |
| Key_PaymentTypesCannotBeNullOrEmpty | At least one payment type must be provided. The paymentTypes list cannot be null or empty. | 400 |
| Key_InvalidPaymentIntentStatus | The current status of the payment intent does not allow this operation. Only pending intents can be expired. | 400 |
| Key_PaymentIntentAlreadyExpired | The payment intent has already expired and cannot be expired again. Check the intent’s expiration timestamp. | 400 |