Card Payments - Natural Docs

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.

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.
`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.
`card_payment_not_found`	404	Card payment not found.
`already_exists`	409	The resource already exists.
`conflict`	409	The request conflicts with the current resource state.
`idempotency_key_reused`	409	This idempotency key was already used for a different request. Use a new key only for a genuinely new operation.
`idempotency_request_in_progress`	409	A request with this idempotency key is still processing. Retry the same request with the same key.
`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.
`service_unavailable`	503	The service is temporarily unavailable.