refund_undeliverable - Useroutr

Retryable

No

Typical status

409

What it means

This is the one state that always needs a human. The intent is in refund_failed and the funds are held, not lost.

Common causes

The payer is an exchange deposit address that cannot receive a refund.
No refund endpoint was collected and the source is not reliably refundable.
The refund destination has since become invalid.

How to resolve

Collect a valid refund endpoint from the payer and retry the refund. Our checkout collects one before payment on rails where the payer is not reliably refundable, which prevents most occurrences.

Funds in refund_failed are held on the ledger against a named liability. They are never written off.

Example response

{
  "error": {
    "code": "refund_undeliverable",
    "message": "...",
    "type": "...",
    "retryable": false,
    "docs_url": "https://docs.useroutr.com/errors/refund_undeliverable",
    "request_id": "req_..."
  }
}