| Code | Status | Detail |
|---|---|---|
ach.not_cancellable | 400 | The ACH payment cannot be canceled. |
ach.rejected | 400 | The ACH payment could not be initiated. |
external_party_account.validation_failed | 400 | The bank account did not pass validation. |
external_party.archived | 400 | External party is archived. |
external_party.screening_not_clear | 400 | The external party has not cleared screening. |
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. |
party.descriptor_name_unavailable | 400 | The party needs a legal name, or a first and last name, before it can send this payment. |
policy.denied | 400 | This payment was denied by your account’s policy. |
wallet.insufficient_balance | 400 | Wallet has insufficient available balance. |
wallet.required | 400 | Select a wallet for this payment. |
unauthenticated | 401 | Authentication is required. |
ach.not_enabled | 403 | ACH is not enabled for this account. |
forbidden | 403 | You do not have permission to perform this action. |
policy.forbidden | 403 | This payment is not allowed by your account’s policy. |
not_found | 404 | The requested resource was not found. |
already_exists | 409 | The resource already exists. |
conflict | 409 | The request conflicts with the current resource state. |
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. |
wallet.balance_unavailable | 503 | Wallet balance is temporarily unavailable. |
Resource errors
ACH
Public error codes for ACH 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?