Tool detail

Bitrefill

Returns an invoice's status and, if the caller signs in as the paying wallet, its redemption codes, for a given invoice ID.

Categories: Payments, Shopping

Use when

check whether a Bitrefill invoice has been paid
retrieve redemption codes for an invoice the caller's wallet paid

Not for

not creating a new invoice or purchase
not redemption codes without SIWX proof of payment

Inputs

GET query param: invoice_id (string, required); redemption codes additionally require SIWX sign-in from the paying wallet.

Admitted input schema

{
  "type": "object",
  "properties": {
    "invoice_id": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Invoice ID to check status for. Sign in (SIWX) with the paying wallet to also retrieve redemption codes."
    }
  },
  "required": [
    "invoice_id"
  ],
  "additionalProperties": false
}

Endpoint

Method: GET
URL: https://api.bitrefill.com/x402/invoice/status

Payment

Protocol: x402
Listed price: 0.001 USDC per call on Base
Payment method: exact
Network: eip155:8453
Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Directory: Coinbase x402 Bazaar
Record: GET https://api.bitrefill.com/x402/invoice/status
Retrieved: 2026-09-30T20:37:07.382Z
Catalog file SHA-256: 6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built: 2026-09-30T22:31:58.034Z