ExecutionError 502

When does this happen?

The payment rail rejected or failed to process the transaction. The reason field (when present) contains rail-specific failure details.

Example response

{
  "_tag": "ExecutionError",
  "type": "ExecutionError",
  "message": "Payment rail returned an error",
  "reason": "insufficient_funds",
  "docs_url": "https://docs.borderli.dev/errors/ExecutionError"
}

What to do

Retry with exponential backoff using the same idempotency key. If the error persists, check the reason field for actionable details.

← Back to Error Handling