{"openapi":"3.1.0","info":{"title":"SlacePay API","version":"1.0.0","description":"API PIX para clientes SlacePay. Todas as operações exigem uma chave secreta própria."},"servers":[{"url":"https://www.slacepay.com"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Conta"},{"name":"PIX"},{"name":"Saques"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"sk_test_<64 hex> ou sk_live_<64 hex>"}}},"paths":{"/v1/me":{"get":{"operationId":"get__v1_me","tags":["Conta"],"summary":"Consultar sua conta","description":"Consulte cadastro, taxas e limites vigentes. Os valores fixedCents, minCents, maxCents e dailyCents estão em centavos; bps representa centésimos de percentual (500 = 5%).","parameters":[],"responses":{"200":{"description":"Solicitação processada. Consulte status para saber o resultado financeiro.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"telegramId":{"type":"string"},"status":{"type":"string","enum":["active","blocked"]},"fees":{"type":"object","additionalProperties":false,"properties":{"cashIn":{"type":"object","additionalProperties":false,"properties":{"bps":{"type":"integer"},"fixedCents":{"type":"integer"}},"required":["bps","fixedCents"]},"cashOut":{"type":"object","additionalProperties":false,"properties":{"bps":{"type":"integer"},"fixedCents":{"type":"integer"}},"required":["bps","fixedCents"]}},"required":["cashIn","cashOut"]},"limits":{"type":"object","additionalProperties":false,"properties":{"cashIn":{"type":"object","additionalProperties":false,"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"dailyCents":{"type":"integer"}},"required":["minCents","maxCents","dailyCents"]},"cashOut":{"type":"object","additionalProperties":false,"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"dailyCents":{"type":"integer"}},"required":["minCents","maxCents","dailyCents"]}},"required":["cashIn","cashOut"]},"livePayerConfigured":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"mode":{"type":"string","enum":["test","live"]}},"required":["id","telegramId","status","fees","limits","mode"]}},"required":["data"]},"example":{"data":{"id":"7f29c80a-e041-4c25-9109-86184211b107","telegramId":"123456789","status":"active","mode":"test","fees":{"cashIn":{"bps":500,"fixedCents":100},"cashOut":{"bps":0,"fixedCents":500}},"limits":{"cashIn":{"minCents":200,"maxCents":100000,"dailyCents":10000000},"cashOut":{"minCents":1000,"maxCents":100000,"dailyCents":5000000}},"livePayerConfigured":false}}}}},"default":{"description":"Falha de validação, autenticação, limite ou processamento.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]},"example":{"error":{"code":"TRANSACTION_LIMIT","message":"Valor fora dos limites por transação."},"requestId":"identificador-da-requisicao"}}}}}}},"/v1/balance":{"get":{"operationId":"get__v1_balance","tags":["Conta"],"summary":"Consultar saldo","description":"Saldo disponível e reservado da sua conta no ambiente da chave utilizada. Todos os valores desta resposta estão em reais (BRL).","parameters":[],"responses":{"200":{"description":"Solicitação processada. Consulte status para saber o resultado financeiro.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"mode":{"type":"string","enum":["test","live"]},"currency":{"const":"BRL"},"available":{"type":"number"},"reserved":{"type":"number"}},"required":["mode","currency","available","reserved"]}},"required":["data"]},"example":{"data":{"mode":"test","currency":"BRL","available":94,"reserved":0}}}}},"default":{"description":"Falha de validação, autenticação, limite ou processamento.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]},"example":{"error":{"code":"TRANSACTION_LIMIT","message":"Valor fora dos limites por transação."},"requestId":"identificador-da-requisicao"}}}}}}},"/v1/payments":{"post":{"operationId":"post__v1_payments","tags":["PIX"],"summary":"Criar pagamento PIX","description":"Envie amount e description. Opcionalmente inclua splits, callbackUrl e webhookSecret conforme os guias. A resposta inclui o código copia e cola e, quando disponível, o QR Code em base64. A criação não significa que o pagamento foi aprovado.","callbacks":{"paymentEvent":{"{$request.body#/callbackUrl}":{"post":{"summary":"Evento assinado do pagamento","description":"POST opcional para callbackUrl. HMAC-SHA256 de timestamp + ponto + corpo original, usando webhookSecret. Sem segredo explícito, derive HMAC-SHA256(API key criadora, texto slacepay:webhook:v1) em hexadecimal. Valide tempo (até cinco minutos) e deduplique pelo ID. Até dez tentativas; responda 2xx após persistir.","security":[],"parameters":[{"name":"X-SlacePay-Signature","in":"header","required":true,"schema":{"type":"string","pattern":"^sha256=[a-f0-9]{64}$"}},{"name":"X-SlacePay-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]+$"}},{"name":"X-SlacePay-Delivery-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"event":{"type":"string","enum":["payment.created","payment.confirmed","payment.failed","payment.refunded"]},"sequence":{"type":"integer","minimum":1},"timestamp":{"type":"string","format":"date-time"},"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"mode":{"type":"string","enum":["test","live"]},"type":{"type":"string","enum":["CASH_IN","CASH_OUT"]},"status":{"type":"string","enum":["PENDING","COMPLETED","FAILED","REFUNDED"]},"submission":{"type":"string","enum":["CREATED","SUBMITTING","ACKNOWLEDGED","UNKNOWN","REJECTED","MANUAL_REVIEW"]},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"fee":{"type":"number"},"netAmount":{"type":"number"},"totalDebit":{"type":"number"},"creditedAmount":{"type":"number","description":"Parcela líquida do titular que consulta o pagamento."},"splitReceived":{"type":"boolean"},"webhookEnabled":{"type":"boolean"},"splits":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"userId":{"type":"string","format":"uuid"},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"percentage":{"type":"number"}},"required":["userId","amount"]}},"description":{"type":"string","minLength":1,"maxLength":255},"copyPaste":{"type":"string"},"qrCodeBase64":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","mode","type","status","submission","amount","fee","description","createdAt","updatedAt"]}},"required":["id","event","sequence","timestamp","data"]}}}},"responses":{"204":{"description":"Evento persistido com sucesso pelo receptor."}}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9_.:-]{8,128}$"},"description":"Reutilize a mesma chave e o mesmo corpo ao repetir a solicitação."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"description":{"type":"string","minLength":1,"maxLength":255},"splits":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","additionalProperties":false,"properties":{"userId":{"type":"string","format":"uuid"},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"percentage":{"type":"number","exclusiveMinimum":0,"maximum":100,"multipleOf":0.01}},"required":["userId"],"oneOf":[{"required":["amount"],"not":{"required":["percentage"]}},{"required":["percentage"],"not":{"required":["amount"]}}]},"description":"Opcional. Destinatários SlacePay: userId UUID e amount em reais OU percentage sobre o líquido. Consulte o guia de split."},"callbackUrl":{"type":"string","format":"uri","maxLength":2048,"description":"Opcional. URL HTTPS pública para eventos do pagamento, porta 443, sem credenciais ou fragmento."},"webhookSecret":{"type":"string","minLength":32,"maxLength":128,"pattern":"^[!-~]+$","description":"Opcional. Segredo HMAC exclusivo do pagamento; exige callbackUrl. Se omitido, derive com a API key conforme o guia de webhooks."}},"required":["amount","description"],"dependentRequired":{"webhookSecret":["callbackUrl"]}},"example":{"amount":100,"description":"Pedido #1043"}}}},"responses":{"201":{"description":"Solicitação processada. Consulte status para saber o resultado financeiro.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"mode":{"type":"string","enum":["test","live"]},"type":{"type":"string","enum":["CASH_IN","CASH_OUT"]},"status":{"type":"string","enum":["PENDING","COMPLETED","FAILED","REFUNDED"]},"submission":{"type":"string","enum":["CREATED","SUBMITTING","ACKNOWLEDGED","UNKNOWN","REJECTED","MANUAL_REVIEW"]},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"fee":{"type":"number"},"netAmount":{"type":"number"},"totalDebit":{"type":"number"},"creditedAmount":{"type":"number","description":"Parcela líquida do titular que consulta o pagamento."},"splitReceived":{"type":"boolean"},"webhookEnabled":{"type":"boolean"},"splits":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"userId":{"type":"string","format":"uuid"},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"percentage":{"type":"number"}},"required":["userId","amount"]}},"description":{"type":"string","minLength":1,"maxLength":255},"copyPaste":{"type":"string"},"qrCodeBase64":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","mode","type","status","submission","amount","fee","description","createdAt","updatedAt"]}},"required":["data"]},"example":{"data":{"id":"7f29c80a-e041-4c25-9109-86184211b107","mode":"test","type":"CASH_IN","status":"PENDING","submission":"ACKNOWLEDGED","amount":100,"fee":6,"netAmount":94,"creditedAmount":94,"webhookEnabled":false,"description":"Pedido #1043","createdAt":"2026-10-22T15:00:00.000Z","updatedAt":"2026-10-22T15:00:00.000Z","copyPaste":"CODIGO_PIX_FORNECIDO_NA_RESPOSTA"}}}}},"202":{"description":"Solicitação pendente ou com confirmação incerta. Consulte o estado; preserve a chave de idempotência.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"mode":{"type":"string","enum":["test","live"]},"type":{"type":"string","enum":["CASH_IN","CASH_OUT"]},"status":{"type":"string","enum":["PENDING","COMPLETED","FAILED","REFUNDED"]},"submission":{"type":"string","enum":["CREATED","SUBMITTING","ACKNOWLEDGED","UNKNOWN","REJECTED","MANUAL_REVIEW"]},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"fee":{"type":"number"},"netAmount":{"type":"number"},"totalDebit":{"type":"number"},"creditedAmount":{"type":"number","description":"Parcela líquida do titular que consulta o pagamento."},"splitReceived":{"type":"boolean"},"webhookEnabled":{"type":"boolean"},"splits":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"userId":{"type":"string","format":"uuid"},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"percentage":{"type":"number"}},"required":["userId","amount"]}},"description":{"type":"string","minLength":1,"maxLength":255},"copyPaste":{"type":"string"},"qrCodeBase64":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","mode","type","status","submission","amount","fee","description","createdAt","updatedAt"]}},"required":["data"]},"example":{"data":{"id":"7f29c80a-e041-4c25-9109-86184211b107","mode":"test","type":"CASH_IN","status":"PENDING","submission":"ACKNOWLEDGED","amount":100,"fee":6,"netAmount":94,"creditedAmount":94,"webhookEnabled":false,"description":"Pedido #1043","createdAt":"2026-10-22T15:00:00.000Z","updatedAt":"2026-10-22T15:00:00.000Z","copyPaste":"CODIGO_PIX_FORNECIDO_NA_RESPOSTA"}}}}},"422":{"description":"Operação recusada ou valor/saldo fora das condições. Pode retornar data com status FAILED ou um objeto error.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"mode":{"type":"string","enum":["test","live"]},"type":{"type":"string","enum":["CASH_IN","CASH_OUT"]},"status":{"type":"string","enum":["PENDING","COMPLETED","FAILED","REFUNDED"]},"submission":{"type":"string","enum":["CREATED","SUBMITTING","ACKNOWLEDGED","UNKNOWN","REJECTED","MANUAL_REVIEW"]},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"fee":{"type":"number"},"netAmount":{"type":"number"},"totalDebit":{"type":"number"},"creditedAmount":{"type":"number","description":"Parcela líquida do titular que consulta o pagamento."},"splitReceived":{"type":"boolean"},"webhookEnabled":{"type":"boolean"},"splits":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"userId":{"type":"string","format":"uuid"},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"percentage":{"type":"number"}},"required":["userId","amount"]}},"description":{"type":"string","minLength":1,"maxLength":255},"copyPaste":{"type":"string"},"qrCodeBase64":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","mode","type","status","submission","amount","fee","description","createdAt","updatedAt"]}},"required":["data"]},{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}]}}}},"default":{"description":"Falha de validação, autenticação, limite ou processamento.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]},"example":{"error":{"code":"TRANSACTION_LIMIT","message":"Valor fora dos limites por transação."},"requestId":"identificador-da-requisicao"}}}}}}},"/v1/payments/{id}":{"get":{"operationId":"get__v1_payments__id_","tags":["PIX"],"summary":"Consultar pagamento","description":"Consulte uma cobrança da sua conta pelo ID SlacePay. Destinatários de split podem consultar sua própria parcela após a confirmação. Acompanhe status até a confirmação; PENDING e submission UNKNOWN não significam aprovação.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Solicitação processada. Consulte status para saber o resultado financeiro.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"mode":{"type":"string","enum":["test","live"]},"type":{"type":"string","enum":["CASH_IN","CASH_OUT"]},"status":{"type":"string","enum":["PENDING","COMPLETED","FAILED","REFUNDED"]},"submission":{"type":"string","enum":["CREATED","SUBMITTING","ACKNOWLEDGED","UNKNOWN","REJECTED","MANUAL_REVIEW"]},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"fee":{"type":"number"},"netAmount":{"type":"number"},"totalDebit":{"type":"number"},"creditedAmount":{"type":"number","description":"Parcela líquida do titular que consulta o pagamento."},"splitReceived":{"type":"boolean"},"webhookEnabled":{"type":"boolean"},"splits":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"userId":{"type":"string","format":"uuid"},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"percentage":{"type":"number"}},"required":["userId","amount"]}},"description":{"type":"string","minLength":1,"maxLength":255},"copyPaste":{"type":"string"},"qrCodeBase64":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","mode","type","status","submission","amount","fee","description","createdAt","updatedAt"]}},"required":["data"]},"example":{"data":{"id":"7f29c80a-e041-4c25-9109-86184211b107","mode":"test","type":"CASH_IN","status":"COMPLETED","submission":"ACKNOWLEDGED","amount":100,"fee":6,"netAmount":94,"creditedAmount":94,"webhookEnabled":false,"description":"Pedido #1043","createdAt":"2026-10-22T15:00:00.000Z","updatedAt":"2026-10-22T15:00:00.000Z","copyPaste":"CODIGO_PIX_FORNECIDO_NA_RESPOSTA"}}}}},"default":{"description":"Falha de validação, autenticação, limite ou processamento.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]},"example":{"error":{"code":"TRANSACTION_LIMIT","message":"Valor fora dos limites por transação."},"requestId":"identificador-da-requisicao"}}}}}}},"/v1/withdrawals":{"post":{"operationId":"post__v1_withdrawals","tags":["Saques"],"summary":"Solicitar saque PIX","description":"O mínimo padrão de saque é R$ 10. O saldo deve cobrir amount + fee. Tipos: CPF com 11 dígitos, CNPJ com 14, EMAIL, TELEFONE no formato +5511999999999 e CHAVE_ALEATORIA em UUID. Principal e taxa são reservados antes do envio. Não solicite um novo saque para substituir uma resposta incerta.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9_.:-]{8,128}$"},"description":"Reutilize a mesma chave e o mesmo corpo ao repetir a solicitação."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"description":{"type":"string","minLength":1,"maxLength":255},"pixKey":{"type":"string","minLength":3,"maxLength":140},"pixKeyType":{"type":"string","enum":["CPF","CNPJ","EMAIL","TELEFONE","CHAVE_ALEATORIA"]}},"required":["amount","description","pixKey","pixKeyType"]},"example":{"amount":100,"description":"Saque solicitado","pixKey":"destinatario@example.com","pixKeyType":"EMAIL"}}}},"responses":{"201":{"description":"Solicitação processada. Consulte status para saber o resultado financeiro.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"mode":{"type":"string","enum":["test","live"]},"type":{"type":"string","enum":["CASH_IN","CASH_OUT"]},"status":{"type":"string","enum":["PENDING","COMPLETED","FAILED","REFUNDED"]},"submission":{"type":"string","enum":["CREATED","SUBMITTING","ACKNOWLEDGED","UNKNOWN","REJECTED","MANUAL_REVIEW"]},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"fee":{"type":"number"},"netAmount":{"type":"number"},"totalDebit":{"type":"number"},"creditedAmount":{"type":"number","description":"Parcela líquida do titular que consulta o pagamento."},"splitReceived":{"type":"boolean"},"webhookEnabled":{"type":"boolean"},"splits":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"userId":{"type":"string","format":"uuid"},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"percentage":{"type":"number"}},"required":["userId","amount"]}},"description":{"type":"string","minLength":1,"maxLength":255},"copyPaste":{"type":"string"},"qrCodeBase64":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","mode","type","status","submission","amount","fee","description","createdAt","updatedAt"]}},"required":["data"]},"example":{"data":{"id":"7f29c80a-e041-4c25-9109-86184211b107","mode":"test","type":"CASH_OUT","status":"PENDING","submission":"ACKNOWLEDGED","amount":100,"fee":5,"description":"Saque solicitado","createdAt":"2026-10-22T15:00:00.000Z","updatedAt":"2026-10-22T15:00:00.000Z","totalDebit":105}}}}},"202":{"description":"Solicitação pendente ou com confirmação incerta. Consulte o estado; preserve a chave de idempotência.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"mode":{"type":"string","enum":["test","live"]},"type":{"type":"string","enum":["CASH_IN","CASH_OUT"]},"status":{"type":"string","enum":["PENDING","COMPLETED","FAILED","REFUNDED"]},"submission":{"type":"string","enum":["CREATED","SUBMITTING","ACKNOWLEDGED","UNKNOWN","REJECTED","MANUAL_REVIEW"]},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"fee":{"type":"number"},"netAmount":{"type":"number"},"totalDebit":{"type":"number"},"creditedAmount":{"type":"number","description":"Parcela líquida do titular que consulta o pagamento."},"splitReceived":{"type":"boolean"},"webhookEnabled":{"type":"boolean"},"splits":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"userId":{"type":"string","format":"uuid"},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"percentage":{"type":"number"}},"required":["userId","amount"]}},"description":{"type":"string","minLength":1,"maxLength":255},"copyPaste":{"type":"string"},"qrCodeBase64":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","mode","type","status","submission","amount","fee","description","createdAt","updatedAt"]}},"required":["data"]},"example":{"data":{"id":"7f29c80a-e041-4c25-9109-86184211b107","mode":"test","type":"CASH_OUT","status":"PENDING","submission":"ACKNOWLEDGED","amount":100,"fee":5,"description":"Saque solicitado","createdAt":"2026-10-22T15:00:00.000Z","updatedAt":"2026-10-22T15:00:00.000Z","totalDebit":105}}}}},"422":{"description":"Operação recusada ou valor/saldo fora das condições. Pode retornar data com status FAILED ou um objeto error.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"mode":{"type":"string","enum":["test","live"]},"type":{"type":"string","enum":["CASH_IN","CASH_OUT"]},"status":{"type":"string","enum":["PENDING","COMPLETED","FAILED","REFUNDED"]},"submission":{"type":"string","enum":["CREATED","SUBMITTING","ACKNOWLEDGED","UNKNOWN","REJECTED","MANUAL_REVIEW"]},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"fee":{"type":"number"},"netAmount":{"type":"number"},"totalDebit":{"type":"number"},"creditedAmount":{"type":"number","description":"Parcela líquida do titular que consulta o pagamento."},"splitReceived":{"type":"boolean"},"webhookEnabled":{"type":"boolean"},"splits":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"userId":{"type":"string","format":"uuid"},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"percentage":{"type":"number"}},"required":["userId","amount"]}},"description":{"type":"string","minLength":1,"maxLength":255},"copyPaste":{"type":"string"},"qrCodeBase64":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","mode","type","status","submission","amount","fee","description","createdAt","updatedAt"]}},"required":["data"]},{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]}]}}}},"default":{"description":"Falha de validação, autenticação, limite ou processamento.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]},"example":{"error":{"code":"TRANSACTION_LIMIT","message":"Valor fora dos limites por transação."},"requestId":"identificador-da-requisicao"}}}}}}},"/v1/withdrawals/{id}":{"get":{"operationId":"get__v1_withdrawals__id_","tags":["Saques"],"summary":"Consultar saque","description":"Consulte um saque da sua conta pelo ID SlacePay. COMPLETED confirma o envio; FAILED indica falha. Em falha definitiva, principal e taxa são devolvidos ao saldo uma vez.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Solicitação processada. Consulte status para saber o resultado financeiro.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"data":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"mode":{"type":"string","enum":["test","live"]},"type":{"type":"string","enum":["CASH_IN","CASH_OUT"]},"status":{"type":"string","enum":["PENDING","COMPLETED","FAILED","REFUNDED"]},"submission":{"type":"string","enum":["CREATED","SUBMITTING","ACKNOWLEDGED","UNKNOWN","REJECTED","MANUAL_REVIEW"]},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"fee":{"type":"number"},"netAmount":{"type":"number"},"totalDebit":{"type":"number"},"creditedAmount":{"type":"number","description":"Parcela líquida do titular que consulta o pagamento."},"splitReceived":{"type":"boolean"},"webhookEnabled":{"type":"boolean"},"splits":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"userId":{"type":"string","format":"uuid"},"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000,"multipleOf":0.01,"description":"Valor em reais, com até duas casas decimais; sujeito aos limites da conta."},"percentage":{"type":"number"}},"required":["userId","amount"]}},"description":{"type":"string","minLength":1,"maxLength":255},"copyPaste":{"type":"string"},"qrCodeBase64":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","mode","type","status","submission","amount","fee","description","createdAt","updatedAt"]}},"required":["data"]},"example":{"data":{"id":"7f29c80a-e041-4c25-9109-86184211b107","mode":"test","type":"CASH_OUT","status":"COMPLETED","submission":"ACKNOWLEDGED","amount":100,"fee":5,"description":"Saque solicitado","createdAt":"2026-10-22T15:00:00.000Z","updatedAt":"2026-10-22T15:00:00.000Z","totalDebit":105}}}}},"default":{"description":"Falha de validação, autenticação, limite ou processamento.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["code","message"]},"requestId":{"type":"string"}},"required":["error","requestId"]},"example":{"error":{"code":"TRANSACTION_LIMIT","message":"Valor fora dos limites por transação."},"requestId":"identificador-da-requisicao"}}}}}}}}}