| Code | Status | Detail |
|---|---|---|
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. |
refund_already_fully_refunded | 400 | This payment has already been fully refunded. |
refund_amount_exceeds_refundable | 400 | The refund amount is more than what remains refundable on this payment. |
refund_capture_not_accepted | 400 | The original card payment was not accepted by the processor. |
refund_capture_not_reversible | 400 | The original card payment cannot be reversed by the processor. |
refund_invalid_amount | 400 | The refund amount must be positive and in the payment’s currency. |
refund_payment_not_refundable | 400 | This payment intent has no successful card payment to refund. |
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. |
refund_not_found | 404 | Refund not found. |
already_exists | 409 | The resource already exists. |
conflict | 409 | The request conflicts with the current resource state. |
insufficient_funds | 409 | Your wallet balance is too low to fund this refund. |
refund_blocked_by_chargeback | 409 | A chargeback on this payment prevents refunds unless it is resolved in your favor. |
refund_in_flight | 409 | The processor is still working on another refund for this payment. |
refund_in_progress | 409 | Another refund for this payment is still in progress. |
refund_sandbox_unavailable | 409 | Sandbox refunds are not available in this environment yet. |
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
Refunds
Public error codes for Refunds 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?