API

rail_unsupported

HTTP 422. Payment rail unsupported

What it means

The rail is disabled or not valid for these items.

What to do

GET /api/v1/ lists the rails and whether each is enabled. Use simulated for test mode. Some items (crowdfunded project products, for example) cannot be bought on every rail.

Retrying

Do not retry the same request. Change it first.

Example

json

{
  "type": "https://reuseforge.com/docs/api/errors/rail_unsupported",
  "title": "Payment rail unsupported",
  "status": 422,
  "detail": "The rail base-usdt is not enabled.",
  "instance": "/api/v1/items/acme/invoice-extractor",
  "code": "rail_unsupported",
  "request_id": "req_c4v8n2m6x1z3"
}

Every error is application/problem+json (RFC 9457). Branch on code, show detail to people and quote request_id when you ask for help. See the error catalogue.