Forbidden

HTTP 403   forbidden

What it means

The key is valid but its role may not do this: a Device key sending a payment, a no-refunds role refunding, or a key acting on a TxGold system account.

What to do

Use an integration with the Integration role for back-office work. An Admin can change an integration's role in the business portal.

The response

HTTP/1.1 403
Content-Type: application/problem+json

{
  "type": "https://docs.txgold.money/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "code": "forbidden",
  "detail": "…",
  "requestId": "7219af94e39d"
}

Branch on code, never on title or detail: the code never changes once published, and the text may. Quote requestId to TxGold support. See all errors.