api.reloadpi.com

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1

0.001 USDC
Atomic price: 1000 · Network: eip155:8453 · Asset: USDC · Scheme: exact

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1000",
    "payTo": "0x8a598A28a435Fe44D31854251b1c88d0781ea822"
  }
]

Observed health

Status

Healthy

Latest latency

1818 ms

Average latency

960 ms

HTTP status

402

Last checked

2026-11-02T00:30:16.718Z

Reachability

100% over 9 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "orderId": {
          "type": "string",
          "description": "Order ID returned in purchase response"
        },
        "txHash": {
          "type": "string",
          "description": "On-chain tx hash for lost-200 recovery"
        }
      }
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "json",
  "example": {
    "status": "FULFILLED",
    "txHash": "0xdeaed418b8b052da65969d9c299d341681bfc314cb6731344d7d4d3fac0622a8",
    "orderId": "550e8400-e29b-41d4-a716-446655440000",
    "delivery": {
      "iccid": "8943108167002078039",
      "qrCodeUrl": "data:image/png;base64,..."
    },
    "poll_url": null,
    "poll_again": false,
    "refund_url": null,
    "productType": "esim",
    "refund_policy": "auto_on_fail",
    "refund_contract": {
      "auth_model": "txHash proves payment origin — only the original payer received it",
      "description": "POST refund_url with txHash to prove you are the original payer. txHash is returned in the purchase response.",
      "error_cases": {
        "403": "txHash missing or does not match order",
        "409": "Order not in refundable state (FULFILLED orders cannot be refunded)",
        "410": "Refund window expired",
        "409 duplicate": "Refund already requested for this order"
      },
      "required_body": {
        "txHash": "0x... (from purchase response)"
      },
      "security_model": "txHash + state gate — FULFILLED orders cannot be refunded regardless of txHash",
      "example_request": {
        "url": "/api/catalog/orders/:orderId/refund",
        "body": {
          "txHash": "0xdeaed418b8b052da65969d9c299d341681bfc314cb6731344d7d4d3fac0622a8"
        },
        "method": "POST",
        "headers": {
          "Idempotency-Key": "9c2f1a3b-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
        }
      },
      "example_response": {
        "ok": true,
        "refund_status": "pending",
        "refund_deadline": "2026-05-10T13:35:00Z",
        "refund_amount_usdc": 2.59
      },
      "required_headers": {
        "Idempotency-Key": "your-unique-uuid"
      }
    },
    "refund_deadline": null,
    "refund_eligible": false,
    "fulfillment_deadline": "2026-05-09T13:35:00Z"
  }
}