{"openapi":"3.1.0","info":{"title":"DigiZay API v2","version":"2.1.0","description":"Prepaid reseller REST API plus public catalog discovery. Existing v1 routes remain supported at /api/v1; their reference is /docs/v1. All monetary fields are whole MMK. Objects are returned directly; lists have a named array and nextCursor. Products and quotes apply account pricing. Public /catalog and /collections display ordinary storefront prices and are not checkout quotes. Confirm purchases explicitly, reuse Idempotency-Key and identical body on retries, and read only your own orders. No automatic financial action is permitted by documentation alone."},"servers":[{"url":"https://digizay.com"}],"security":[],"paths":{"/api/v2/catalog":{"get":{"operationId":"listCollections","x-openai-isConsequential":false,"description":"List published game and operator cards with ordinary starting prices. Each collection opens a package selector even with one item. Counts include sold-out products. Other products remain in /api/catalog. Use returned URLs; never guess product IDs. Read package capabilities before checkout.","responses":{"200":{"description":"Collections and ordinary display prices.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionIndex"}}}}}}},"/api/v2/collections/{slug}":{"get":{"operationId":"listCollectionProducts","x-openai-isConsequential":false,"description":"Read a game or operator collection and up to 24 packages. Product url is the canonical main product selector; package selection does not change its URL. requiredInputs describe customer information, not a guarantee of supported checkout. Game capability false means do not attempt a purchase. Read /api/flash-sales separately for conditional offer prices and preserve the exact flash offer ID.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$","maxLength":80}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":1}}],"responses":{"200":{"description":"Public package page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionPage"}}}},"400":{"description":"Invalid page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No published collection with this slug.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v2":{"get":{"operationId":"describeApiV2","security":[],"x-openai-isConsequential":false,"responses":{"200":{"description":"API v2 discovery","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v2/account":{"get":{"operationId":"getResellerAccount","description":"Current authenticated reseller profile and rate allowance; no credentials are returned.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":false,"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"discountPercent":{"type":"number"},"rateLimitPerMinute":{"type":"integer"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}}}},"/api/v2/balance":{"get":{"operationId":"getResellerBalance","description":"Current available wallet balance. This read neither reserves nor debits funds.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":false,"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["balanceMmk"],"properties":{"balanceMmk":{"type":"integer","minimum":0,"description":"Whole Myanmar kyat; no decimal or foreign-currency conversion."}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}}}},"/api/v2/categories":{"get":{"operationId":"listResellerCategories","description":"Published category names and slugs.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":false,"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["categories"],"properties":{"categories":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}}}}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}}}},"/api/v2/products":{"get":{"operationId":"listResellerProducts","description":"Compact product summaries with quantity-one account prices. available means purchasing is currently supported and stock is available. unavailableReason explains a false value. requiredInputs is an array of required string field names. Use /quotes for exact quantity pricing and destination eligibility. Search normalizes 1000mb, 1,000 MB and Myanmar digits. Hidden/archived products are excluded.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":false,"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["products","nextCursor"],"properties":{"products":{"type":"array","items":{"$ref":"#/components/schemas/ResellerProduct"}},"nextCursor":{"type":["string","null"]}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}},"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":24}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Opaque nextCursor from the previous response. Keep filters unchanged."},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"collection","in":"query","schema":{"type":"string"}},{"name":"available","in":"query","schema":{"type":"boolean"}}]}},"/api/v2/products/{id}":{"get":{"operationId":"getResellerProduct","description":"Read one product by numeric ID. Adds Markdown description, canonical URL, stock and optional image. listPriceMmk is included only when greater than priceMmk.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":false,"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResellerProduct"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1}}]}},"/api/v2/quotes":{"post":{"operationId":"quoteResellerOrder","description":"Read-only exact quote. It checks current product, quantity and recipient eligibility using the same resolver as checkout. It creates no order, reserves no stock and debits nothing. Quote amount can change; confirm before POST /orders. For supported PUBG, Mobile Legends, Magic Chess GoGo, Roblox or Telegram products, send exactly product.requiredInputs as strings inside inputs. Supported checks return recipientName and recipientRegionCode; a missing name is not verification and region is not purchase eligibility. Lookup and API limits apply. Flash Sale offers are unavailable on the reseller channel.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":false,"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResellerQuote"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}},"externalDocs":{"url":"https://digizay.com/docs/v2#account-name-check","description":"Game ID and account name checks with examples"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["productId"],"properties":{"productId":{"type":"integer","minimum":1},"quantity":{"type":"integer","minimum":1,"default":1},"inputs":{"type":"object","maxProperties":8,"additionalProperties":{"type":"string","maxLength":128},"description":"Only include the string fields named by product.requiredInputs. Omit inputs for an empty list. Examples: {phone: destination}, {username: recipient}, {email: recipient}, or {gameId: player, serverId: server}. Legacy gameId aliases for username/email remain accepted; do not combine aliases. The server rejects missing or unrelated fields."},"phone":{"type":"string","maxLength":32,"deprecated":true,"description":"Compatibility alias from the initial v2 release. Use inputs.phone; do not send both."}}}}}}}},"/api/v2/orders":{"get":{"operationId":"listOwnResellerOrders","description":"Newest account-owned orders. No other user or guest orders are accessible.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":false,"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["orders","nextCursor"],"properties":{"orders":{"type":"array","items":{"$ref":"#/components/schemas/ResellerOrder"}},"nextCursor":{"type":["string","null"]}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}},"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":24}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Opaque nextCursor from the previous response. Keep filters unchanged."},{"name":"status","in":"query","schema":{"type":"string","enum":["pending","paid","delivered","cancelled"]}}]},"post":{"operationId":"createResellerOrder","description":"DEBITS WALLET. Obtain explicit confirmation of product, destination, quantity and exact quoted total first. Send confirmed:true and expectedTotalMmk from /quotes. The final total must not exceed this authorized maximum. Reuse the same Idempotency-Key and identical body after timeouts/429. A paid order is still processing: poll its status or use webhooks; never submit another purchase to check delivery. V1 and v2 share the idempotency namespace, so a key reused with another contract fails instead of charging twice.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":true,"responses":{"201":{"description":"Order accepted or existing idempotent order returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResellerOrder"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["productId","expectedTotalMmk","confirmed"],"properties":{"productId":{"type":"integer","minimum":1},"quantity":{"type":"integer","minimum":1,"default":1},"inputs":{"type":"object","maxProperties":8,"additionalProperties":{"type":"string","maxLength":128},"description":"Only include the string fields named by product.requiredInputs. Omit inputs for an empty list. Examples: {phone: destination}, {username: recipient}, {email: recipient}, or {gameId: player, serverId: server}. Legacy gameId aliases for username/email remain accepted; do not combine aliases. The server rejects missing or unrelated fields."},"phone":{"type":"string","maxLength":32,"deprecated":true,"description":"Compatibility alias from the initial v2 release. Use inputs.phone; do not send both."},"expectedTotalMmk":{"type":"integer","minimum":1,"description":"Whole Myanmar kyat; no decimal or foreign-currency conversion.","maximum":500000000},"confirmed":{"const":true}}}}}}}},"/api/v2/orders/{code}":{"get":{"operationId":"getOwnResellerOrder","description":"Owned order status and delivered result. A different user or guest order returns 404. paid does not prove delivery. Keep delivered credentials private.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":false,"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResellerOrder"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}},"parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","pattern":"^DZ-[A-Fa-f0-9]{8}$"}}]}},"/api/v2/wallet/transactions":{"get":{"operationId":"listOwnWalletTransactions","description":"Owned wallet ledger, newest first. amountMmk is signed: purchases are negative; refunds/top-ups positive. Internal notes and other users are excluded.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":false,"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["transactions","nextCursor"],"properties":{"transactions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"amountMmk":{"type":"integer"},"kind":{"type":"string"},"method":{"type":"string"},"orderCode":{"type":"string"},"createdAt":{"type":"string","format":"date-time"}}}},"nextCursor":{"type":["string","null"]}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}},"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":24}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Opaque nextCursor from the previous response. Keep filters unchanged."},{"name":"kind","in":"query","schema":{"type":"string","enum":["topup","purchase","refund","adjust","affiliate_commission","affiliate_reversal","affiliate_withdrawal","affiliate_withdrawal_release"]}}]}},"/api/v2/webhook":{"get":{"operationId":"getResellerWebhook","description":"Read your single webhook configuration; signing secrets are never returned by GET.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":false,"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}}},"put":{"operationId":"configureResellerWebhook","description":"Create or update your public HTTPS receiver. Include current version on updates. Signing secret is returned once on create/rotation. Shares configuration with v1 and Dashboard.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":true,"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"enabled":{"type":"boolean"},"events":{"type":"array","items":{"type":"string","enum":["order.paid","order.delivered","order.cancelled","order.refunded"]}},"version":{"type":"integer","minimum":1}}}}}}},"delete":{"operationId":"disableResellerWebhook","description":"Disable with current version. A request already in flight may finish.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":true,"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["version"],"properties":{"version":{"type":"integer","minimum":1}}}}}}}},"/api/v2/webhook/test":{"post":{"operationId":"testResellerWebhook","description":"Queue a test event; no purchase or wallet change.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":true,"responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}}}},"/api/v2/webhook/rotate-secret":{"post":{"operationId":"rotateResellerWebhookSecret","description":"Rotate the signing key with current version; cancel pending deliveries for the old configuration.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":true,"responses":{"200":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["version"],"properties":{"version":{"type":"integer","minimum":1}}}}}}}},"/api/v2/webhook/deliveries":{"get":{"operationId":"listResellerWebhookDeliveries","description":"Owned delivery attempts, bounded page. At-least-once delivery; deduplicate receiver events by webhook-id.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":false,"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}},"parameters":[{"name":"before","in":"query","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}]}},"/api/v2/webhook/deliveries/{id}/retry":{"post":{"operationId":"retryResellerWebhookDelivery","description":"Retry an eligible owned event. Does not retry the order or charge money.","security":[{"ResellerKey":[]},{"ResellerBearer":[]}],"x-openai-isConsequential":true,"responses":{"202":{"description":"Retry queued","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"API key required or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Account suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"404":{"description":"Owned resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"409":{"description":"State, price or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"413":{"description":"Request body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"429":{"description":"Respect Retry-After and rate-limit headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Service error; purchase outcome may be unknown","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"503":{"description":"Temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}]}}},"components":{"schemas":{"CollectionIndex":{"type":"object","required":["version","currency","collections"],"properties":{"version":{"const":2},"currency":{"const":"MMK"},"collections":{"type":"array","items":{"$ref":"#/components/schemas/Collection"}}}},"Collection":{"type":"object","required":["slug","name","kind","browseCategory","browseCategoryUrl","productCount","availableCount","fromPriceMmk","currency","available","url","collectionUrl","destination"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["game","operator","items"]},"carrier":{"type":"string"},"browseCategory":{"type":"string","description":"Public browse category slug, including configured product categories."},"browseCategoryUrl":{"type":"string"},"productCount":{"type":"integer","minimum":0},"availableCount":{"type":"integer","minimum":0},"fromPriceMmk":{"type":"integer","minimum":0,"description":"Lowest ordinary display price, excluding Flash Sale offers."},"currency":{"const":"MMK"},"available":{"type":"boolean"},"url":{"type":"string","format":"uri-reference"},"collectionUrl":{"type":"string","format":"uri-reference"},"destination":{"type":"string","enum":["collection","product"]}}},"CollectionPage":{"type":"object","required":["version","collection","products","page","pageSize","hasMore"],"properties":{"version":{"const":2},"collection":{"$ref":"#/components/schemas/Collection"},"products":{"type":"array","maxItems":24,"items":{"$ref":"#/components/schemas/Product"}},"page":{"type":"integer","minimum":1,"maximum":100},"pageSize":{"const":24},"hasMore":{"type":"boolean"}}},"Product":{"type":"object","required":["id","name","variant","category","url","currency","displayPriceMmk","available","requiredInputs","quoteRequired","confirmationRequired","capabilities"],"properties":{"id":{"type":"integer","minimum":1},"slug":{"type":"string"},"name":{"type":"string"},"variant":{"type":"string"},"category":{"type":"string"},"url":{"type":"string","format":"uri-reference","description":"Canonical main product URL for grouped packages, or the ordinary product URL. Select packages by returned product ID, not URL parameters; conditional Flash links still need an explicit flash offer ID."},"currency":{"const":"MMK"},"displayPriceMmk":{"type":"integer","minimum":0,"description":"Ordinary effective price after any ordinary sale percent. Does not include Flash Sale."},"available":{"type":"boolean"},"requiredInputs":{"type":"array","items":{"$ref":"#/components/schemas/RequiredInput"}},"quoteRequired":{"const":true},"confirmationRequired":{"const":true},"capabilities":{"$ref":"#/components/schemas/Capabilities"}}},"RequiredInput":{"type":"object","required":["name","type","label","required"],"properties":{"name":{"type":"string","enum":["phone","username","email","accountId","gameId","serverId"]},"type":{"const":"string"},"label":{"type":"string"},"required":{"type":"boolean"},"enum":{"type":"array","items":{"type":"string"},"description":"Allowed values when this field is a selection."}}},"Capabilities":{"type":"object","required":["browserCheckout","mcpCheckout","resellerCheckout","reason"],"properties":{"browserCheckout":{"type":"boolean"},"mcpCheckout":{"type":"boolean"},"resellerCheckout":{"type":"boolean"},"reason":{"type":["string","null"],"description":"GAME_CHECKOUT_UNSUPPORTED indicates browse-only game content; never fabricate an order."}}},"Error":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}},"V2Error":{"type":"object","required":["error"],"description":"Error codes and recovery actions: /docs/v2#api-errors. Check error.code; message adds context and details is optional. Unknown codes do not prove that a purchase failed.","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable reason, for example INVALID_INPUTS, PRICE_UPDATED, IDEMPOTENCY_KEY_REUSED, RATE_LIMITED or SERVICE_UNAVAILABLE. Additional codes may be returned; this is not a closed enum."},"message":{"type":"string"},"details":{"type":"object"}}}},"example":{"error":{"code":"PRICE_UPDATED","message":"Price changed; get a new quote","details":{"newTotalMmk":1100}}}},"ResellerProduct":{"type":"object","required":["id","name","category","priceMmk","available","maxQuantity","requiredInputs"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"variant":{"type":"string"},"category":{"type":"string","description":"Category slug"},"collection":{"type":"string","description":"Parent collection slug, when grouped"},"priceMmk":{"type":"integer","minimum":0,"description":"Whole Myanmar kyat; no decimal or foreign-currency conversion."},"available":{"type":"boolean","description":"Currently supported and in stock"},"unavailableReason":{"type":"string","enum":["GAME_CHECKOUT_UNSUPPORTED","PRICE_UNAVAILABLE","OUT_OF_STOCK"]},"maxQuantity":{"type":"integer","minimum":0},"requiredInputs":{"type":"array","items":{"type":"string","enum":["phone","username","email","accountId","gameId","serverId"]},"description":"Only send required fields. All field values are strings. Telegram and Roblox use username; Apple USA and Roblox Gift Cards need no recipient input; BIGO uses accountId; PUBG, Honor of Kings and Free Fire use gameId; MLBB/MCGG use gameId and serverId. Only products marked available support checkout."},"url":{"type":"string","format":"uri-reference"},"description":{"type":"string","description":"Markdown, detail endpoint only"},"imageUrl":{"type":"string"},"stock":{"type":["integer","null"],"description":"Current effective stock count; 0 when unavailable, null when unknown. Counts are not reservations; quote validates current capacity."},"listPriceMmk":{"type":"integer","minimum":0,"description":"Whole Myanmar kyat; no decimal or foreign-currency conversion."}}},"ResellerQuote":{"type":"object","required":["unitPriceMmk","totalMmk","balanceMmk"],"properties":{"unitPriceMmk":{"type":"integer","minimum":0,"description":"Whole Myanmar kyat; no decimal or foreign-currency conversion."},"totalMmk":{"type":"integer","minimum":0,"description":"Whole Myanmar kyat; no decimal or foreign-currency conversion."},"balanceMmk":{"type":"integer","minimum":0,"description":"Whole Myanmar kyat; no decimal or foreign-currency conversion."},"recipientName":{"type":"string","description":"Verified recipient name when supported"},"recipientRegionCode":{"type":["string","null"],"pattern":"^[A-Z]{2}$","description":"Account country when known; display only, never purchase eligibility"},"discountMmk":{"type":"integer","minimum":0,"description":"Present only for a positive discount"}}},"ResellerOrder":{"type":"object","required":["code","status","totalMmk"],"properties":{"code":{"type":"string"},"status":{"type":"string","enum":["pending","paid","delivered","cancelled"]},"totalMmk":{"type":"integer","minimum":0,"description":"Whole Myanmar kyat; no decimal or foreign-currency conversion."},"balanceMmk":{"type":"integer","minimum":0,"description":"Whole Myanmar kyat; no decimal or foreign-currency conversion."},"inputs":{"type":"object","additionalProperties":{"type":"string"}},"items":{"type":"array","items":{"type":"object"}},"result":{"description":"Present only after delivery when a result exists. May contain private delivery credentials.","type":["string","object","array"]},"createdAt":{"type":"string","format":"date-time"}}}},"securitySchemes":{"ResellerKey":{"type":"apiKey","in":"header","name":"X-Api-Key"},"ResellerBearer":{"type":"http","scheme":"bearer"}}}}