Check an invoice status and, with SIWX from the paying wallet, retrieve redemption codes
Check an invoice status and, with SIWX from the paying wallet, retrieve redemption codes.
1000 (raw units)
price
6
calls / 30d
3
unique payers
2026-09-08
updated
Provider
api.bitrefill.com · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "1000",
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "eip155:42161",
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"amount": "1000",
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "eip155:137",
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
"amount": "1000",
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "1000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"method": "GET",
"queryParams": {
"invoice_id": "c2b27180-610e-4132-af77-ad42fc0ac444"
},
"type": "http"
},
"output": {
"example": {
"delivery_status": "all_delivered",
"invoice_id": "c2b27180-610e-4132-af77-ad42fc0ac444",
"redemption_info": {
"orders": [
{
"redemption_info": {
"code": "XXXX-XXXX-XXXX"
}
}
]
},
"status": "complete"
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"properties": {
"invoice_id": {
"description": "Invoice ID to check status for. Sign in (SIWX) with the paying wallet to also retrieve redemption codes.",
"type": "string"
}
},
"required": [
"invoice_id"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
},
"builder-code": {
"info": {
"a": "bc_suil8bdj"
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"a": {
"description": "App builder code",
"pattern": "^[a-z0-9_]{1,32}$",
"type": "string"
},
"s": {
"description": "Service builder codes",
"items": {
"pattern": "^[a-z0-9_]{1,32}$",
"type": "string"
},
"type": "array"
},
"w": {
"description": "Wallet builder code",
"pattern": "^[a-z0-9_]{1,32}$",
"type": "string"
}
},
"type": "object"
}
},
"sign-in-with-x": {
"info": {
"domain": "api.bitrefill.com",
"expirationTime": "2026-09-08T12:14:50.085Z",
"issuedAt": "2026-09-08T12:09:50.085Z",
"nonce": "c44ac1df4bb428342f84eac88e58a519",
"resources": [
"https://api.bitrefill.com/x402/invoice/status"
],
"statement": "Sign in to Bitrefill to access your orders and gift card codes. Sign this message with the same wallet that paid the invoice (no account or password needed).",
"uri": "https://api.bitrefill.com/x402/invoice/status",
"version": "1"
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"address": {
"type": "string"
},
"chainId": {
"type": "string"
},
"domain": {
"type": "string"
},
"expirationTime": {
"format": "date-time",
"type": "string"
},
"issuedAt": {
"format": "date-time",
"type": "string"
},
"nonce": {
"type": "string"
},
"notBefore": {
"format": "date-time",
"type": "string"
},
"requestId": {
"type": "string"
},
"resources": {
"items": {
"format": "uri",
"type": "string"
},
"type": "array"
},
"signature": {
"type": "string"
},
"statement": {
"type": "string"
},
"type": {
"type": "string"
},
"uri": {
"format": "uri",
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"domain",
"address",
"uri",
"version",
"chainId",
"type",
"nonce",
"issuedAt",
"signature"
],
"type": "object"
},
"supportedChains": [
{
"chainId": "eip155:8453",
"type": "eip191"
},
{
"chainId": "eip155:42161",
"type": "eip191"
},
{
"chainId": "eip155:137",
"type": "eip191"
},
{
"chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"type": "ed25519"
}
]
}
}Use it
curl
curl "https://api.bitrefill.com/x402/invoice/status" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://api.bitrefill.com/x402/invoice/status");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://api.bitrefill.com/x402/invoice/status")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/271.json, and this resource appears in /discovery/resources and /discovery/search.