Bitrefill
payment-ready until 2026-10-27
imported from the x402 Bazaar, not submitted by the operator · own this service? claim it · or ask to be removed
API to search gift cards, eSIMs and mobile top ups and pay for them in USDC via x402, priced per call and with no account.
Call it x402 v2
x402 v2
- Base URL
- https://api.bitrefill.com
- Payment
- x402 v2, header channel
$ curl -i 'https://api.bitrefill.com/x402/checkout/info' An unpaid request returns HTTP 402 with the payment terms. Sign a payment authorization, then retry with the PAYMENT-SIGNATURE header.
Endpoints 8 paid routes on api.bitrefill.com
Prices as captured in the 402 response: median $0.002 across the 8 endpoints.
Example 402 response
Endpoints and prices
| Method | Path | Description | Price | Network | Asset | 402 channel | Captured |
|---|---|---|---|---|---|---|---|
| GET | / | Discover the Bitrefill x402 storefront: supported networks, the full route flow, and wallet persistence rules. | $0.001 | Arbitrum One+ | USDC, USD Coin, USD₮0, UNKNOWN | header | since 07-20 |
| GET | / | Search prepaid eSIM data plans for 180+ countries and regions. Pay in USDC via x402, no account. | $0.002 | Arbitrum One+ | USDC, USD Coin, USD₮0, UNKNOWN | header | since 07-20 |
| GET | / | Search 10,000+ gift card & voucher brands across 180+ countries by name and country. Pay in USDC via x402, no account. | $0.002 | Arbitrum One+ | USDC, USD Coin, USD₮0, UNKNOWN | header | since 07-20 |
| POST | / | Create a price-locked invoice for one or more gift cards, eSIMs, or mobile top-ups, payable in USDC or over Lightning. | $0.002 | Arbitrum One+ | USDC, USD Coin, USD₮0, UNKNOWN | header | since 07-20 |
| POST | / | Pay a Bitrefill invoice in USDC via x402 to buy gift cards, eSIMs & mobile top-ups across 180+ countries. | variable amount | Arbitrum One+ | USDC, USD Coin, USD₮0, UNKNOWN | header | since 07-20 |
| GET | / | Check an invoice status and, with SIWX from the paying wallet or the Lightning payment preimage, retrieve redemption codes. | $0.001 | Arbitrum One+ | USDC, USD Coin, USD₮0, UNKNOWN | header | since 07-20 |
| GET | / | Get a product's packages, pricing, and recipient requirements before creating an invoice. | $0.001 | Arbitrum One+ | USDC, USD Coin, USD₮0, UNKNOWN | header | since 07-20 |
| GET | / | Search mobile top-ups & prepaid airtime for carriers in 180+ countries. Pay in USDC via x402, no account. | $0.002 | Arbitrum One+ | USDC, USD Coin, USD₮0, UNKNOWN | header | since 07-20 |
Payment evidence
402 payload captured at . Check evidence JSON · Measurement methodology.
First of 8 payloads captured by the monitor.
268 lines, scroll inside
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
{
"asset": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
"extra": {
"name": "USD₮0",
"version": "1"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
{
"asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "2000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "2000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "BTC",
"extra": {
"invoice": "lnbc30n1p4v77g5pp5tkf3hgr9fny0amdx44asm0te40nf305k35f3w0nc49jnuv5vxfzshp59zny9rgq8a4np79nd9x6rd9kyjj3sc27kxejfl0uhevsh843pfgscqzxgxqzrcsp5cq7xp6p0vqxn87ww9f6wt0zrpk37gyddm9yt984k97nzm2trmu9q9qxpqysgqjcj55k52vxt8p27mwedyu8wu4dqtnatjwzvat5h354gf5pnqt0usemw05ywnmddftn6pzv56svgtts0lx2pcp400vfzlfe3p0ad5drgqzrrsa2",
"paymentFlow": "upfront",
"requestHash": "28a6428d003f6b30f8b3694da1b4b624a518615eb1b324fdfcbe590b9eb10a51",
"assetTransferMethod": "bolt11",
"requestBindingParams": {
"headers": [
"content-type",
"x-bitrefill-affiliate-id"
]
},
"requestBindingProfile": "http:1"
},
"payTo": "03c913d061dfe0adbfd87c0e98e66033be0dbbb2413de26bd363c63970480a9a80",
"amount": "3000",
"scheme": "exact",
"network": "lnbtc:000000000019d6689c085ae165831e93",
"maxTimeoutSeconds": 120
}
],
"resource": {
"url": "https://api.bitrefill.com/x402/invoice/create",
"tags": [
"checkout",
"invoice",
"gift-cards",
"esims",
"usdc",
"lightning"
],
"iconUrl": "https://www.bitrefill.com/android-chrome-512x512.png",
"mimeType": "application/json",
"description": "Create a price-locked invoice for one or more gift cards, eSIMs, or mobile top-ups, payable in USDC or over Lightning.",
"serviceName": "Bitrefill"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"items": [
{
"product_id": "amazon-us",
"package_value": "25"
}
]
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json",
"example": {
"networks": [
"eip155:8453",
"solana:mainnet"
],
"next_step": {
"url": "/x402/invoice/pay",
"body": {
"invoice_id": "c2b27180-610e-4132-af77-ad42fc0ac444"
}
},
"price_usd": 25,
"invoice_id": "c2b27180-610e-4132-af77-ad42fc0ac444",
"price_usdc": "25000000",
"price_satoshi": 25000,
"expires_in_minutes": 15
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_id",
"package_value"
],
"properties": {
"product_id": {
"type": "string",
"description": "Product slug from a search result"
},
"refill_input": {
"type": "string",
"description": "Recipient identifier (phone/email/account) — required when the product's recipient_type is not \"none\""
},
"package_value": {
"type": "string",
"description": "The denomination from /x402/products/detail \"package_value\" (e.g. \"25\")"
}
}
},
"maxItems": 15,
"minItems": 1
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
},
"builder-code": {
"info": {
"a": "bc_suil8bdj"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"maxItems": 11,
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
} Other captured 402 responses (7)
Captured payload 2 of 8
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
{
"asset": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
"extra": {
"name": "USD₮0",
"version": "1"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
{
"asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "2000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "2000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "BTC",
"extra": {
"invoice": "lnbc30n1p4v77g5pp5d6pt05v0chqcahle5rmry29pamf9pv8zy3xu4agyk0t4290w6t4qhp53jlcqwdh9d9ej6q0l2d8l2sjlcy56fx6c06qgq6mkwd0rw6pl0sscqzxgxqzrcsp5vdkl8vmfd70gvxved67pjxeyzshs9nj2jhfc40p7y42vjrp8eqas9qxpqysgqdp0v86eqg9zn4p035l64a0tccrylw2rspemfdqrdjpaa6svwyx9j56994cx5lrt038wg5aq3392t6sa5f2cjjk2awzvaxrj9q4t46kcqymdddx",
"paymentFlow": "upfront",
"requestHash": "8cbf8039b72b4b99680ffa9a7faa12fe094d24dac3f404035bb39af1bb41fbe1",
"assetTransferMethod": "bolt11",
"requestBindingParams": {
"headers": []
},
"requestBindingProfile": "http:1"
},
"payTo": "03c913d061dfe0adbfd87c0e98e66033be0dbbb2413de26bd363c63970480a9a80",
"amount": "3000",
"scheme": "exact",
"network": "lnbtc:000000000019d6689c085ae165831e93",
"maxTimeoutSeconds": 120
}
],
"resource": {
"url": "https://api.bitrefill.com/x402/gift-cards/search",
"tags": [
"gift-cards",
"vouchers",
"search",
"usdc",
"base",
"solana"
],
"iconUrl": "https://www.bitrefill.com/android-chrome-512x512.png",
"mimeType": "application/json",
"description": "Search 10,000+ gift card & voucher brands across 180+ countries by name and country. Pay in USDC via x402, no account.",
"serviceName": "Bitrefill"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"q": "amazon",
"country": "US"
}
},
"output": {
"type": "json",
"example": {
"products": [
{
"name": "Amazon",
"slug": "amazon-us",
"country": "US",
"in_stock": true,
"recipient_type": "none"
},
{
"name": "Steam",
"slug": "steam",
"country": "US",
"in_stock": true,
"recipient_type": "none"
}
],
"next_step": {
"url": "/x402/products/detail",
"body": {
"slug": "<product slug from results>"
}
}
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Search query (brand or product name). A name search also returns out-of-stock matches, marked in_stock: false; among equally good matches, in-stock products come first. Out-of-stock products cannot be bought now."
},
"country": {
"type": "string",
"description": "Optional ISO 3166-1 alpha-2 country code filter; omit for all countries (global results)"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
},
"builder-code": {
"info": {
"a": "bc_suil8bdj"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"maxItems": 11,
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
}Captured payload 3 of 8
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
{
"asset": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
"extra": {
"name": "USD₮0",
"version": "1"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
{
"asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "1000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "1000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "BTC",
"extra": {
"invoice": "lnbc20n1p4v77g5pp5vpepzjx7lds2dtg0rdyug268haqs5tyk35h45qpcnwuht3emfmcqhp5vasyte5563z4fx62x0vzv4q8sp6k0en6dp7g8epvzv3xr5kwpmuqcqzxgxqzrcsp52rsmmtrgvuyh22vmfkdhvdeestwye0fchh4w03kkazr5y04lnm5q9qxpqysgqrp07zpcg2nny7n4zhhenvwha55j2axa2hjvdtwp7gcjjmzhlccm82veysjr79nwu6c3t9gk5z4ts89v8v02g8ga3elylgzrt8kymv4gpnazqc2",
"paymentFlow": "upfront",
"requestHash": "676045e694d445549b4a33d8265407807567e67a687c83e42c132261d2ce0ef8",
"assetTransferMethod": "bolt11",
"requestBindingParams": {
"headers": []
},
"requestBindingProfile": "http:1"
},
"payTo": "03c913d061dfe0adbfd87c0e98e66033be0dbbb2413de26bd363c63970480a9a80",
"amount": "2000",
"scheme": "exact",
"network": "lnbtc:000000000019d6689c085ae165831e93",
"maxTimeoutSeconds": 120
}
],
"resource": {
"url": "https://api.bitrefill.com/x402/checkout/info",
"tags": [
"checkout",
"storefront",
"discovery",
"usdc",
"base",
"solana"
],
"iconUrl": "https://www.bitrefill.com/android-chrome-512x512.png",
"mimeType": "application/json",
"description": "Discover the Bitrefill x402 storefront: supported networks, the full route flow, and wallet persistence rules.",
"serviceName": "Bitrefill"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {}
},
"output": {
"type": "json",
"example": {
"routes": [
{
"path": "/x402/gift-cards/search",
"method": "GET",
"purpose": "Search gift card products by query and country."
}
],
"service": "Bitrefill x402 storefront",
"next_step": {
"url": "/x402/gift-cards/search"
},
"supported_networks": [
"eip155:8453",
"solana:mainnet"
],
"wallet_persistence": "Codes and eSIMs are bound to the paying wallet; recovery and top-ups require the same wallet"
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"properties": {}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
}
},
"x402Version": 2
}Captured payload 4 of 8
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
{
"asset": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
"extra": {
"name": "USD₮0",
"version": "1"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
{
"asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "1000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "1000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "BTC",
"extra": {
"invoice": "lnbc20n1p4v77g5pp5ufxpmr4zymjcqwzudfe8l8zl3978222f24jpl3qnuhwymqpwv2dshp5t24svflx2tum8j24vzn6zhehgu3k6xussgdedx6pw7lj35dl3e4scqzxgxqzrcsp5zpr4rtxm2dhzyx5v47wrkwhng3mzyq8jm2un4q80gk8znwd3slhq9qxpqysgq7fr8phz07xz8k8gpu02w656scxw8d2sgfkh962d4hfd7rzvwr6dqr6fzenp2k2ygxqhufu4dq6pqkk0m0dlhqcyfh5vanv4ksf9n4pgqr4t67l",
"paymentFlow": "upfront",
"requestHash": "5aab0627e652f9b3c95560a7a15f3747236d1b90821b969b4177bf28d1bf8e6b",
"assetTransferMethod": "bolt11",
"requestBindingParams": {
"headers": [
"sign-in-with-x",
"x-lightning-preimage"
]
},
"requestBindingProfile": "http:1"
},
"payTo": "03c913d061dfe0adbfd87c0e98e66033be0dbbb2413de26bd363c63970480a9a80",
"amount": "2000",
"scheme": "exact",
"network": "lnbtc:000000000019d6689c085ae165831e93",
"maxTimeoutSeconds": 120
}
],
"resource": {
"url": "https://api.bitrefill.com/x402/invoice/status",
"tags": [
"checkout",
"status",
"redemption",
"usdc",
"base",
"solana"
],
"iconUrl": "https://www.bitrefill.com/android-chrome-512x512.png",
"mimeType": "application/json",
"description": "Check an invoice status and, with SIWX from the paying wallet or the Lightning payment preimage, retrieve redemption codes.",
"serviceName": "Bitrefill"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"invoice_id": "c2b27180-610e-4132-af77-ad42fc0ac444"
}
},
"output": {
"type": "json",
"example": {
"status": "complete",
"invoice_id": "c2b27180-610e-4132-af77-ad42fc0ac444",
"delivery_status": "all_delivered",
"redemption_info": {
"orders": [
{
"redemption_info": {
"code": "XXXX-XXXX-XXXX"
}
}
]
}
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"invoice_id"
],
"properties": {
"invoice_id": {
"type": "string",
"description": "Invoice ID to check status for. Sign in (SIWX) with the paying wallet, or send the preimage of your Lightning payment in the x-lightning-preimage header, to also retrieve redemption codes."
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
},
"builder-code": {
"info": {
"a": "bc_suil8bdj"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"maxItems": 11,
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
},
"sign-in-with-x": {
"info": {
"uri": "https://api.bitrefill.com/x402/invoice/status",
"nonce": "03bb817ff3c66702957058786add5146",
"domain": "api.bitrefill.com",
"version": "1",
"issuedAt": "2026-10-14T12:44:04.543Z",
"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).",
"expirationTime": "2026-10-14T12:49:04.543Z"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"domain",
"address",
"uri",
"version",
"chainId",
"type",
"nonce",
"issuedAt",
"signature"
],
"properties": {
"uri": {
"type": "string",
"format": "uri"
},
"type": {
"type": "string"
},
"nonce": {
"type": "string"
},
"domain": {
"type": "string"
},
"address": {
"type": "string"
},
"chainId": {
"type": "string"
},
"version": {
"type": "string"
},
"issuedAt": {
"type": "string",
"format": "date-time"
},
"notBefore": {
"type": "string",
"format": "date-time"
},
"requestId": {
"type": "string"
},
"resources": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
},
"signature": {
"type": "string"
},
"statement": {
"type": "string"
},
"expirationTime": {
"type": "string",
"format": "date-time"
}
}
},
"supportedChains": [
{
"type": "eip191",
"chainId": "eip155:8453"
},
{
"type": "eip191",
"chainId": "eip155:42161"
},
{
"type": "eip191",
"chainId": "eip155:42161"
},
{
"type": "eip191",
"chainId": "eip155:137"
},
{
"type": "ed25519",
"chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
}
]
}
},
"x402Version": 2
}Captured payload 5 of 8
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
{
"asset": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
"extra": {
"name": "USD₮0",
"version": "1"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
{
"asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "1000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "1000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "BTC",
"extra": {
"invoice": "lnbc20n1p4v77g5pp5pcm2vkqdezk8lnkjek67kmhkrv3fc9z8pnf44j6k03p0jvs3xgtshp5a8s0h8xp9tuezqq3y8txjednqyg88afdfsvk0fsusecms73lgnascqzxgxqzrcsp57pdlwtr23ytdskrut9tyke9g3xynwnf5ufp9hazg55pp5v7kdtpq9qxpqysgq9r8xf5knv0q23h5htyuj9zfnzlpw35fqrtsh2unkcw7mhvgzkmky4y3emzpl9wpw09m34r68e87hejvgpwg4zd5sgxv2ezvskl4fjxspf06lvu",
"paymentFlow": "upfront",
"requestHash": "e9e0fb9cc12af991001121d66965b3011073f52d4c1967a61c8671b87a3f44fb",
"assetTransferMethod": "bolt11",
"requestBindingParams": {
"headers": []
},
"requestBindingProfile": "http:1"
},
"payTo": "03c913d061dfe0adbfd87c0e98e66033be0dbbb2413de26bd363c63970480a9a80",
"amount": "2000",
"scheme": "exact",
"network": "lnbtc:000000000019d6689c085ae165831e93",
"maxTimeoutSeconds": 120
}
],
"resource": {
"url": "https://api.bitrefill.com/x402/products/detail",
"tags": [
"product-details",
"pricing",
"gift-cards",
"esims",
"usdc"
],
"iconUrl": "https://www.bitrefill.com/android-chrome-512x512.png",
"mimeType": "application/json",
"description": "Get a product's packages, pricing, and recipient requirements before creating an invoice.",
"serviceName": "Bitrefill"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"slug": "amazon-us"
}
},
"output": {
"type": "json",
"example": {
"id": "amazon-us",
"name": "Amazon",
"packages": [
{
"package_value": "25",
"package_currency": "USD"
},
{
"package_value": "50",
"package_currency": "USD"
}
],
"next_step": {
"url": "/x402/invoice/create",
"body": {
"items": [
{
"product_id": "amazon-us",
"package_value": "25"
}
]
}
},
"recipient_type": "none",
"recipient_required": false
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Product slug, e.g. amazon-us (from a search result or my/esims)"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
},
"builder-code": {
"info": {
"a": "bc_suil8bdj"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"maxItems": 11,
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
}Captured payload 6 of 8
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
{
"asset": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
"extra": {
"name": "USD₮0",
"version": "1"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
{
"asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "2000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "2000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "BTC",
"extra": {
"invoice": "lnbc30n1p4v77g4pp5ysp9zpe9fznyed9c2tfytxe2mcyp8xpq62gfdukmvcu60z0sf4kqhp5ky66fcvktfcsgz630nmh2m2re5a603xtjk660mcnuv22up5l2puqcqzxgxqzrcsp5yyqn9943a0x6ws0he0ezyavxet8rx3jnuasm4l3p5cdjnzpjmsds9qxpqysgqymn7cv3pmqvs9qpj6nv4kffpxgfvks8yd859epzysgkvg64psje3wpteldezwr2nettrwcsm5qxy6szhrrnmxzsmzv2w4yxczwyzagqqwm58a0",
"paymentFlow": "upfront",
"requestHash": "b135a4e1965a71040b517cf7756d43cd3ba7c4cb95b5a7ef13e314ae069f5078",
"assetTransferMethod": "bolt11",
"requestBindingParams": {
"headers": []
},
"requestBindingProfile": "http:1"
},
"payTo": "03c913d061dfe0adbfd87c0e98e66033be0dbbb2413de26bd363c63970480a9a80",
"amount": "3000",
"scheme": "exact",
"network": "lnbtc:000000000019d6689c085ae165831e93",
"maxTimeoutSeconds": 120
}
],
"resource": {
"url": "https://api.bitrefill.com/x402/esims/search",
"tags": [
"esims",
"data-plans",
"travel",
"usdc",
"base",
"solana"
],
"iconUrl": "https://www.bitrefill.com/android-chrome-512x512.png",
"mimeType": "application/json",
"description": "Search prepaid eSIM data plans for 180+ countries and regions. Pay in USDC via x402, no account.",
"serviceName": "Bitrefill"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"q": "europe",
"country": "US"
}
},
"output": {
"type": "json",
"example": {
"products": [
{
"name": "Europe eSIM",
"slug": "esim-europe",
"region": "EU",
"in_stock": true,
"recipient_type": "none"
}
],
"next_step": {
"url": "/x402/products/detail",
"body": {
"slug": "<product slug from results>"
}
}
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Search query (region or country name). A name search also returns out-of-stock matches, marked in_stock: false; among equally good matches, in-stock products come first. Out-of-stock products cannot be bought now."
},
"country": {
"type": "string",
"description": "Optional ISO 3166-1 alpha-2 country code filter; omit for all countries (global results)"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
},
"builder-code": {
"info": {
"a": "bc_suil8bdj"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"maxItems": 11,
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
}Captured payload 7 of 8
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
{
"asset": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
"extra": {
"name": "USD₮0",
"version": "1"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:42161",
"maxTimeoutSeconds": 300
},
{
"asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "2000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "2000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "2000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
},
{
"asset": "BTC",
"extra": {
"invoice": "lnbc30n1p4v77g4pp5ggrpnzddxaat6w00q3ag9gsaawz8rzmgdt9nkdx4tswe8f2kpnqqhp5jy9w8x4glmuj955jg6gmt2uz4djew6d64rnq0fv6zkzua4f03fascqzxgxqzrcsp5ssevxgy7y4a9cfkzmvuq7j84kvm9jdssr443j3a9l69l9npfxuyq9qxpqysgqyvlaz039m939kdl4ug7vknrhjzzzq7h96rsf2aw0aufdqkqq7gurqu5v2pvml5srp99cx09cus3eceqcdm6j0n4u2pe0mgpsx60s96qpvw9wcr",
"paymentFlow": "upfront",
"requestHash": "910ae39aa8fef922d2924691b5ab82ab659769baa8e607a59a1585ced52f8a7b",
"assetTransferMethod": "bolt11",
"requestBindingParams": {
"headers": []
},
"requestBindingProfile": "http:1"
},
"payTo": "03c913d061dfe0adbfd87c0e98e66033be0dbbb2413de26bd363c63970480a9a80",
"amount": "3000",
"scheme": "exact",
"network": "lnbtc:000000000019d6689c085ae165831e93",
"maxTimeoutSeconds": 120
}
],
"resource": {
"url": "https://api.bitrefill.com/x402/topups/search",
"tags": [
"mobile-topups",
"airtime",
"prepaid",
"usdc",
"base",
"solana"
],
"iconUrl": "https://www.bitrefill.com/android-chrome-512x512.png",
"mimeType": "application/json",
"description": "Search mobile top-ups & prepaid airtime for carriers in 180+ countries. Pay in USDC via x402, no account.",
"serviceName": "Bitrefill"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"q": "vodafone",
"country": "GB"
}
},
"output": {
"type": "json",
"example": {
"products": [
{
"name": "Vodafone",
"slug": "vodafone-gb",
"country": "GB",
"in_stock": true,
"recipient_type": "phone_number"
}
],
"next_step": {
"url": "/x402/products/detail",
"body": {
"slug": "<product slug from results>"
}
}
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Search query (carrier or operator name). A name search also returns out-of-stock matches, marked in_stock: false; among equally good matches, in-stock products come first. Out-of-stock products cannot be bought now."
},
"country": {
"type": "string",
"description": "Optional ISO 3166-1 alpha-2 country code filter; omit for all countries (global results)"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
},
"builder-code": {
"info": {
"a": "bc_suil8bdj"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"maxItems": 11,
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
}Captured payload 8 of 8
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000000000",
"scheme": "upto",
"network": "eip155:8453",
"maxTimeoutSeconds": 3600
},
{
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000000000",
"scheme": "upto",
"network": "eip155:42161",
"maxTimeoutSeconds": 3600
},
{
"asset": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
"extra": {
"name": "USD₮0",
"version": "1"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000000000",
"scheme": "upto",
"network": "eip155:42161",
"maxTimeoutSeconds": 3600
},
{
"asset": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x480CD46E6faDe651a0437DeaddA53D5c8e7D846A",
"amount": "1000000000",
"scheme": "upto",
"network": "eip155:137",
"maxTimeoutSeconds": 3600
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "1000000000",
"scheme": "upto",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 3600
},
{
"asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
"extra": {
"feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP"
},
"payTo": "5yASLjtNssGXDv6bR9e71WXKxRymDiUzbgkGPqkQNgRn",
"amount": "1000000000",
"scheme": "upto",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 3600
}
],
"resource": {
"url": "https://api.bitrefill.com/x402/invoice/pay",
"tags": [
"checkout",
"payment",
"gift-cards",
"esims",
"usdc"
],
"iconUrl": "https://www.bitrefill.com/android-chrome-512x512.png",
"mimeType": "application/json",
"description": "Pay a Bitrefill invoice in USDC via x402 to buy gift cards, eSIMs & mobile top-ups across 180+ countries.",
"serviceName": "Bitrefill"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"invoice_id": "c2b27180-610e-4132-af77-ad42fc0ac444"
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json",
"example": {
"message": "Payment accepted; poll invoice/status for fulfillment outcome and redemption codes.",
"accepted": true,
"next_step": {
"url": "/x402/invoice/status?invoice_id=c2b27180-610e-4132-af77-ad42fc0ac444"
}
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"required": [
"invoice_id"
],
"properties": {
"invoice_id": {
"type": "string",
"description": "Invoice id to pay via x402"
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
},
"builder-code": {
"info": {
"a": "bc_suil8bdj"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"maxItems": 11,
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
}Can I trust it score from our own monitoring
score from our own monitoring
#1 of 109 in Finance. Bands: strong 93+, solid 75+, mixed 55+, weak below 55.
- Reliability
- 100% uptime 30d
- Compliance
- A 14/14 checks pass
- Price
- $0.001 to $0.002 p9 in Finance
- Risk
- clean no risk flag
- Traction
- $1,305.02 30d 106 buyers, top buyer 49% (address, not entity)
14/14 compliance checks
- 402 payload captured
- accepts[] array present
- payTo address recoverable
- payTo at accepts[0].payTo (conformant shape)
- payTo is a valid on-chain address
- atomic price declared
- atomic price in a sane range
- asset (token) address declared
- network resolves to CAIP-2
- payment scheme declared
- served over HTTPS
- declares the current x402 version (2)
- EIP-712 domain parameters present on every EVM entry
- x402 v2 envelope delivered in the payment-required header
402 terms unchanged since 2026-10-14. Last up 2026-10-20.
── Site signals
- homepage reachable
- openapi doc
- pricing page
- llms.txt
- robots.txt
- terms page
How the score works
What the score read on this service: status online, 100% uptime 30d, 478ms response p95, x402 compliance 14 of 14, $0.001 price against the category, on-chain traction measured. Each of those is measured, and each is published in full below.
The score comes from our own monitoring, never from reviews, operator claims, or a language model: reliability, x402 compliance, price against the category, a deterministic risk flag, and a small on-chain traction term, weighted by ranking generation 3. It is not placement anyone can buy: the paid verify tier is reported beside it and is not one of its inputs. Every component below stays published and read-only.
Bands on the 0 to 100 measured score: strong at 93 and above, solid from 75, mixed from 55, weak below 55. Price and speed are scored against the whole category field, every listing in it that carries no danger flag, the scored service included, so the score places a service in its own field.
It is a score inside Finance, and only there: price and speed are scored against the whole category field, every listing in it that carries no danger flag, the scored service included, which here means 109 listings, this one among them: the same 109 the position above is counted against. When the two differ, the field is the wider one, because a listing we have measured too little of to rank still sits in the field the price and the speed are normalized over. The same service in a different field would read differently. The same engine answers GET /api/v1/best, and asked for a different pool (the whole directory, or another filter) it returns a different number for this service under this same ranking generation. Neither is more correct: they answer different questions, and the methodology states which is which.
Settled via coinbase ($1.3k, 894 tx). Traction is a conservative undercount; first settlement seen 2026-05-22.
All measured facts
What it does
API to search gift cards, eSIMs and mobile top ups and pay for them in USDC via x402, priced per call and with no account. Endpoints cover catalog search, product detail, and invoice creation, payment and status, on Base, Arbitrum, Polygon and Solana.
Bitrefill is a listed x402 Finance API. Captured payment terms name Arbitrum One, Base, Polygon, Solana. Monitoring and settlement figures below describe the observations available to this directory; an unpaid HTTP 402 check does not prove that a paid call will deliver.
Assessment computed at . Latest service check observed at . Service data JSON · Measurement methodology.
Page rendered at . This response time is separate from the observation and computation times attached to each measurement.
Latest endpoint observation: . Latest price capture: . Prices are recorded quotes, not a promise of availability. Token assets and payment terms are listed separately. Endpoint data JSON · Price history JSON · Measurement methodology.
Assessment computed at . Uptime uses the stated daily-rollup window; response times are in milliseconds, compliance is passed/evaluated checks, and traction is a measured settlement floor. The comparison score is out of 100 within this category. Assessment JSON · Measurement methodology.
Observed daily coverage: 2026-09-21 to 2026-10-20 UTC. Daily monitoring and settlement rollups do not expose their computation time; a bucket date is not an update timestamp. Latest settlement in the assessment: . Uptime and response JSON · Volume JSON · Buyers JSON · Measurement methodology.
Ranked from the measured category pool, refreshed at most once a minute. The comparison has no persisted computation timestamp; the assessment time above belongs to this service only. Ranking API documentation · Ranking methodology.
x402 List home · Services · Finance
- uptime · latest daily rollup
- 100%
- uptime 7d
- 100%
- uptime 30d
- 100%
- uptime 90d
- 100%
- response p95
- 478ms
- avg response
- 292ms
- total checks
- 2,779
Measured on the unpaid 402 handshake, not the paid call. A service can 402 correctly and still fail after payment.
- price (min)
- $0.001
- price (max)
- $0.002
- category percentile (min)
- p9 in Finance
- category percentile (max)
- p4 in Finance
- endpoints / prices
- 8 / 2
- model
- tiered
- stability
- 100%
No deterministic risk flag. Risk fires only on an exact blocklist match, or a reserved-brand name with a mismatched verified payTo. Never from low uptime, a high price, or a model guess.
- domain age
- 4586d
- registrar
- Cloudflare, Inc.
- hosting
- custom
- domain created
- 2014-03-24
Identity facts, not a risk score.
- assessment volume 30d
- $1,305.02
- exact assessment volume 30d (USD)
- 1305.022
- assessment recorded at (UTC)
- 2026-10-20T01:23:03.614Z
- buyers 30d
- 106
- settlements 30d
- 894
- measured since
- 2026-05-22 (start of our harvest window)
- last settlement
- 2026-10-19
- top buyer share
- 49% of 30d volume (address, not entity)
- top 3 buyers share
- 71% of 30d volume (addresses, not entities)
- concentrated volume
- no
- trend 7d vs 30d
- 1.53x the 30d daily rate
- networks
- eip155:137, eip155:8453, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d
- volume all-time
- $3.9k
- settlements all-time
- 2,377
- median settlement 30d
- $0.002
- max settlement 30d
- $114.72
Assessment volume uses the latest 30d assessment. Over time sums daily address snapshots, rounded to cents and refreshed separately. The two sources can differ in timing, precision and shared-address attribution. Amounts use cents for comparison; known sub-cent values keep up to 12 significant digits. The exact stored assessment value is shown above.
Conservative undercount: only USDC settlements via facilitators we measure are counted. A measured floor, not an estimate.
Top buyer share lowers the on-chain traction part of the ranking score behind this page's verdict and /best, by up to half when one address holds all 30d volume. The Recommended and Highest volume sorts of the services list do not use it; they use the Concentrated volume rule instead.
- member since
- 2026-07-20
Recent checks
| Checked at (UTC) | Status | HTTP | Response | Endpoints |
|---|---|---|---|---|
| Online | 402 | 185ms | 8 | |
| Online | 402 | 215ms | 8 | |
| Online | 402 | 301ms | 8 | |
| Online | 402 | 224ms | 8 | |
| Online | 402 | 174ms | 8 | |
| Online | 402 | 140ms | 8 | |
| Online | 402 | 88ms | 8 | |
| Online | 402 | 187ms | 8 | |
| Online | 402 | 104ms | 8 | |
| Online | 402 | 205ms | 8 | |
| Online | 402 | 205ms | 8 | |
| Online | 402 | 171ms | 8 | |
| Online | 402 | 112ms | 8 | |
| Online | 402 | 229ms | 8 | |
| Online | 402 | 116ms | 8 | |
| Online | 402 | 78ms | 8 | |
| Online | 402 | 199ms | 8 | |
| Online | 402 | 109ms | 8 |
Changes0 in 30d
No changes recorded in the last 30 days.
Over time
- Volume 30d
- $1,305.02
- Uptime
- 100% on all 29 completed days
More charts
09-21 to 10-20* UTC
Scores over time
09-21 to 10-20* UTC
09-21 to 10-20* UTC
09-21 to 10-20* UTC
Scores: one day per column, 09-21 to 10-20*, on the columns of Response time. Uptime held 100% every day in this window, including any partial day. Daily readings remain in the Uptime strip and Values. The checklist grew from 11 to 14 checks on 2026-07-28, before this window. Pillar lines use their own low and high. Exact dated readings are available in each readout and in Values.
Each series spans only the dates it has data for. Every series is also served as JSON at /api, /scores, /volume and /buyers.
Values
* today so far, partial (UTC).
The uptime summary counts completed UTC days only. The strip, readouts and table retain today's partial reading.
Daily snapshot total, 30d: $1,305.03, peak $268.43 on 09-21. The visible 30d total in Traction comes from the latest assessment. These sources can differ in their window, refresh time, cent rounding and shared-address attribution.
Daily address snapshots: 2026-09-21 to 2026-10-20 UTC; * today so far, partial (UTC). Daily snapshots store cents. A recorded $0.00 with settlements cannot distinguish exact zero from volume rounded away. Lost precision is unavailable here.
Settlement volume uses the stored USD valuation of tracked payments; it is distinct from token quantities. USD-pegged assets are valued at 1 USD per token in these rollups. The measured settlement floor does not cover all payments to this service.
Assessment history last recorded at . Each UTC day uses its last recorded run; missing readings stay unmeasured. Assessment history JSON · Measurement methodology.
| Day | Volume | Buyers | Settlements | Uptime | Response | Compliance | Price percentile | Site signals |
|---|---|---|---|---|---|---|---|---|
| 2026-09-21 | $268.43 | 5 | 38 | 100% | 355.53ms | 14/14 | p8 | 1/6 |
| 2026-09-22 | $12.77 | 8 | 18 | 100% | 436.49ms | 14/14 | p8 | 1/6 |
| 2026-09-23 | $70.35 | 8 | 16 | 100% | 345.51ms | 14/14 | p8 | 1/6 |
| 2026-09-24 | $1.74 | 8 | 25 | 100% | 305.19ms | 14/14 | p8 | 1/6 |
| 2026-09-25 | $21.93 | 5 | 79 | 100% | 296.89ms | 14/14 | p8 | 1/6 |
| 2026-09-26 | $61.07 | 10 | 75 | 100% | 301.50ms | 14/14 | p8 | 1/6 |
| 2026-09-27 | $3.35 | 5 | 30 | 100% | 402.84ms | 14/14 | p8 | 1/6 |
| 2026-09-28 | $20.57 | 8 | 20 | 100% | 499.68ms | 14/14 | p8 | 1/6 |
| 2026-09-29 | $28.63 | 7 | 21 | 100% | 355.23ms | 14/14 | p9 | 1/6 |
| 2026-09-30 | $17.27 | 12 | 48 | 100% | 362.88ms | 14/14 | p9 | 1/6 |
| 2026-10-01 | $26.12 | 8 | 20 | 100% | 290.52ms | 14/14 | p9 | 1/6 |
| 2026-10-02 | $8.11 | 9 | 30 | 100% | 242.96ms | 14/14 | p9 | 1/6 |
| 2026-10-03 | $3.45 | 3 | 14 | 100% | 276.66ms | 14/14 | p9 | 1/6 |
| 2026-10-04 | $0.02 | 5 | 11 | 100% | 240.74ms | 14/14 | p9 | 1/6 |
| 2026-10-05 | $25.00 | 6 | 19 | 100% | 329.52ms | 14/14 | p9 | 1/6 |
| 2026-10-06 | $116.71 | 8 | 31 | 100% | 247.14ms | 14/14 | p10 | 1/6 |
| 2026-10-07 | $24.61 | 13 | 67 | 100% | 361.80ms | 14/14 | p10 | 1/6 |
| 2026-10-08 | $107.65 | 9 | 30 | 100% | 342.60ms | 14/14 | p10 | 1/6 |
| 2026-10-09 | $4.77 | 7 | 22 | 100% | 282.20ms | 14/14 | p10 | 1/6 |
| 2026-10-10 | $1.71 | 4 | 10 | 100% | 285.18ms | 14/14 | p10 | 1/6 |
| 2026-10-11 | $10.31 | 5 | 17 | 100% | 281.97ms | 14/14 | p10 | 1/6 |
| 2026-10-12 | $3.53 | 7 | 21 | 100% | 270.70ms | 14/14 | p10 | 1/6 |
| 2026-10-13 | $31.90 | 6 | 13 | 100% | 194.94ms | 14/14 | p10 | 1/6 |
| 2026-10-14 | $17.14 | 10 | 31 | 100% | 231.07ms | 14/14 | p9 | 1/6 |
| 2026-10-15 | $3.97 | 10 | 25 | 100% | 171.28ms | 14/14 | p9 | 1/6 |
| 2026-10-16 | $26.18 | 8 | 32 | 100% | 148.80ms | 14/14 | p9 | 1/6 |
| 2026-10-17 | $234.46 | 9 | 56 | 100% | 155.67ms | 14/14 | p9 | 1/6 |
| 2026-10-18 | $29.47 | 10 | 25 | 100% | 225.85ms | 14/14 | p9 | 1/6 |
| 2026-10-19 | $123.79 | 14 | 42 | 100% | 123.33ms | 14/14 | p9 | 1/6 |
| 2026-10-20* | $0.02 | 3 | 10 | 100% | 173.23ms | 14/14 | p9 | 1/6 |
Alternatives in Finance
5 of 108 other ranked services in Finance, ordered by the same measured score.
Own this service?
Keep this listing accurate. Ownership is proven with a domain check and every change is reviewed by hand.
Update this listingEarn the verified tier: x402list pays a real call to this endpoint and, if it delivers, the service is delivery-verified. The fee covers the cost of the probe, not the badge; there is no refund if the call does not deliver. Agent and API only, no in-browser signing. See /api.
Verify this service ($0.25)Embed a badge
HTML
<a href="https://x402-list.com/services/ bitrefill? utm_source=badge& utm_medium=referral& utm_campaign=embed"> <img src="https://x402-list.com/ badge/ bitrefill.svg" alt="Bitrefill listed on x402-list" height="28"> </a>
Markdown
[](https://x402-list.com/ services/ bitrefill? utm_source=badge& utm_medium=referral& utm_campaign=embed)
HTML, live uptime variant
<a href="https://x402-list.com/services/ bitrefill? utm_source=badge& utm_medium=referral& utm_campaign=embed"> <img src="https://x402-list.com/ badge/ bitrefill.svg? data=uptime" alt="Bitrefill uptime on x402-list" height="28"> </a>
Delisting
To request delisting, email info@x402-list.com or update your listing at /services/bitrefill/update.