{"openapi":"3.0.3","paths":{"/llms.txt":{"get":{"operationId":"Api_llms","parameters":[],"responses":{"200":{"description":""},"400":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Subscription expired or order allowance exhausted; existing orders remain valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Idempotency, immutable transfer or order state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[],"tags":["payment-orders"]}},"/examples/{language}/{file}":{"get":{"operationId":"Api_example","parameters":[{"name":"language","required":true,"in":"path","schema":{"type":"string"}},{"name":"file","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Public source from a fixed allowlist; no credentials required","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Subscription expired or order allowance exhausted; existing orders remain valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Idempotency, immutable transfer or order state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[],"tags":["payment-orders"]}},"/integration.md":{"get":{"operationId":"Api_integration","parameters":[{"name":"lang","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""},"400":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Subscription expired or order allowance exhausted; existing orders remain valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Idempotency, immutable transfer or order state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[],"tags":["payment-orders"]}},"/health/live":{"get":{"operationId":"Api_live","parameters":[],"responses":{"200":{"description":""},"400":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Subscription expired or order allowance exhausted; existing orders remain valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Idempotency, immutable transfer or order state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[],"tags":["payment-orders"]}},"/health/ready":{"get":{"operationId":"Api_ready","parameters":[],"responses":{"200":{"description":""},"400":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Subscription expired or order allowance exhausted; existing orders remain valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Idempotency, immutable transfer or order state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[],"tags":["payment-orders"]}},"/v1/payment-orders":{"post":{"operationId":"Api_create","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["merchantOrderNo","asset","amount"],"properties":{"merchantOrderNo":{"type":"string"},"asset":{"type":"string","enum":["TRX","USDT"]},"amount":{"type":"string","example":"10.000000"},"expiresInSeconds":{"type":"integer","minimum":60,"maximum":86400},"metadata":{"type":"object","additionalProperties":{"type":"string"}}}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Order"}}}},"400":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Subscription expired or order allowance exhausted; existing orders remain valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Idempotency, immutable transfer or order state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearer":[]}],"summary":"Create an idempotent payment order in the configured environment","tags":["payment-orders"]},"get":{"operationId":"Api_list","parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"in":"query","name":"after","description":"Opaque nextCursor from the previous page","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Order"}},"nextCursor":{"type":"string","nullable":true},"hasMore":{"type":"boolean"}}}}}},"400":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Subscription expired or order allowance exhausted; existing orders remain valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Idempotency, immutable transfer or order state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearer":[]}],"tags":["payment-orders"]}},"/v1/payment-orders/{orderId}":{"get":{"operationId":"Api_read","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Order"}}}},"400":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Subscription expired or order allowance exhausted; existing orders remain valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Idempotency, immutable transfer or order state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearer":[]}],"tags":["payment-orders"]}},"/v1/payment-orders/{orderId}/cancel":{"post":{"operationId":"Api_cancel","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Order"}}}},"400":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Subscription expired or order allowance exhausted; existing orders remain valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Idempotency, immutable transfer or order state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearer":[]}],"tags":["payment-orders"]}},"/v1/sandbox/payment-orders/{orderId}/transfers":{"post":{"operationId":"Api_simulate","parameters":[{"name":"orderId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["txId"],"properties":{"txId":{"type":"string","pattern":"^[a-f0-9]{64}$"},"transferIndex":{"type":"integer","minimum":0},"amount":{"type":"string"},"asset":{"type":"string","enum":["TRX","USDT"]},"executionStatus":{"type":"string","enum":["SUCCESS","FAILED","UNKNOWN"]},"confirmations":{"type":"integer","minimum":0},"solidified":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"matched":{"type":"boolean"},"reason":{"type":"string"},"duplicate":{"type":"boolean"},"order":{"$ref":"#/components/schemas/Order"}}}}}},"400":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Subscription expired or order allowance exhausted; existing orders remain valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Idempotency, immutable transfer or order state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearer":[]}],"summary":"Simulate a sandbox chain observation; never available for live money","tags":["payment-orders"]}},"/v1/events":{"get":{"operationId":"Api_events","parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"in":"query","name":"after","description":"Opaque nextCursor from the previous page","schema":{"type":"string"}}],"responses":{"200":{"description":""},"400":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Subscription expired or order allowance exhausted; existing orders remain valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Idempotency, immutable transfer or order state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearer":[]}],"tags":["payment-orders"]}},"/v1/webhook-deliveries":{"get":{"operationId":"Api_deliveries","parameters":[{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"in":"query","name":"after","description":"Opaque nextCursor from the previous page","schema":{"type":"string"}}],"responses":{"200":{"description":""},"400":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Subscription expired or order allowance exhausted; existing orders remain valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Idempotency, immutable transfer or order state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearer":[]}],"tags":["payment-orders"]}},"/v1/webhook-deliveries/{deliveryId}/retry":{"post":{"operationId":"Api_retry","parameters":[{"name":"deliveryId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""},"400":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Subscription expired or order allowance exhausted; existing orders remain valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Idempotency, immutable transfer or order state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"bearer":[]}],"tags":["payment-orders"]}},"/v1/checkout/session":{"get":{"operationId":"Api_session","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Order"}}}},"400":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"402":{"description":"Subscription expired or order allowance exhausted; existing orders remain valid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"Idempotency, immutable transfer or order state conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Request rate exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"Request error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"security":[{"checkoutToken":[]}],"tags":["payment-orders"],"description":"Use the private order token from checkoutUrl, never a merchant API key."}}},"info":{"title":"TRON Pay Sandbox API","description":"Sandbox only. No custody, live payment or manual confirmation endpoints.","version":"0.1.0","contact":{}},"tags":[],"servers":[],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"},"checkoutToken":{"type":"http","scheme":"bearer","description":"Private order-scoped checkout token"}},"schemas":{"Order":{"type":"object","required":["id","merchantOrderNo","environment","network","asset","amount","amountRaw","address","status","expiresAt","solidified","createdAt"],"properties":{"id":{"type":"string","format":"uuid"},"merchantOrderNo":{"type":"string"},"environment":{"type":"string","enum":["sandbox","live"]},"network":{"type":"string","enum":["tron:sandbox","tron:mainnet"]},"asset":{"type":"string","enum":["TRX","USDT"]},"amount":{"type":"string","pattern":"^[0-9]+\\.[0-9]{6}$"},"amountRaw":{"type":"string","pattern":"^[0-9]+$"},"requestedAmount":{"type":"string","pattern":"^[0-9]+\\.[0-9]{6}$","description":"Original requested amount; required for live orders. Pay amount, not requestedAmount."},"requestedAmountRaw":{"type":"string","pattern":"^[1-9][0-9]{0,77}$"},"address":{"type":"string","description":"Sandbox addresses start with sandbox:. Live orders use a verified TRON address; live availability is gated."},"status":{"type":"string","enum":["pending","confirming","paid","expired","cancelled","review"]},"expiresAt":{"type":"string","format":"date-time"},"paidAt":{"type":"string","format":"date-time","nullable":true},"solidified":{"type":"boolean"},"reviewReason":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"checkoutUrl":{"type":"string","format":"uri","description":"Private order-scoped checkout capability, never log or share publicly."}},"oneOf":[{"properties":{"environment":{"enum":["sandbox"]},"network":{"enum":["tron:sandbox"]},"address":{"pattern":"^sandbox:"}}},{"required":["requestedAmount","requestedAmountRaw"],"properties":{"environment":{"enum":["live"]},"network":{"enum":["tron:mainnet"]},"address":{"pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$"}}}]},"ApiError":{"type":"object","properties":{"error":{"type":"object","required":["code","requestId"],"properties":{"code":{"type":"string"},"requestId":{"type":"string"}}}}}}}}