Payments error codes
Every public API error code emitted by Payments, with its HTTP status, its type and a page per code.
Error codes emitted by Payments. Each code links to its own page with the cause and the action to take.
| Code | Type | HTTP | Description |
|---|---|---|---|
invalid_payment_date | invalid_request_error | 422 | The payment date falls outside the accepted window: it cannot precede the invoice issue date, nor be in the future. |
payment_already_reversed | invalid_request_error | 422 | The payment is already reverted, and its trail is not overwritten by a second reversal: the reason, instant and author of the first one are the accounting record of why the invoice stopped being paid. |
payment_reversal_invalid | invalid_request_error | 422 | The reversal note is longer than the 500 characters allowed. |
payment_reversal_reason_invalid | invalid_request_error | 422 | The reversal reason is outside the closed catalog: only a returned SEPA direct debit, a card dispute or chargeback, a misapplied payment, a dishonoured bill and a recording error are accepted. |
payout_reconciliation_amount_mismatch | invalid_request_error | 422 | The confirmed amount does not match the net amount of the payout, so the reconciliation would close with a difference nobody accounts for. |
receipt_not_available | invalid_request_error | 422 | There is no receipt to issue because the document has no settled payment behind it. |
stripe_payout_already_reconciled | invalid_request_error | 422 | The payout was already reconciled, and reconciliation is terminal: repeating it would double-count the bank entry. |
stripe_payout_not_found | not_found_error | 404 | The identifier does not resolve to any payout of the authenticated company. |
Related
Error codes by category
Find an error by the category that emits it.
Full reference table
All codes, HTTP statuses, types and descriptions in one reference.
Error model
Interpret the error envelope and handle errors by code.