PaygateDeveloper documentation
422payments.provider_unavailablepaymentsRule R7

No provider could create an instrument

Every provider on the route for this method, amount and mode either refused or failed retriably, up to max_route_failover tries. The attempt is marked failed; the payment itself is still open.

Why the API refuses

WHEN an attempt is started, THE SYSTEM SHALL obtain ordered providers from providers.Route for the method, amount, tenant and mode, create the instrument at the first provider with an idempotency key derived from the payment id and attempt seq, and IF the provider returns a retriable error THEN THE SYSTEM SHALL try the next provider up to the tenant setting max_route_failover times before marking the attempt failed.

What to do

  • This is retriable, but not immediately and not in a tight loop. Back off — a few seconds, then tens of seconds — and start another attempt, or offer a different method.
  • Check the status page before assuming your integration is at fault; a provider outage looks exactly like this.
  • The underlying refusal is in providers.retriable, providers.no_route or providers.no_credential depending on cause, and the payment's attempt records which provider was tried.

Operations that can return it