{"uid":"cap_7eUjY7udrt1zUJ8InCwZ_","slug":"bitrefill-x402-invoice-pay-84f6e6da","name":"Bitrefill x402 Invoice Payment","description":"Pay a Bitrefill invoice in USDC via x402 to buy gift cards, eSIMs & mobile top-ups across 180+ countries.","url":"https://api.bitrefill.com/x402/invoice/pay?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"invoice_id":{"type":"string","description":"Invoice id to pay via x402"}}},"responseSchema":{"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"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1000","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1000","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_eVupUB5QXS0CLyN5U-heh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1000","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Pay a previously created Bitrefill invoice with USDC on-chain via the x402 payment protocol to complete purchase of gift cards, eSIMs, or mobile top-ups","exampleAgentPrompt":"Pay the Bitrefill invoice c2b27180-610e-4132-af77-ad42fc0ac444 with USDC now so I can get the gift card.","exampleUseCases":[{"title":"Complete eSIM purchase with crypto","prompt":"I have a Bitrefill invoice for an eSIM in Europe. Pay it with my USDC on Base so I can activate it right away."},{"title":"Settle mobile top-up across borders","prompt":"Finish my international phone credit purchase by paying the Bitrefill invoice with USDC — I need the top-up activated today."},{"title":"Execute prepaid card checkout instantly","prompt":"Process my Bitrefill prepaid card invoice payment using USDC now so the card is ready to use immediately."}],"resultDescription":"A JSON object confirming whether the on-chain USDC payment was successful, including the invoice_id, transaction hash, network (e.g. eip155:8453 for Base), and a status field set to 'complete' along with a success boolean.","failureModes":["Invoice not found or invalid invoice_id — returns error with unknown invoice","Invoice already paid — returns error indicating duplicate payment attempt","Insufficient USDC balance or payment amount mismatch — payment rejected","On-chain transaction failure or revert — network error response","Invoice expired or price-lock lapsed — requires new invoice creation"],"whenToPreferThis":"Use this endpoint as the final payment step after creating an invoice via the Bitrefill x402 invoice creation endpoint. This is the only endpoint that actually executes and settles the USDC payment on-chain. Use it when you have a valid invoice_id and are ready to commit the purchase — not for browsing products, checking prices, or creating invoices.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:31:49.641Z","isFirstParty":false,"canonicalSlug":"bitrefill-x402-invoice-pay-84f6e6da"}