{"info":{"_postman_id":"a88b9e11-f3f3-a314-c97f-77fb6b80eedb","name":"Throne API","description":"API REST do gateway Throne \u00b7 PIX in\/out + cripto out.","version":"1.0.0","schema":"https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json"},"auth":{"type":"bearer","bearer":[{"key":"token","value":"{{public_key}}:{{secret_key}}","type":"string"}]},"variable":[{"key":"base_url","value":"https:\/\/app.thronecorporate.com\/api\/v1","type":"string"},{"key":"public_key","value":"pk_live_xxx","type":"string"},{"key":"secret_key","value":"sk_live_xxx","type":"string"}],"item":[{"name":"Sa\u00fade","item":[{"name":"Health check (sem auth)","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}\/health","host":["{{base_url}}"],"path":["health"]},"body":null,"description":null},"response":[]}]},{"name":"Saldo","item":[{"name":"Saldo atual da wallet","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}\/balance","host":["{{base_url}}"],"path":["balance"]},"body":null,"description":"Retorna saldo dispon\u00edvel, reservado (em saques) e pendente."},"response":[]}]},{"name":"Transa\u00e7\u00f5es","item":[{"name":"Criar cobran\u00e7a PIX","request":{"method":"POST","header":[{"key":"Idempotency-Key","value":"a3b6e3f8-2f1d-4f6b-9e7c-9b4f5d1c3a2e","type":"text"},{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/transactions","host":["{{base_url}}"],"path":["transactions"]},"body":{"mode":"raw","raw":"{\n    \"amount_cents\": 10000,\n    \"payment_method\": \"pix\",\n    \"idempotency_key\": \"tx-pedido-2026-001\",\n    \"expires_at\": \"2026-05-06T18:00:00Z\",\n    \"customer\": {\n        \"name\": \"Jo\u00e3o Cliente\",\n        \"document\": \"12345678901\",\n        \"email\": \"joao@example.com\",\n        \"phone\": \"+5511999999999\"\n    },\n    \"metadata\": {\n        \"order_id\": \"PEDIDO-42\",\n        \"sku\": \"CAMISA-AZUL-M\"\n    }\n}","options":{"raw":{"language":"json"}}},"description":"Gera QR Code copia-e-cola que o cliente final paga. Status inicial = `pending`. Quando o pagamento for confirmado pela adquirente, disparamos webhook `transaction.paid` e creditamos o saldo do seller."},"response":[]},{"name":"Consultar transa\u00e7\u00e3o","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}\/transactions\/:id","host":["{{base_url}}"],"path":["transactions","{id}"]},"body":null,"description":null},"response":[]},{"name":"Listar transa\u00e7\u00f5es (paginado)","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}\/transactions\/list","host":["{{base_url}}"],"path":["transactions","list"]},"body":null,"description":"Lista as transa\u00e7\u00f5es do seller. Aceita filtros por status, per\u00edodo e payment_method. Pagina\u00e7\u00e3o cursor-based."},"response":[]},{"name":"Estornar transa\u00e7\u00e3o paga","request":{"method":"POST","header":[{"key":"Idempotency-Key","value":"a3b6e3f8-2f1d-4f6b-9e7c-9b4f5d1c3a2e","type":"text"},{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/transactions\/:id\/refund","host":["{{base_url}}"],"path":["transactions","{id}","refund"]},"body":{"mode":"raw","raw":"{\n    \"_comment\": \"preencher conforme schema\"\n}","options":{"raw":{"language":"json"}}},"description":"Cria entry tipo `reverse` no ledger. Estorno parcial OK (passe `amount_cents`). Se omitir, estorna o l\u00edquido total."},"response":[]}]},{"name":"Saques","item":[{"name":"Solicitar saque PIX ou cripto","request":{"method":"POST","header":[{"key":"Idempotency-Key","value":"a3b6e3f8-2f1d-4f6b-9e7c-9b4f5d1c3a2e","type":"text"},{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/withdrawals","host":["{{base_url}}"],"path":["withdrawals"]},"body":{"mode":"raw","raw":"{\n    \"amount_cents\": 50000,\n    \"totp_code\": \"123456\",\n    \"idempotency_key\": \"wdr-2026-05-06-001\",\n    \"destination\": {\n        \"key\": \"a@b.com\",\n        \"key_type\": \"email\"\n    }\n}","options":{"raw":{"language":"json"}}},"description":"Exige **2FA TOTP** (`totp_code`) e **2FA habilitado** no seller. Lock pessimista impede over-draft mesmo em chamadas concorrentes. Ap\u00f3s criar, status = `requested`. Webhook `withdrawal.completed` ou `withdrawal.failed` chega quando o banco confirma."},"response":[]},{"name":"Consultar saque","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}\/withdrawals\/:id","host":["{{base_url}}"],"path":["withdrawals","{id}"]},"body":null,"description":null},"response":[]},{"name":"Listar saques (paginado)","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}\/withdrawals\/list","host":["{{base_url}}"],"path":["withdrawals","list"]},"body":null,"description":null},"response":[]}]}]}