{"openapi":"3.1.0","info":{"title":"Relay API","description":"Authenticate using X-API-Key. USD amounts are decimal strings; timestamps are Unix seconds. Purchases require an Idempotency-Key. Poll your order every 15 seconds.","version":"1.0.0"},"paths":{"/catalog":{"get":{"tags":["Public catalog"],"summary":"Public Catalog","operationId":"public_catalog_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogResponse"}}}}}}},"/v1/balance":{"get":{"tags":["Customer API"],"summary":"Balance","operationId":"balance_v1_balance_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BalanceResponse"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/products":{"get":{"tags":["Customer API"],"summary":"Products","operationId":"products_v1_products_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogResponse"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/orders":{"post":{"tags":["Customer API"],"summary":"Purchase","operationId":"purchase_v1_orders_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$","title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Purchase"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Customer API"],"summary":"Orders","operationId":"orders_v1_orders_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orders/{order_id}":{"get":{"tags":["Customer API"],"summary":"Order Detail","operationId":"order_detail_v1_orders__order_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/transactions":{"get":{"tags":["Customer API"],"summary":"Transactions","operationId":"transactions_v1_transactions_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accounts/{account_id}/replacement":{"post":{"tags":["Customer API"],"summary":"Replacement","operationId":"replacement_v1_accounts__account_id__replacement_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string","title":"Account Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$","title":"Idempotency-Key"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accounts/{account_id}/warranty":{"get":{"tags":["Customer API"],"summary":"Warranty","operationId":"warranty_v1_accounts__account_id__warranty_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string","title":"Account Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accounts/{account_id}/status":{"get":{"tags":["Customer API"],"summary":"Account Status","operationId":"account_status_v1_accounts__account_id__status_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string","title":"Account Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/payments/status":{"get":{"tags":["Litecoin payments"],"summary":"Status","operationId":"status_v1_payments_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/payments":{"post":{"tags":["Litecoin payments"],"summary":"New Invoice","operationId":"new_invoice_v1_payments_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$","title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Litecoin payments"],"summary":"Invoices","operationId":"invoices_v1_payments_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/payments/{invoice_id}":{"get":{"tags":["Litecoin payments"],"summary":"Invoice Detail","operationId":"invoice_detail_v1_payments__invoice_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"invoice_id","in":"path","required":true,"schema":{"type":"string","title":"Invoice Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/payments/{invoice_id}/qr":{"get":{"tags":["Litecoin payments"],"summary":"Invoice Qr","operationId":"invoice_qr_v1_payments__invoice_id__qr_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"invoice_id","in":"path","required":true,"schema":{"type":"string","title":"Invoice Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"BalanceResponse":{"properties":{"customer_id":{"type":"string","title":"Customer Id"},"balance":{"type":"string","title":"Balance","description":"Available USD, six decimal places"},"currency":{"type":"string","const":"USD","title":"Currency"}},"type":"object","required":["customer_id","balance","currency"],"title":"BalanceResponse"},"CatalogResponse":{"properties":{"currency":{"type":"string","const":"USD","title":"Currency"},"discount_percent":{"type":"string","title":"Discount Percent","description":"Customer percentage discount already included in unit prices"},"updated_at":{"type":"integer","title":"Updated At"},"stale":{"type":"boolean","title":"Stale"},"products":{"items":{"$ref":"#/components/schemas/ProductResponse"},"type":"array","title":"Products"}},"type":"object","required":["currency","discount_percent","updated_at","stale","products"],"title":"CatalogResponse"},"DeliveredAccount":{"properties":{"id":{"type":"string","title":"Id"},"credential":{"type":"string","title":"Credential"}},"type":"object","required":["id","credential"],"title":"DeliveredAccount"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"InvoiceRequest":{"properties":{"kind":{"type":"string","enum":["purchase","topup"],"title":"Kind","default":"purchase"},"product_id":{"anyOf":[{"type":"string","maxLength":36,"minLength":36},{"type":"null"}],"title":"Product Id"},"quantity":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Quantity","default":1},"amount":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Amount"},"max_total":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Max Total"}},"additionalProperties":false,"type":"object","title":"InvoiceRequest"},"OrderListResponse":{"properties":{"orders":{"items":{"$ref":"#/components/schemas/OrderSummary"},"type":"array","title":"Orders"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["orders","limit","offset"],"title":"OrderListResponse"},"OrderResponse":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","enum":["queued","submitting","processing","fulfilled","failed","denied","review"],"title":"Status"},"kind":{"type":"string","enum":["purchase","replacement"],"title":"Kind"},"total":{"type":"string","title":"Total"},"currency":{"type":"string","const":"USD","title":"Currency"},"created_at":{"type":"integer","title":"Created At"},"product_id":{"type":"string","title":"Product Id"},"quantity":{"type":"integer","title":"Quantity"},"unit_price":{"type":"string","title":"Unit Price"},"refunded":{"type":"boolean","title":"Refunded"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"updated_at":{"type":"integer","title":"Updated At"},"accounts":{"items":{"$ref":"#/components/schemas/DeliveredAccount"},"type":"array","title":"Accounts"}},"type":"object","required":["id","status","kind","total","currency","created_at","product_id","quantity","unit_price","refunded","error_code","updated_at","accounts"],"title":"OrderResponse"},"OrderSummary":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","enum":["queued","submitting","processing","fulfilled","failed","denied","review"],"title":"Status"},"kind":{"type":"string","enum":["purchase","replacement"],"title":"Kind"},"total":{"type":"string","title":"Total"},"currency":{"type":"string","const":"USD","title":"Currency"},"created_at":{"type":"integer","title":"Created At"}},"type":"object","required":["id","status","kind","total","currency","created_at"],"title":"OrderSummary"},"ProductResponse":{"properties":{"id":{"type":"string","title":"Id"},"game":{"type":"string","title":"Game"},"type":{"type":"string","title":"Type"},"name":{"type":"string","title":"Name"},"unit_price":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit Price"},"available":{"type":"integer","title":"Available"},"purchasable":{"type":"boolean","title":"Purchasable"}},"type":"object","required":["id","game","type","name","unit_price","available","purchasable"],"title":"ProductResponse"},"Purchase":{"properties":{"product_id":{"type":"string","maxLength":36,"minLength":36,"title":"Product Id"},"quantity":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Quantity","default":1},"max_total":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Max Total","description":"Optional maximum total in USD, as a decimal string"}},"additionalProperties":false,"type":"object","required":["product_id"],"title":"Purchase"},"TransactionListResponse":{"properties":{"currency":{"type":"string","const":"USD","title":"Currency"},"transactions":{"items":{"$ref":"#/components/schemas/TransactionResponse"},"type":"array","title":"Transactions"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["currency","transactions","limit","offset"],"title":"TransactionListResponse"},"TransactionResponse":{"properties":{"id":{"type":"string","title":"Id"},"order_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order Id"},"amount":{"type":"string","title":"Amount"},"balance_after":{"type":"string","title":"Balance After"},"kind":{"type":"string","title":"Kind"},"created_at":{"type":"integer","title":"Created At"}},"type":"object","required":["id","order_id","amount","balance_after","kind","created_at"],"title":"TransactionResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}