Facilitator Error Codes
The facilitator returns these error codes when payments are rejected or rate-limited. Log them for debugging.
Policy Error Codes
These policy:* codes are used when a payment payload violates transaction or sponsor policy.
| Code | Meaning |
|---|---|
policy:address_lookup_table_not_supported | Transaction uses Address Lookup Tables, which are not allowed in the current Solana policy path |
policy:program_not_allowed | The transaction invokes a disallowed program |
policy:malformed_instruction | An instruction could not be parsed correctly |
policy:compute_units_too_high | The transaction exceeds compute unit limits |
policy:priority_fee_too_high | The requested priority fee is above policy limits |
policy:compute_budget_instruction_not_allowed | An unsupported compute-budget instruction was used |
policy:unsupported_token_instruction | A token instruction other than the allowed transfer path was used |
policy:malformed_transfer_checked | The expected token transfer payload was malformed |
policy:amount_below_min | The payment amount was below the policy minimum |
policy:asset_not_allowed | The token is not currently in the allowlist |
policy:multiple_transfers | More than one transfer was detected where only one is allowed |
policy:no_transfer | A required transfer instruction was missing |
Backpressure Error Codes
These codes appear when the facilitator rate-limits activity to protect global, seller, or payer-level health.
| Code | Meaning |
|---|---|
global_verify_cap_exceeded | The global daily verify limit has been reached |
global_settle_cap_exceeded | The global daily settle limit has been reached |
global_fee_sponsored_cap_exceeded | The global sponsored-fee budget has been exhausted |
global_concurrency_cap_exceeded | Too many settlements are in flight at once |
seller_verify_cap_exceeded | A seller's daily verify limit has been reached |
seller_settle_cap_exceeded | A seller's daily settle limit has been reached |
seller_fee_sponsored_cap_exceeded | A seller's sponsored-fee budget has been exhausted |
seller_concurrency_cap_exceeded | Too many settlements are currently in flight for a seller |
payer_settle_cap_exceeded | A payer has exceeded the allowed settlement volume with a seller |
Using These Codes
Log errorCode from /verify and /settle responses. See Sponsor Policy for the concrete limits behind policy codes, and Troubleshooting for debugging guidance.