x402.spendthebits.com

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "error": "PAYMENT-SIGNATURE header required.",
  "accepts": [
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "payTo": "0xCAB797230Aa7A9cAA2d6Da4AC8b2a06416225cA9",
      "amount": "20000",
      "scheme": "exact",
      "network": "eip155:8453",
      "maxTimeoutSeconds": 120
    }
  ],
  "resource": {
    "url": "https://x402.spendthebits.com/x402/giftcards/quote/",
    "mimeType": "application/json",
    "description": "Buy a gift card from ~550 US brands (Amazon, Target, DoorDash, Uber ...) and more countries; the card is issued to the agent's owner (registered STB agent key with gift cards turned on required). This call prices one card for a $0.02 USDC fee on Base and returns the exact USDC total, a pay_url and a claim token. Find product ids and amounts with GET /x402/giftcards/catalog/?country=USA."
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "brand": "Amazon.com",
            "amount": 10,
            "country": "USA",
            "product_id": "103188916708"
          },
          "type": "http",
          "method": "POST",
          "bodyType": "json"
        },
        "output": {
          "type": "json",
          "example": {
            "brand": "Amazon.com",
            "pay_by": 1789934400,
            "pay_to": "0x9f272C290Dce7598134B5BAA11AA846DF1eAF4b1",
            "status": "awaiting_payment",
            "pay_url": "https://x402.spendthebits.com/x402/giftcards/orders/8a3f5b0e-2c4d-4e1f-9b7a-1d2e3f4a5b6c/pay/",
            "card_url": "https://x402.spendthebits.com/@stb/cards/usa/amazon-com/10/",
            "currency": "USD",
            "delivery": "The card appears in the owner's STB app (Gift cards → My orders).",
            "includes": {
              "card_usdc": "11.222121",
              "service_fee_usdc": "0.350000",
              "bridge_fee_ceiling_usdc": "0.014879"
            },
            "order_id": "8a3f5b0e-2c4d-4e1f-9b7a-1d2e3f4a5b6c",
            "face_value": "10.00",
            "status_url": "https://x402.spendthebits.com/x402/giftcards/orders/8a3f5b0e-2c4d-4e1f-9b7a-1d2e3f4a5b6c/",
            "total_usdc": "11.587000",
            "claim_token": "ct_…",
            "valid_until": null,
            "pricing_note": "The card provider's price includes its own spread, which is a larger share of small cards. Compare total_usdc with face_value before paying.",
            "redeemable_in": "USA",
            "what_to_expect": "A card usually takes about 5 minutes after payment. Poll status_url with the claim token in the X-Claim-Token header; do not pay again.",
            "typical_minutes": 5,
            "spend_controls_hint": "Set your client's per-payment cap to at least $12 (e.g. @x402/fetch spendControls.maxAmountPerPayment)."
          }
        }
      },
      "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": {
                "type": "object",
                "required": [
                  "product_id",
                  "country",
                  "amount"
                ],
                "properties": {
                  "ref": {
                    "type": "string",
                    "maxLength": 80,
                    "description": "Optional referrer STB handle (@name) that earns part of the service fee"
                  },
                  "brand": {
                    "type": "string",
                    "maxLength": 80,
                    "description": "Optional brand name; only used to suggest real products when product_id is not found"
                  },
                  "amount": {
                    "type": "number",
                    "description": "Face value in the card's own currency; a fixed-denomination card takes one of its listed denominations",
                    "exclusiveMinimum": 0
                  },
                  "country": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Catalogue country name, e.g. USA, Canada, UK"
                  },
                  "product_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Product id from GET /x402/giftcards/catalog/?country=<country>"
                  }
                },
                "additionalProperties": false
              },
              "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"
              }
            }
          }
        }
      }
    }
  },
  "x402Version": 2
}

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0xCAB797230Aa7A9cAA2d6Da4AC8b2a06416225cA9",
    "scheme": "exact",
    "network": "eip155:8453",
    "mimeType": "application/json",
    "resource": "https://x402.spendthebits.com/x402/giftcards/quote/",
    "description": "",
    "maxAmountRequired": "20000",
    "maxTimeoutSeconds": 120
  }
]

Provenance

Seen in the source catalog

2026-10-05 17:39Z

Last indexed by Roundhouse

2026-10-26 05:16Z

Last enriched (probe, favicon, geo)

2026-09-29 10:15Z

x402 version

1

Max timeout

120s

Liveness probe

HTTP 402