{"uid":"cap_nlGgeCWJad14Til3VXP3t","slug":"api-reloadpi-com-bef40bd5","name":"Reloadpi Voucher Purchase Schema Info","description":"Reloadpi — Voucher purchase schema. Returns request format, recipient fields, priceType handling, and example for POST /vouchers/purchase.","url":"https://api.reloadpi.com/api/catalog/vouchers/purchase/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":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":{"body":{"value":null,"offerId":"1-800-BASKETS_US_002_EGIFT","recipient":{"email":"john@example.com","lastName":"Doe","firstName":"John"}},"method":"POST","payment":"x402 — exact USDC amount returned in 402, fetched live per offerId","endpoint":"POST /api/catalog/vouchers/purchase","response":{"ok":true,"status":"PROCESSING","txHash":"0x... — use for lost-200 recovery","orderId":"uuid — use for polling and refund","pollUrl":"/api/catalog/orders/:orderId","delivery":{"pinCode":"1234-5678-9012","redeemUrl":"https://...","serialCode":null},"transactionId":"upstream-uuid","fulfillment_deadline":"ISO timestamp"},"workflow":["1. GET /api/catalog/vouchers/offers — browse brands, pick an offerId","2. GET /api/catalog/vouchers/offers/:offerId — confirm exact price, check requiredFields and priceType","3. POST /api/catalog/vouchers/purchase — send { offerId, recipient }, handle 402 with exact USDC, retry with payment header"],"bodyParams":{"value":{"type":"number","required":false,"description":"USD amount — RANGE priceType only (e.g. Amazon open-value). Omit for FIXED priceType."},"offerId":{"type":"string","required":true,"description":"Voucher offer ID from GET /vouchers/offers"},"recipient":{"type":"object","required":true,"properties":{"email":{"type":"string","description":"Required for some brands"},"country":{"type":"string","description":"ISO2 country code, required for some brands"},"lastName":{"type":"string"},"firstName":{"type":"string"}},"description":"Recipient fields — check requiredFields on the offer. Always include firstName, lastName. Add email if required."}},"priceRange":"$1.00–$500 depending on brand and denomination","priceTypes":{"FIXED":"Price is fixed — do not send value field","RANGE":"Open-value card — send value in USD (e.g. { value: 50 })"},"contentType":"application/json","refund_policy":"none — voucher codes are non-refundable once issued"}},"exampleRequest":null,"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_6huSYe0RhJ9e0yldeesL7","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 request format, recipient fields, priceType handling, and example payload required to POST a voucher purchase order","exampleAgentPrompt":"Show me the request format and required fields I need to submit a voucher purchase on Reloadpi, including how priceType works and what a sample POST body looks like.","exampleUseCases":[{"title":"Bulk gift card distribution system","prompt":"I need to send gift cards to 500 customers as a loyalty reward. Walk me through the Reloadpi voucher purchase request format and show me how to structure the recipient fields and priceType so I can batch process these orders."},{"title":"E-commerce checkout voucher integration","prompt":"We're adding prepaid voucher sales to our checkout flow. What's the exact schema I need for the Reloadpi POST /vouchers/purchase endpoint, and how should I handle priceType when customers choose between fixed amounts and range options?"},{"title":"Mobile app in-app purchase conversion","prompt":"Our app lets users buy digital vouchers as gifts. Show me the complete request structure for Reloadpi's voucher purchase endpoint, including required recipient data and how to properly format the payload when priceType varies by product type."}],"resultDescription":"Returns the complete request schema for POST /vouchers/purchase, including required and optional fields, recipient data requirements, how to handle fixed vs range priceType values, and an example JSON payload ready for use.","failureModes":["Endpoint returns 402 if payment of $0.001 USDC is not provided","Endpoint may return 404 or 500 if the documentation resource is unavailable","Network timeout if the API host is unreachable"],"whenToPreferThis":"Use this endpoint before attempting to submit a voucher purchase order when you need to understand the correct request structure, required recipient fields, or how priceType affects the payload format. Prefer this over guessing the schema or relying on outdated documentation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:45:55.545Z","isFirstParty":false}