source_inbox_unavailable

HTTP 503

When you see this

Only POST /api/v1/intents/{id}/source-inbox returns this error. Canopy checks each deposit address before it hands one out. The service that runs that check did not respond, even after Canopy retried once. This is a temporary problem on Canopy's side. Your request was not rejected.

What the response looks like

The response has a Retry-After header with the number of seconds to wait.

{
  "error": {
    "code": "source_inbox_unavailable",
    "message": "The deposit inbox gate is temporarily unavailable. Retry after the interval named in Retry-After.",
    "request_id": "req_1a2b3c4d5e6f7a8b9c0d1e2f",
    "docs": "https://canopypay.io/errors/source_inbox_unavailable"
  }
}

What to do

Wait at least Retry-After seconds. Then retry the same call. The retry is safe. Issuing a source inbox is idempotent, so the retry returns the same address the first call would have returned.