customer_not_bound

HTTP 503

When you see this

Only POST /api/v1/intents/{id}/source-inbox returns this error. Canopy must link an intent to a deposit customer before it can issue a source inbox. That link is not ready yet for this intent. It resolves on its own shortly.

This code always means "retry". Problems that waiting cannot fix have their own codes. If deposit routing is not set up for the merchant, you get source_inbox_not_active. If Canopy refuses to issue the inbox, you get source_inbox_refused. Neither of those is retryable.

What the response looks like

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

{
  "error": {
    "code": "customer_not_bound",
    "message": "This intent's deposit customer is not bound yet. Safe to retry shortly.",
    "request_id": "req_1a2b3c4d5e6f7a8b9c0d1e2f",
    "docs": "https://canopypay.io/errors/customer_not_bound"
  }
}

What to do

Wait at least Retry-After seconds. Then retry the same call for the same intent. You do not need to change anything in the request. Canopy finishes the link on its side.