Reloadpi · Orders Info

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://api.reloadpi.com/api/catalog/esims/orders/info", {
  method: "GET",
});
const data = await res.json();

curl -X GET \
  "https://api.reloadpi.com/api/catalog/esims/orders/info?orderId=uuid-here" \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "delivery": {
    "iccid": "8943108167002078039",
    "qrCodeUrl": "data:image/png;base64,..."
  },
  "fulfillment_deadline": "2026-05-09T13:35:00Z",
  "orderId": "550e8400-e29b-41d4-a716-446655440000",
  "poll_again": false,
  "poll_url": null,
  "productType": "esim",
  "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"
    },
    "example_request": {
      "body": {
        "txHash": "0xdeaed418b8b052da65969d9c299d341681bfc314cb6731344d7d4d3fac0622a8"
      },
      "headers": {
        "Idempotency-Key": "9c2f1a3b-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
      },
      "method": "POST",
      "url": "/api/catalog/orders/:orderId/refund"
    },
    "example_response": {
      "ok": true,
      "refund_amount_usdc": 2.59,
      "refund_deadline": "2026-05-10T13:35:00Z",
      "refund_status": "pending"
    },
    "required_body": {
      "txHash": "0x... (from purchase response)"
    },
    "required_headers": {
      "Idempotency-Key": "your-unique-uuid"
    },
    "security_model": "txHash + state gate — FULFILLED orders cannot be refunded regardless of txHash"
  },
  "refund_deadline": null,
  "refund_eligible": false,
  "refund_policy": "auto_on_fail",
  "refund_url": null,
  "status": "FULFILLED",
  "txHash": "0xdeaed418b8b052da65969d9c299d341681bfc314cb6731344d7d4d3fac0622a8"
}