internal_error

HTTP 500

When you see this

Any operation in the API can return this error. It means the work failed for a reason unrelated to your request, such as a failing dependency or an unexpected exception. Every other error code is about something in the request. This one is about Canopy.

What the response looks like

{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong creating this intent.",
    "request_id": "req_1a2b3c4d5e6f7a8b9c0d1e2f",
    "docs": "https://canopypay.io/errors/internal_error"
  }
}

What to do

Retry reads and repeatable operations with backoff.

Retrying an intent create that names the same destination and terms is safe. If the first request did not take effect, the retry runs it. If it did, the retry returns the same intent with created: false and does not create a second one. The retry rotates the widget token.

A create without destination fields is different. It may have completed before the failure, so repeating it creates another intent. Save and reuse the intent ID when you have it. Check whether the intent exists before you create again.

If the error continues after retries, contact support. Include the request_id from the error body. It identifies this exact request in Canopy's logs.