{"openapi":"3.0.0","paths":{"/v1/charges":{"post":{"description":"Envia uma cobrança para a maquininha. Ela aparece no terminal em até ~1 segundo. O resultado chega pelo webhook.","operationId":"PublicApiController_create","parameters":[{"name":"Idempotency-Key","in":"header","description":"Chave única por cobrança. Repetir a mesma chave devolve a mesma cobrança.","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateChargeDto"}}}},"responses":{"200":{"description":"Mesma Idempotency-Key: cobrança já existente."},"201":{"description":"Cobrança criada."},"402":{"description":"insufficient_credits"}},"security":[{"ApiKey":[]}],"summary":"Criar cobrança","tags":["Cobranças"]},"get":{"description":"Mais recentes primeiro, paginadas por cursor.","operationId":"PublicApiController_list","parameters":[{"name":"cursor","required":false,"in":"query","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"default":20,"type":"number"}},{"name":"terminal_id","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["pending","processing","approved","declined","canceled","failed","expired"]}},{"name":"external_reference","required":false,"in":"query","schema":{"type":"string"}},{"name":"created_from","required":false,"in":"query","description":"Data/hora ISO 8601 inicial (inclusiva).","schema":{"type":"string"}},{"name":"created_to","required":false,"in":"query","description":"Data/hora ISO 8601 final (inclusiva).","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"ApiKey":[]}],"summary":"Listar cobranças","tags":["Cobranças"]}},"/v1/charges/{id}":{"get":{"operationId":"PublicApiController_get","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"ApiKey":[]}],"summary":"Consultar cobrança","tags":["Cobranças"]}},"/v1/charges/{id}/cancel":{"post":{"description":"Só funciona enquanto a cobrança está \"pending\" (a maquininha ainda não pegou).","operationId":"PublicApiController_cancel","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"ApiKey":[]}],"summary":"Cancelar cobrança","tags":["Cobranças"]}},"/v1/terminals":{"get":{"operationId":"PublicApiController_listTerminals","parameters":[],"responses":{"200":{"description":""}},"security":[{"ApiKey":[]}],"summary":"Listar terminais","tags":["Cobranças","Terminais"]}},"/v1/balance":{"get":{"operationId":"PublicApiController_balance","parameters":[],"responses":{"200":{"description":""}},"security":[{"ApiKey":[]}],"summary":"Saldo de créditos","tags":["Cobranças","Créditos"]}}},"info":{"title":"Integrator API","description":"API de cobranças em maquininhas Android (Safra e Rede). Autentique com sua API key no cabeçalho Authorization.","version":"1.0.0","contact":{}},"tags":[],"servers":[{"url":"https://api.integrator.co26.com.br"}],"components":{"securitySchemes":{"ApiKey":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"API key itg_live_..."}},"schemas":{"CreateChargeDto":{"type":"object","properties":{"terminal_id":{"type":"string","description":"Terminal (maquininha) que vai receber a cobrança.","example":"6f1c2b8e-2f4a-4c55-9a59-6a1d5b1f0c3e"},"amount":{"type":"number","description":"Valor em centavos. R$ 12,50 = 1250.","example":1250,"minimum":1,"maximum":10000000},"method":{"type":"string","enum":["credit","debit","pix"],"example":"credit"},"description":{"type":"string","description":"Texto livre exibido na maquininha e no painel.","example":"Pedido #1234","maxLength":140},"external_reference":{"type":"string","description":"Identificador da cobrança no seu sistema.","example":"pedido-1234","maxLength":100}},"required":["terminal_id","amount","method"]}}}}