{"uid":"cap_lNbIKwFW8ZjTr7t-t7oyv","slug":"api-reloadpi-com-d4b10280","name":"Reloadpi eSIM Order Status & Refund Info","description":"Reloadpi — Order status and refund schema. Returns the fulfillment state machine, polling URL, and refund endpoint for any paid order.","url":"https://api.reloadpi.com/api/catalog/esims/orders/info","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"txHash":{"type":"string","description":"On-chain tx hash for lost-200 recovery"},"orderId":{"type":"string","description":"Order ID returned in purchase response"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"orderId":"ORD-20240512-9871"}}},"response":{"description":"Poll any orderId returned from a purchase to get fulfillment state, delivery payload, and refund eligibility.","state_machine":["PROCESSING","FULFILLED","FULFILLMENT_FAILED","EXPIRED"],"refund_endpoint":"POST /api/catalog/orders/:orderId/refund","refund_policies":{"esim":"auto_on_fail — USDC returned automatically within 24h on failure","topup":"none — airtime is non-refundable once delivered","voucher":"none — codes are non-refundable once issued"},"status_endpoint":"GET /api/catalog/orders/:orderId","recovery_endpoint":"GET /api/catalog/orders?txHash=0x...","idempotency_required":true,"example_poll_response":{"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_deadline":null,"refund_eligible":false,"fulfillment_deadline":"2026-05-09T13:35:00Z"},"example_refund_request":{"url":"/api/catalog/orders/:orderId/refund","auth":"txHash from purchase response — proves you are the original payer","body":{"txHash":"0xdeaed4..."},"method":"POST","headers":{"Idempotency-Key":"your-unique-uuid"},"response":{"ok":true,"refund_status":"pending","refund_deadline":"2026-05-10T13:35:00Z","refund_amount_usdc":2.59}},"refund_deadline_seconds":86400,"fulfillment_deadline_seconds":{"esim":600,"topup":300,"voucher":180}}},"exampleRequest":{"orderId":"ORD-20240512-9871"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fMrKGFQPIMrxdOYItMQuS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the fulfillment state, polling URL, and refund endpoint for a paid eSIM order by order ID or on-chain transaction hash.","exampleAgentPrompt":"Can you check the current status of my Reloadpi eSIM order with ID 'ORD-20240512-9871' and tell me whether it's been fulfilled, plus give me the refund endpoint if I need it?","exampleUseCases":[{"title":"Track international eSIM fulfillment progress","prompt":"I just bought an eSIM from Reloadpi for my Europe trip. Can you check on order ORD-20240615-5423 and let me know if it's been activated yet, or if it's still processing? Also grab me that polling URL so I can keep tabs on it."},{"title":"Recover lost order via blockchain hash","prompt":"My Reloadpi payment went through on my wallet but I never got the order confirmation screen. The transaction hash is 0x7f8a2c... Can you look up that order and tell me the fulfillment state and where to check for updates?"},{"title":"Initiate refund for unused eSIM","prompt":"I ended up not needing the eSIM I purchased from Reloadpi last week. Order number is ORD-20240608-3341. Can you check if it's still refundable and get me the refund endpoint so I can process this?"}],"resultDescription":"Returns the fulfillment state machine for the order (e.g. pending, processing, fulfilled, failed), a polling URL to re-check status, and the refund endpoint URI if a refund is available for the order.","failureModes":["Order ID not found — returns 404 or empty result if orderId is invalid or not yet created","Missing required parameter — returns error if neither orderId nor txHash is provided","On-chain tx hash not recognized — txHash may not yet be indexed or may be incorrect","Payment not confirmed — order may be in pending state if on-chain payment hasn't settled","Rate limit exceeded — too many polling requests may result in 429 throttling"],"whenToPreferThis":"Use this endpoint after placing an eSIM order via Reloadpi to track its fulfillment progress, retrieve the polling URL for asynchronous status updates, or obtain the refund endpoint. Also useful for recovery when a payment went through on-chain (via txHash) but the order response was lost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:47:37.513Z","isFirstParty":false}