Payments Docs
Error codes

Errors / No bank gateway could take this payment

No bank gateway could take this payment

Code
gateway_unavailable
HTTP status
None: never an HTTP answer
Where you see it
A deposit's failure_code

How to fix it

Tip

A deposit's failure_code: when the customer started the bank gateway payment, none of your gateway terminals could take it (all turned off, none serves the customer's user level, or the chosen one just reached its daily amount cap and was turned off). Nothing was paid. Turn a terminal on again in your panel, then create a new deposit for the customer.

Where you see it

No request is ever answered with this code: the request that made the deposit got its 201 long before the deposit ended. It is the failure_code of a deposit that ended failed (only a live deposit ends this way), with its failure_message. You read it in the deposit (GET /v1/deposits/{id}) and in the data of the deposit.failed webhook.

The deposit (JSON)
{
  "id": "dep_01k6c3s0v1m2n3p4q5r6s7t8v9",
  "object": "deposit",
  "mode": "live",
  "status": "failed",
  "method": "bank_gateway",
  "amount": 1500000,
  "currency": "IRR",
  "amount_rials": 1500000,
  "fee_rials": null,
  "reference": "order-10542",
  "customer": {
    "id": "customer-77",
    "level": "default"
  },
  "payer": {
    "card_number": null,
    "account": null,
    "bank": null
  },
  "redirect_url": "https://shop.example/orders/order-10542/return",
  "webhook_url": "https://shop.example/webhooks/payments",
  "allowed_methods": null,
  "failure_code": "gateway_unavailable",
  "failure_message": "No bank gateway could take this payment",
  "version": 2,
  "created_at": "2026-10-03T09:30:00Z",
  "updated_at": "2026-10-03T09:30:12Z",
  "expires_at": "2026-10-03T09:45:00Z",
  "paid_at": null
}

Learn more