| Code | Status | Detail |
|---|---|---|
customer_payout_wallet_unavailable | 400 | This business has no wallet that can receive this payment. |
invalid_pagination_cursor | 400 | The page cursor is not valid. Start the list again. |
invalid_value | 400 | The information you entered isn’t valid. Please check it and try again. |
payment_intent_amount_above_cap | 400 | This amount is above the current card payment cap. |
payment_intent_amount_below_fee | 400 | This amount is too small to cover the card fee. |
payment_intent_amount_below_minimum | 400 | Card payments must be at least $0.50. |
payment_intent_amount_component_mismatch | 400 | The payment amounts don’t add up. Check the line items and tax. |
payment_intent_card_do_not_retry | 400 | This card was declined. Use a different card. |
payment_intent_customer_descriptor_unavailable | 400 | This business has no valid statement descriptor for card payments. |
payment_intent_customer_limit_exceeded | 400 | This business cannot take this payment right now. |
payment_intent_customer_not_active | 400 | Card acceptance is not active for this business yet. |
payment_intent_customer_not_ready | 400 | This business cannot take card payments yet. |
payment_intent_expired | 400 | This payment intent has expired. |
payment_intent_invalid_expiration | 400 | expiresAt must be in the future. |
payment_intent_not_open | 400 | This payment intent already has a payment in progress or completed. |
unauthenticated | 401 | Authentication is required. |
forbidden | 403 | You do not have permission to perform this action. |
party_mismatch | 403 | You can only act for your own party or a party that has authorized you. |
payment_intent_embed_origin_not_allowed | 403 | This site isn’t on the account’s checkout domain list. |
payment_intent_not_found | 404 | Payment intent not found. |
already_exists | 409 | The resource already exists. |
conflict | 409 | The request conflicts with the current resource state. |
payment_intent_not_cancelable | 409 | This payment intent cannot be canceled in its current state. |
payment_intent_not_updatable | 409 | Only an open payment intent can be updated. |
payment_intent_terms_changed | 409 | The amount or items changed. Review them and pay again. |
rate_limited | 429 | Too many requests. Please try again later. |
server_error | 500 | Something went wrong. |
bad_gateway | 502 | We couldn’t complete that request because one of Natural’s services returned an unexpected response. Please try again. |
bad_gateway | 502 | Natural could not complete the request because one of its services returned an unexpected response. Try again. |
service_unavailable | 503 | The service is temporarily unavailable. |
Resource errors
Payment Intents
Public error codes for Payment Intents API endpoints
All error responses follow the standard error format.
Validation errors (422) and rate limit errors (429) apply to all endpoints and are documented in the Error Handling guide.
Was this page helpful?