{"openapi":"3.1.0","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"Vexus Public API","version":"2026-08-21","summary":"API pública de pagamentos, cripto e Split Payment.","description":"Integração HTTPS/JSON para os produtos publicados. Esta especificação descreve somente contratos disponíveis no domínio atual; recursos não publicados aparecem na matriz de disponibilidade e não devem ser inferidos.","license":{"name":"Uso proprietário; acesso sujeito a contrato","identifier":"LicenseRef-Vexus-Proprietary"}},"servers":[{"url":"https://api.hpgroupllc.com.br","description":"Ambiente publicado neste domínio"}],"externalDocs":{"description":"Guia de integração e disponibilidade","url":"https://docs.hpgroupllc.com.br/"},"tags":[{"name":"Status","description":"Disponibilidade técnica sem autenticação."},{"name":"PIX","description":"Entrada, saída, leitura e pagamento de QR Code PIX."},{"name":"Boleto","description":"Emissão, consulta e pagamento de boleto."},{"name":"Cripto","description":"Catálogo, carteiras, endereços, saldos, histórico e envios on-chain."},{"name":"Cartões","description":"Emissão e gestão de cartões virtuais VexusPay."},{"name":"Checkout","description":"Meios, produtos, links e relatório do checkout Vexus."},{"name":"Conta","description":"Consulta de saldo conforme o produto habilitado."},{"name":"White Label","description":"Contrato, plano, taxas, cobrança e status da conta Vexus."},{"name":"Split","description":"Regras, execução, consulta, cancelamento, devolução e relatório de Split Payment."}],"security":[{"ClientId":[],"ClientSecret":[]}],"paths":{"/health/live":{"get":{"tags":["Status"],"summary":"Liveness","description":"Verifica se o processo HTTP está ativo.","operationId":"healthLive","security":[],"responses":{"200":{"description":"Serviço disponível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthLive"}}}},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"503":{"description":"Serviço ainda não está pronto.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthLive"}}}}}}},"/health/ready":{"get":{"tags":["Status"],"summary":"Readiness","description":"Valida banco, migrações e dependências internas necessárias para receber tráfego.","operationId":"healthReady","security":[],"responses":{"200":{"description":"Serviço disponível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthReady"}}}},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"503":{"description":"Serviço ainda não está pronto.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthReady"}}}}}}},"/api/v1/cashin":{"post":{"tags":["PIX"],"summary":"Criar cobrança PIX","description":"Cria uma cobrança PIX dinâmica.","operationId":"createPixCashIn","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PixCashInRequest"},"example":{"amount":25.9,"payer_name":"Cliente de Exemplo","payer_document":"52998224725","payer_email":"cliente@example.com","description":"Pedido 1024","external_id":"pedido-1024"}}}},"x-vexus-scope":"cashin","x-vexus-availability":"PUBLISHED"}},"/api/v1/cashout":{"post":{"tags":["PIX"],"summary":"Enviar PIX","description":"Envia um PIX para a chave informada, sujeito a saldo, produto e limites da conta.","operationId":"createPixCashOut","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PixCashOutRequest"},"example":{"amount":20,"pix_key":"<chave-pix-destino>","pix_key_type":"random","description":"Repasse"}}}},"x-vexus-scope":"cashout","x-vexus-availability":"PUBLISHED"}},"/api/v1/pix/qr/decode":{"post":{"tags":["PIX"],"summary":"Ler QR Code PIX","description":"Valida e decodifica um payload EMV PIX sem movimentar saldo.","operationId":"decodePixQr","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PixQrRequest"},"example":{"payload":"00020101021226810014br.gov.bcb.pix2559https://example.invalid/pix/cobranca-exemplo520400005303986540539.905802BR5905VEXUS6009SAO PAULO62070503***6304ABCD"}}}},"x-vexus-scope":"cashout","x-vexus-availability":"PUBLISHED"}},"/api/v1/pix/qr/pay":{"post":{"tags":["PIX"],"summary":"Pagar QR Code PIX","description":"Paga um QR Code PIX após validação do payload e dos limites.","operationId":"payPixQr","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PixQrPaymentRequest"},"example":{"payload":"00020101021226810014br.gov.bcb.pix2559https://example.invalid/pix/cobranca-exemplo520400005303986540539.905802BR5905VEXUS6009SAO PAULO62070503***6304ABCD","amount":39.9,"description":"Fornecedor"}}}},"x-vexus-scope":"cashout","x-vexus-availability":"PUBLISHED"}},"/api/v1/boleto/issue":{"post":{"tags":["Boleto"],"summary":"Emitir boleto","description":"Emite uma cobrança por boleto para um produto habilitado.","operationId":"issueBoleto","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoletoIssueRequest"},"example":{"product_id":"00000000-0000-4000-8000-000000000001","amount":99.9,"buyer_name":"Cliente de Exemplo","buyer_email":"cliente@example.com","buyer_cpf":"52998224725","buyer_address":{"zip_code":"01001000","street_name":"Praça da Sé","street_number":"100","neighborhood":"Sé","city":"São Paulo","state":"SP"}}}}},"x-vexus-scope":"boleto","x-vexus-availability":"PUBLISHED"}},"/api/v1/boleto/info":{"post":{"tags":["Boleto"],"summary":"Consultar boleto","description":"Consulta os dados de um boleto sem movimentar saldo.","operationId":"getBoletoInfo","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoletoInfoRequest"},"example":{"billetCode":"00000000000000000000000000000000000000000000"}}}},"x-vexus-scope":"boleto","x-vexus-availability":"PUBLISHED"}},"/api/v1/boleto/pay":{"post":{"tags":["Boleto"],"summary":"Pagar boleto","description":"Paga um boleto após a aplicação validar código, beneficiário, saldo e limites.","operationId":"payBoleto","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoletoPaymentRequest"},"example":{"billetCode":"00000000000000000000000000000000000000000000","amount":149.9,"beneficiary_name":"Empresa de Exemplo"}}}},"x-vexus-scope":"boleto","x-vexus-availability":"PUBLISHED"}},"/api/v1/crypto/assets":{"get":{"tags":["Cripto"],"summary":"Listar ativos cripto","description":"Retorna somente moedas e redes habilitadas em produção, incluindo capacidade de depósito, envio, casas decimais, confirmações e ícone.","operationId":"listCryptoAssets","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"cashin","x-vexus-availability":"PUBLISHED"}},"/api/v1/crypto/wallets":{"get":{"tags":["Cripto"],"summary":"Listar carteiras cripto","description":"Retorna as carteiras da conta, saldo disponível/bloqueado, rede, ativo e disponibilidade de envio.","operationId":"listCryptoWallets","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"cashin","x-vexus-availability":"PUBLISHED"},"post":{"tags":["Cripto"],"summary":"Criar ou obter carteira","description":"Cria de forma idempotente uma carteira para o par ativo/rede. Chamadas repetidas retornam a mesma carteira e o monitoramento automático já fica ativo.","operationId":"createCryptoWallet","responses":{"201":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"},"200":{"description":"Carteira já existente retornada sem criar duplicidade.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CryptoWalletCreateRequest"},"example":{"asset":"USDT","network":"BSC_BNB"}}}},"x-vexus-scope":"cashin","x-vexus-availability":"PUBLISHED"}},"/api/v1/crypto/wallets/{walletId}/address":{"get":{"tags":["Cripto"],"summary":"Consultar endereço de recebimento","description":"Revela o endereço e, quando aplicável, memo/tag. Depósitos são detectados, confirmados e creditados automaticamente.","operationId":"getCryptoWalletAddress","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"cashin","x-vexus-availability":"PUBLISHED","parameters":[{"name":"walletId","in":"path","required":true,"description":"UUID da carteira","schema":{"$ref":"#/components/schemas/Uuid"}}]}},"/api/v1/crypto/transactions":{"get":{"tags":["Cripto"],"summary":"Listar movimentações cripto","description":"Lista depósitos e envios da conta, com status, confirmações, valores, taxas e hash blockchain quando disponível.","operationId":"listCryptoTransactions","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"cashin","x-vexus-availability":"PUBLISHED"}},"/api/v1/crypto/withdrawals/preview":{"post":{"tags":["Cripto"],"summary":"Calcular envio cripto","description":"Valida destino e saldo e retorna uma cotação de 60 segundos com taxa de rede, taxa VexusPay e débito total. Não movimenta saldo.","operationId":"previewCryptoWithdrawal","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CryptoWithdrawalPreviewRequest"},"example":{"wallet_id":"00000000-0000-4000-8000-000000000001","amount":"1.00","destination":"0x1111111111111111111111111111111111111111"}}}},"x-vexus-scope":"cashout","x-vexus-availability":"PUBLISHED"}},"/api/v1/crypto/withdrawals":{"post":{"tags":["Cripto"],"summary":"Confirmar envio cripto","description":"Confirma uma cotação válida. A reserva, assinatura local KMS, transmissão e confirmação blockchain seguem automaticamente. Nunca reenvie com outra chave enquanto o resultado estiver pendente.","operationId":"createCryptoWithdrawal","responses":{"202":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CryptoWithdrawalCreateRequest"},"example":{"quote_id":"00000000-0000-4000-8000-000000000002","destination":"0x1111111111111111111111111111111111111111"}}}},"x-vexus-scope":"cashout","x-vexus-availability":"PUBLISHED"}},"/api/v1/crypto/withdrawals/{withdrawalId}":{"get":{"tags":["Cripto"],"summary":"Consultar envio cripto","description":"Retorna estado, hash blockchain, valores e taxas sem expor o endereço completo de destino.","operationId":"getCryptoWithdrawal","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"cashout","x-vexus-availability":"PUBLISHED","parameters":[{"name":"withdrawalId","in":"path","required":true,"description":"UUID do envio","schema":{"$ref":"#/components/schemas/Uuid"}}]}},"/api/v1/crypto/swaps/quote":{"post":{"tags":["Cripto"],"summary":"Cotar swap cripto","description":"Consulta uma cotação real entre duas carteiras da mesma rede. A resposta sempre informa execution_ready=false: não há execução on-chain publicada nesta rota.","operationId":"quoteCryptoSwap","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CryptoSwapQuoteRequest"},"example":{"source_wallet_id":"00000000-0000-4000-8000-000000000001","target_wallet_id":"00000000-0000-4000-8000-000000000002","amount":"10.00","slippage_bps":50}}}},"x-vexus-scope":"cashout","x-vexus-availability":"PUBLISHED"}},"/api/v1/crypto/conversions/brl-usdt/preview":{"post":{"tags":["Cripto"],"summary":"Prévia BRL para USDT BEP20","description":"Calcula valor estimado, taxa, saldo necessário e destino. Não cria PIX nem movimenta saldo.","operationId":"previewBrlUsdtConversion","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrlUsdtConversionPreviewRequest"},"example":{"amount":"100.00","destination_mode":"VEXUS_WALLET"}}}},"x-vexus-scope":"cashout","x-vexus-availability":"PUBLISHED"}},"/api/v1/crypto/conversions/brl-usdt":{"post":{"tags":["Cripto"],"summary":"Confirmar BRL para USDT BEP20","description":"Inicia a conversão pelo PIX de saída configurado para a conta. Exige PIN da conta e Idempotency-Key; jamais troque a chave ao repetir uma tentativa pendente.","operationId":"createBrlUsdtConversion","responses":{"202":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrlUsdtConversionRequest"},"example":{"amount":"100.00","destination_mode":"VEXUS_WALLET","pin":"1234"}}}},"x-vexus-scope":"cashout","x-vexus-availability":"PUBLISHED"}},"/api/v1/crypto/conversions/brl-usdt/{conversionId}":{"get":{"tags":["Cripto"],"summary":"Consultar conversão BRL para USDT","description":"Retorna o estado conciliado da conversão e o valor entregue quando disponível.","operationId":"getBrlUsdtConversion","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"cashout","x-vexus-availability":"PUBLISHED","parameters":[{"name":"conversionId","in":"path","required":true,"description":"UUID da conversão","schema":{"$ref":"#/components/schemas/Uuid"}}]}},"/api/v1/cards/products":{"get":{"tags":["Cartões"],"summary":"Listar produtos de cartão","description":"Retorna os tipos de cartão virtual habilitados para a conta Vexus.","operationId":"listCardProducts","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"cards.read","x-vexus-availability":"PUBLISHED","x-vexus-product":"virtual.cards","x-vexus-authorization":"explicit"}},"/api/v1/cards/rates":{"get":{"tags":["Cartões"],"summary":"Consultar taxas de cartões","description":"Retorna as taxas e limites publicados para cartões virtuais Vexus.","operationId":"getVirtualCardRates","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"cards.read","x-vexus-availability":"PUBLISHED","x-vexus-product":"virtual.cards","x-vexus-authorization":"explicit"}},"/api/v1/cards/webhooks":{"get":{"tags":["Cartões"],"summary":"Listar webhooks de OTP","description":"Lista os endpoints HTTPS cadastrados para receber eventos de OTP de cartão virtual.","operationId":"listCardOtpWebhooks","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"cards.read","x-vexus-availability":"PUBLISHED","x-vexus-product":"virtual.cards","x-vexus-authorization":"explicit"},"post":{"tags":["Cartões"],"summary":"Configurar webhook de OTP","description":"Cadastra um endpoint HTTPS para receber eventos assinados de OTP de cartão virtual.","operationId":"createCardOtpWebhook","responses":{"201":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardWebhookCreateRequest"},"example":{"label":"Meu endpoint OTP","url":"https://example.com/vexus/card-otp"}}}},"x-vexus-scope":"cards.write","x-vexus-availability":"PUBLISHED","x-vexus-product":"virtual.cards","x-vexus-authorization":"explicit"}},"/api/v1/cards":{"get":{"tags":["Cartões"],"summary":"Listar cartões virtuais","description":"Lista os cartões virtuais pertencentes à conta autenticada.","operationId":"listCards","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"cards.read","x-vexus-availability":"PUBLISHED","x-vexus-product":"virtual.cards","x-vexus-authorization":"explicit"},"post":{"tags":["Cartões"],"summary":"Emitir cartão virtual","description":"Emite um cartão virtual VexusPay para o produto e valor informados.","operationId":"createVirtualCard","responses":{"201":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VexusCardIssueRequest"},"example":{"product_code":"vexus_international","amount":"10.00","name_on_card":"CLIENTE EXEMPLO"}}}},"x-vexus-scope":"cards.write","x-vexus-availability":"PUBLISHED","x-vexus-product":"virtual.cards","x-vexus-authorization":"explicit"}},"/api/v1/cards/{cardId}":{"get":{"tags":["Cartões"],"summary":"Consultar cartão virtual","description":"Retorna o estado e os dados não sensíveis do cartão virtual.","operationId":"getVirtualCard","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"cards.read","x-vexus-availability":"PUBLISHED","x-vexus-product":"virtual.cards","x-vexus-authorization":"explicit","parameters":[{"name":"cardId","in":"path","required":true,"description":"UUID do cartão VexusPay","schema":{"$ref":"#/components/schemas/Uuid"}}]},"delete":{"tags":["Cartões"],"summary":"Cancelar cartão virtual","description":"Cancela o cartão virtual. A operação não pode ser desfeita.","operationId":"cancelVirtualCard","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"name":"cardId","in":"path","required":true,"description":"UUID do cartão VexusPay","schema":{"$ref":"#/components/schemas/Uuid"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmptyObject"},"example":{}}}},"x-vexus-scope":"cards.write","x-vexus-availability":"PUBLISHED","x-vexus-product":"virtual.cards","x-vexus-authorization":"explicit"}},"/api/v1/cards/{cardId}/fund":{"post":{"tags":["Cartões"],"summary":"Recarregar cartão virtual","description":"Adiciona saldo ao cartão virtual usando a conta Vexus.","operationId":"fundVirtualCard","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"name":"cardId","in":"path","required":true,"description":"UUID do cartão VexusPay","schema":{"$ref":"#/components/schemas/Uuid"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VexusCardFundRequest"},"example":{"amount":"10.00"}}}},"x-vexus-scope":"cards.write","x-vexus-availability":"PUBLISHED","x-vexus-product":"virtual.cards","x-vexus-authorization":"explicit"}},"/api/v1/cards/{cardId}/freeze":{"post":{"tags":["Cartões"],"summary":"Congelar cartão virtual","description":"Congela temporariamente o cartão virtual.","operationId":"freezeVirtualCard","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"name":"cardId","in":"path","required":true,"description":"UUID do cartão VexusPay","schema":{"$ref":"#/components/schemas/Uuid"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmptyObject"},"example":{}}}},"x-vexus-scope":"cards.write","x-vexus-availability":"PUBLISHED","x-vexus-product":"virtual.cards","x-vexus-authorization":"explicit"}},"/api/v1/cards/{cardId}/unfreeze":{"post":{"tags":["Cartões"],"summary":"Descongelar cartão virtual","description":"Descongela o cartão virtual.","operationId":"unfreezeVirtualCard","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"name":"cardId","in":"path","required":true,"description":"UUID do cartão VexusPay","schema":{"$ref":"#/components/schemas/Uuid"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmptyObject"},"example":{}}}},"x-vexus-scope":"cards.write","x-vexus-availability":"PUBLISHED","x-vexus-product":"virtual.cards","x-vexus-authorization":"explicit"}},"/api/v1/cards/{cardId}/transactions":{"get":{"tags":["Cartões"],"summary":"Listar transações do cartão","description":"Lista as transações do cartão virtual sem expor dados sensíveis.","operationId":"listVirtualCardTransactions","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"cards.read","x-vexus-availability":"PUBLISHED","x-vexus-product":"virtual.cards","x-vexus-authorization":"explicit","parameters":[{"name":"cardId","in":"path","required":true,"description":"UUID do cartão VexusPay","schema":{"$ref":"#/components/schemas/Uuid"}}]}},"/api/v1/checkout/methods":{"get":{"tags":["Checkout"],"summary":"Listar meios de checkout","description":"Retorna somente meios de pagamento homologados e disponíveis para a conta autenticada.","operationId":"listCheckoutMethods","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"checkout","x-vexus-availability":"PUBLISHED","x-vexus-product":"checkout"}},"/api/v1/checkout/report":{"get":{"tags":["Checkout"],"summary":"Consultar relatório de checkout","description":"Retorna métricas agregadas dos links e pedidos pertencentes à conta autenticada.","operationId":"getCheckoutReport","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"checkout","x-vexus-availability":"PUBLISHED","x-vexus-product":"checkout"}},"/api/v1/checkout/products":{"get":{"tags":["Checkout"],"summary":"Listar produtos de checkout","description":"Lista produtos ativos e arquivados do catálogo da conta.","operationId":"listCheckoutProducts","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"checkout","x-vexus-availability":"PUBLISHED","x-vexus-product":"checkout"},"post":{"tags":["Checkout"],"summary":"Criar produto de checkout","description":"Cria um produto no catálogo. Meios que exigem identificação de produto externo só podem ser usados quando provider_product_id for informado.","operationId":"createCheckoutProduct","responses":{"201":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutProductRequest"},"example":{"name":"Produto de exemplo","price":"49.90","currency":"BRL","payment_methods":["PIX"]}}}},"x-vexus-scope":"checkout","x-vexus-availability":"PUBLISHED","x-vexus-product":"checkout"}},"/api/v1/checkout/products/{productId}":{"get":{"tags":["Checkout"],"summary":"Consultar produto de checkout","description":"Retorna o produto do catálogo pertencente à conta autenticada.","operationId":"getCheckoutProduct","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"checkout","x-vexus-availability":"PUBLISHED","x-vexus-product":"checkout","parameters":[{"name":"productId","in":"path","required":true,"description":"ID numérico do produto","schema":{"type":"integer","minimum":1}}]},"put":{"tags":["Checkout"],"summary":"Atualizar produto de checkout","description":"Atualiza uma versão do produto. Envie version retornado na leitura para impedir sobrescrita concorrente.","operationId":"updateCheckoutProduct","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"name":"productId","in":"path","required":true,"description":"ID numérico do produto","schema":{"type":"integer","minimum":1}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutProductRequest"},"example":{"name":"Produto atualizado","price":"59.90","currency":"BRL","payment_methods":["PIX"],"version":1}}}},"x-vexus-scope":"checkout","x-vexus-availability":"PUBLISHED","x-vexus-product":"checkout"},"delete":{"tags":["Checkout"],"summary":"Arquivar produto de checkout","description":"Arquiva o produto e os links ativos associados. A ação exige Idempotency-Key e não aceita corpo.","operationId":"archiveCheckoutProduct","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"name":"productId","in":"path","required":true,"description":"ID numérico do produto","schema":{"type":"integer","minimum":1}},{"$ref":"#/components/parameters/IdempotencyKey"}],"x-vexus-scope":"checkout","x-vexus-availability":"PUBLISHED","x-vexus-product":"checkout"}},"/api/v1/checkout/links":{"get":{"tags":["Checkout"],"summary":"Listar links de checkout","description":"Lista links de pagamento, estado e métricas da conta autenticada.","operationId":"listCheckoutLinks","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"checkout","x-vexus-availability":"PUBLISHED","x-vexus-product":"checkout"},"post":{"tags":["Checkout"],"summary":"Criar link de checkout","description":"Cria um link avulso ou associado a produto. O payment_path retornado deve ser combinado com seu domínio Vexus.","operationId":"createCheckoutLink","responses":{"201":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutLinkRequest"},"example":{"title":"Link de exemplo","product_id":1,"payment_methods":["PIX"]}}}},"x-vexus-scope":"checkout","x-vexus-availability":"PUBLISHED","x-vexus-product":"checkout"}},"/api/v1/checkout/links/{linkId}":{"get":{"tags":["Checkout"],"summary":"Consultar link de checkout","description":"Retorna a configuração e o payment_path do link pertencente à conta autenticada.","operationId":"getCheckoutLink","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"checkout","x-vexus-availability":"PUBLISHED","x-vexus-product":"checkout","parameters":[{"name":"linkId","in":"path","required":true,"description":"ID numérico do link","schema":{"type":"integer","minimum":1}}]},"put":{"tags":["Checkout"],"summary":"Atualizar link de checkout","description":"Atualiza uma versão do link. Envie version retornado na leitura para impedir sobrescrita concorrente.","operationId":"updateCheckoutLink","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"name":"linkId","in":"path","required":true,"description":"ID numérico do link","schema":{"type":"integer","minimum":1}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutLinkRequest"},"example":{"title":"Link atualizado","product_id":1,"payment_methods":["PIX"],"version":1}}}},"x-vexus-scope":"checkout","x-vexus-availability":"PUBLISHED","x-vexus-product":"checkout"}},"/api/v1/checkout/links/{linkId}/archive":{"post":{"tags":["Checkout"],"summary":"Arquivar link de checkout","description":"Arquiva o link e impede novos pagamentos. Exige Idempotency-Key e não aceita corpo.","operationId":"archiveCheckoutLink","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"name":"linkId","in":"path","required":true,"description":"ID numérico do link","schema":{"type":"integer","minimum":1}},{"$ref":"#/components/parameters/IdempotencyKey"}],"x-vexus-scope":"checkout","x-vexus-availability":"PUBLISHED","x-vexus-product":"checkout"}},"/api/v1/checkout/links/{linkId}/cancel":{"post":{"tags":["Checkout"],"summary":"Cancelar link de checkout","description":"Cancela o link com motivo auditável e impede novos pagamentos. Exige Idempotency-Key.","operationId":"cancelCheckoutLink","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"name":"linkId","in":"path","required":true,"description":"ID numérico do link","schema":{"type":"integer","minimum":1}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutCancelRequest"},"example":{"reason":"Cancelamento solicitado pelo integrador."}}}},"x-vexus-scope":"checkout","x-vexus-availability":"PUBLISHED","x-vexus-product":"checkout"}},"/api/v1/account/fees":{"get":{"tags":["Conta"],"summary":"Taxas da conta","description":"Retorna as taxas comerciais efetivas para PIX, boleto, cartão, cartão virtual, transferência interna e regras por ativo/rede cripto.","operationId":"getAccountFees","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"account.read","x-vexus-product":"account","x-vexus-authorization":"explicit"}},"/api/v1/account/limits":{"get":{"tags":["Conta"],"summary":"Limites da conta","description":"Retorna os limites financeiros efetivos da conta em BRL para agregado, PIX, boleto e transferência interna.","operationId":"getAccountLimits","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"account.read","x-vexus-product":"account","x-vexus-authorization":"explicit"}},"/api/v1/balance":{"post":{"tags":["Conta"],"summary":"Consultar saldo","description":"Consulta o saldo exposto pelo contrato da conta. Envie um objeto JSON vazio.","operationId":"getBalance","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmptyObject"},"example":{}}}},"x-vexus-scope":"cashin","x-vexus-availability":"PUBLISHED"}},"/api/v1/white-label":{"get":{"tags":["White Label"],"summary":"Consultar White Label","description":"Retorna, em uma única resposta, a situação do contrato, plano, adicionais, cobrança, taxas e produtos efetivamente habilitados.","operationId":"getWhiteLabel","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"account.read","x-vexus-product":"account","x-vexus-availability":"PUBLISHED"}},"/api/v1/white-label/plan":{"get":{"tags":["White Label"],"summary":"Consultar plano White Label","description":"Retorna o plano e os adicionais contratados pela conta autenticada.","operationId":"getWhiteLabelPlan","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"account.read","x-vexus-product":"account","x-vexus-availability":"PUBLISHED"}},"/api/v1/white-label/fees":{"get":{"tags":["White Label"],"summary":"Consultar taxas White Label","description":"Retorna as taxas comerciais do plano, incluindo PIX, boleto, cartão virtual e regras por ativo/rede cripto.","operationId":"getWhiteLabelFees","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"account.read","x-vexus-product":"account","x-vexus-availability":"PUBLISHED"}},"/api/v1/white-label/billing":{"get":{"tags":["White Label"],"summary":"Consultar cobrança White Label","description":"Retorna mensalidade, entrada, valor pendente, vencimento e situação de acesso. Não cria cobrança nem movimenta saldo.","operationId":"getWhiteLabelBilling","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"account.read","x-vexus-product":"account","x-vexus-availability":"PUBLISHED"}},"/api/v1/white-label/status":{"get":{"tags":["White Label"],"summary":"Consultar status White Label","description":"Retorna somente a situação do contrato e se operações financeiras pela API estão liberadas.","operationId":"getWhiteLabelStatus","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"account.read","x-vexus-product":"account","x-vexus-availability":"PUBLISHED"}},"/api/v1/splits/rules":{"get":{"tags":["Split"],"summary":"Listar regras de split","description":"Lista as regras pertencentes à conta autenticada.","operationId":"listSplitRules","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"split","x-vexus-availability":"PUBLISHED"},"post":{"tags":["Split"],"summary":"Criar regra de split","description":"Cria uma regra versionada por percentuais ou valores fixos.","operationId":"createSplitRule","responses":{"201":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SplitRuleRequest"},"example":{"name":"Parceiros","mode":"PERCENTAGE","currency":"BRL","participants":[{"handle":"conta-parceira","percentage":"20.00"}]}}}},"x-vexus-scope":"split","x-vexus-availability":"PUBLISHED"}},"/api/v1/splits/rules/{ruleId}":{"put":{"tags":["Split"],"summary":"Revisar regra de split","description":"Arquiva a versão anterior e cria uma nova versão da regra.","operationId":"reviseSplitRule","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"name":"ruleId","in":"path","required":true,"description":"UUID da regra","schema":{"$ref":"#/components/schemas/Uuid"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SplitRuleRequest"},"example":{"name":"Parceiros v2","mode":"PERCENTAGE","currency":"BRL","participants":[{"handle":"conta-parceira","percentage":"25.00"}]}}}},"x-vexus-scope":"split","x-vexus-availability":"PUBLISHED"},"delete":{"tags":["Split"],"summary":"Arquivar regra de split","description":"Arquiva a regra da conta. Esta operação não aceita corpo.","operationId":"archiveSplitRule","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"split","x-vexus-availability":"PUBLISHED","parameters":[{"name":"ruleId","in":"path","required":true,"description":"UUID da regra","schema":{"$ref":"#/components/schemas/Uuid"}}]}},"/api/v1/splits":{"post":{"tags":["Split"],"summary":"Criar split","description":"Cria a operação financeira e suas alocações a partir de uma regra ativa.","operationId":"createSplit","responses":{"201":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SplitCreateRequest"},"example":{"rule_id":"00000000-0000-4000-8000-000000000001","amount":100,"payer":{"name":"Cliente de Exemplo","document":"52998224725","email":"cliente@example.com"}}}}},"x-vexus-scope":"split","x-vexus-availability":"PUBLISHED"}},"/api/v1/splits/{splitId}":{"get":{"tags":["Split"],"summary":"Consultar split","description":"Retorna a operação e as alocações visíveis à conta proprietária.","operationId":"getSplit","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"split","x-vexus-availability":"PUBLISHED","parameters":[{"name":"splitId","in":"path","required":true,"description":"UUID do split","schema":{"$ref":"#/components/schemas/Uuid"}}]}},"/api/v1/splits/{splitId}/cancel":{"post":{"tags":["Split"],"summary":"Cancelar split","description":"Cancela um split somente quando o estado financeiro permitir. Não aceita corpo.","operationId":"cancelSplit","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"split","x-vexus-availability":"PUBLISHED","parameters":[{"name":"splitId","in":"path","required":true,"description":"UUID do split","schema":{"$ref":"#/components/schemas/Uuid"}}]}},"/api/v1/splits/{splitId}/refund":{"post":{"tags":["Split"],"summary":"Solicitar devolução do split","description":"Solicita devolução parcial ou total; uma resposta 202 indica processamento assíncrono.","operationId":"refundSplit","responses":{"202":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"},"200":{"description":"Devolução confirmada.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}}},"parameters":[{"name":"splitId","in":"path","required":true,"description":"UUID do split","schema":{"$ref":"#/components/schemas/Uuid"}},{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SplitRefundRequest"},"example":{"amount":25,"comment":"Devolução parcial solicitada pelo cliente"}}}},"x-vexus-scope":"split","x-vexus-availability":"PUBLISHED"}},"/api/v1/splits/report":{"get":{"tags":["Split"],"summary":"Relatório de participante","description":"Retorna itens da conta autenticada no intervalo UTC informado.","operationId":"getSplitReport","responses":{"200":{"description":"Operação aceita.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/BadRequest"},"415":{"$ref":"#/components/responses/BadRequest"},"422":{"$ref":"#/components/responses/Unprocessable"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-vexus-scope":"split","x-vexus-availability":"PUBLISHED","parameters":[{"name":"from","in":"query","required":false,"description":"Início inclusivo em YYYY-MM-DD.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Fim inclusivo em YYYY-MM-DD.","schema":{"type":"string","format":"date"}}]}}},"webhooks":{"checkoutOrderStatusChanged":{"post":{"summary":"Mudança de status de pedido do checkout","description":"Enviado apenas para endpoint HTTPS ativo, configurado no painel e inscrito em `checkout.order.status_changed`. Valide a assinatura sobre o corpo bruto antes de desserializar.","operationId":"receiveCheckoutOrderStatusChanged","security":[],"parameters":[{"name":"X-Vexus-Event","in":"header","required":true,"description":"checkout.order.status_changed","schema":{"type":"string"}},{"name":"X-Vexus-Delivery","in":"header","required":true,"description":"UUID estável da entrega","schema":{"type":"string"}},{"name":"X-Vexus-Timestamp","in":"header","required":true,"description":"Unix timestamp usado na assinatura","schema":{"type":"string"}},{"name":"X-Vexus-Signature","in":"header","required":true,"description":"v1=<HMAC-SHA256(timestamp.corpo-bruto)>","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Chave estável em todas as tentativas","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutWebhookEvent"}}}},"responses":{"200":{"description":"Qualquer resposta 2xx confirma a entrega."},"default":{"description":"408, 409, 425, 429 e 5xx são retentáveis; outros 4xx são definitivos."}}}}},"components":{"securitySchemes":{"ClientId":{"type":"apiKey","in":"header","name":"Apikey","description":"Identificador da credencial. `X-Client-Id` é aceito como alias de compatibilidade."},"ClientSecret":{"type":"apiKey","in":"header","name":"X-Client-Secret","description":"Segredo exibido uma única vez; use somente no servidor."}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"description":"Chave estável da tentativa lógica. Reutilize somente com corpo idêntico.","schema":{"type":"string","minLength":8,"maxLength":100},"example":"pedido-1024-tentativa-logica-1"}},"headers":{"RateLimitLimit":{"description":"Máximo efetivo da janela aplicável.","schema":{"type":"integer"}},"RateLimitRemaining":{"description":"Quantidade restante na janela.","schema":{"type":"integer"}},"RateLimitReset":{"description":"Unix timestamp de reinício da janela.","schema":{"type":"integer"}},"RetryAfter":{"description":"Segundos antes de nova tentativa.","schema":{"type":"integer"}}},"responses":{"BadRequest":{"description":"JSON ou solicitação inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"Unauthorized":{"description":"Credencial ausente, expirada ou inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"Forbidden":{"description":"Escopo, produto, IP ou User-Agent não autorizado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"Conflict":{"description":"Conflito de estado ou de idempotência.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"Unprocessable":{"description":"Campo, saldo, limite ou regra de domínio inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"RateLimited":{"description":"Política de requisições, valor ou frequência excedida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"}}},"ServerError":{"description":"Falha interna sanitizada; use o correlationId no suporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"Unavailable":{"description":"Dependência necessária indisponível; consulte retryable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"MethodNotAllowed":{"description":"Método HTTP não permitido para este recurso.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"schemas":{"MoneyDecimal":{"type":"number","format":"decimal","exclusiveMinimum":0,"maximum":1000000,"examples":[25.9]},"MinorAmount":{"type":"string","pattern":"^[0-9]+$","description":"Valor inteiro na menor unidade da moeda.","examples":["2590"]},"Uuid":{"type":"string","format":"uuid"},"EmptyObject":{"type":"object","additionalProperties":false},"PixCashInRequest":{"type":"object","additionalProperties":false,"required":["amount","payer_name","payer_document","payer_email"],"properties":{"amount":{"$ref":"#/components/schemas/MoneyDecimal"},"payer_name":{"type":"string","maxLength":150,"description":"Nome do pagador."},"payer_document":{"type":"string","pattern":"^\\d{11}(?:\\d{3})?$"},"payer_email":{"type":"string","format":"email","maxLength":150},"description":{"type":"string","maxLength":255,"description":"Descrição segura para conciliação."},"external_id":{"type":"string","maxLength":120,"description":"Referência única do integrador."}}},"PixCashOutRequest":{"type":"object","additionalProperties":false,"required":["amount","pix_key","pix_key_type"],"properties":{"amount":{"$ref":"#/components/schemas/MoneyDecimal"},"pix_key":{"type":"string","maxLength":180,"description":"Chave PIX do destinatário."},"pix_key_type":{"type":"string","enum":["cpf","cnpj","email","phone","random"]},"description":{"type":"string","maxLength":255,"description":"Descrição da transferência."}}},"PixPayload":{"type":"string","minLength":20,"maxLength":10000},"PixQrRequest":{"type":"object","additionalProperties":false,"required":["payload"],"properties":{"payload":{"$ref":"#/components/schemas/PixPayload"}}},"PixQrPaymentRequest":{"type":"object","additionalProperties":false,"required":["payload","amount"],"properties":{"payload":{"$ref":"#/components/schemas/PixPayload"},"amount":{"$ref":"#/components/schemas/MoneyDecimal"},"description":{"type":"string","maxLength":255,"description":"Descrição do pagamento."}}},"Address":{"type":"object","additionalProperties":false,"required":["zip_code","street_name","street_number","neighborhood","city","state"],"properties":{"zip_code":{"type":"string","pattern":"^\\d{8}$"},"street_name":{"type":"string","maxLength":150,"description":"Logradouro."},"street_number":{"type":"string","maxLength":30,"description":"Número."},"neighborhood":{"type":"string","maxLength":100,"description":"Bairro."},"city":{"type":"string","maxLength":100,"description":"Cidade."},"state":{"type":"string","pattern":"^[A-Z]{2}$"}}},"BoletoIssueRequest":{"type":"object","additionalProperties":true,"required":["product_id","amount","buyer_name","buyer_email","buyer_cpf","buyer_address"],"properties":{"product_id":{"$ref":"#/components/schemas/Uuid"},"amount":{"$ref":"#/components/schemas/MoneyDecimal"},"buyer_name":{"type":"string","maxLength":150,"description":"Nome do pagador."},"buyer_email":{"type":"string","format":"email"},"buyer_cpf":{"type":"string","pattern":"^\\d{11}$"},"buyer_address":{"$ref":"#/components/schemas/Address"},"description":{"type":"string","maxLength":255,"description":"Descrição da cobrança."}}},"BoletoCode":{"type":"string","pattern":"^(?:\\d{44}|\\d{46}|\\d{47}|\\d{48})$"},"BoletoInfoRequest":{"type":"object","additionalProperties":false,"required":["billetCode"],"properties":{"billetCode":{"$ref":"#/components/schemas/BoletoCode"}}},"BoletoPaymentRequest":{"type":"object","additionalProperties":false,"required":["billetCode","amount","beneficiary_name"],"properties":{"billetCode":{"$ref":"#/components/schemas/BoletoCode"},"amount":{"$ref":"#/components/schemas/MoneyDecimal"},"beneficiary_name":{"type":"string","maxLength":150,"description":"Beneficiário confirmado pelo integrador."}}},"CryptoWalletCreateRequest":{"type":"object","additionalProperties":false,"required":["asset","network"],"properties":{"asset":{"type":"string","pattern":"^[A-Z0-9]{2,16}$","examples":["USDT"]},"network":{"type":"string","pattern":"^[A-Z0-9_]{2,40}$","examples":["BSC_BNB"]}}},"CryptoWithdrawalPreviewRequest":{"type":"object","additionalProperties":false,"required":["wallet_id","amount","destination"],"properties":{"wallet_id":{"$ref":"#/components/schemas/Uuid"},"amount":{"type":"string","pattern":"^\\d+(?:\\.\\d+)?$","description":"Valor na unidade do ativo, nunca em BRL."},"destination":{"type":"string","minLength":12,"maxLength":500},"memo":{"type":["string","null"],"maxLength":500}}},"CryptoWithdrawalCreateRequest":{"type":"object","additionalProperties":false,"required":["quote_id","destination"],"properties":{"quote_id":{"$ref":"#/components/schemas/Uuid"},"destination":{"type":"string","minLength":12,"maxLength":500,"description":"Deve ser idêntico ao destino usado no preview."},"memo":{"type":["string","null"],"maxLength":500}}},"CryptoSwapQuoteRequest":{"type":"object","additionalProperties":false,"required":["source_wallet_id","target_wallet_id","amount"],"properties":{"source_wallet_id":{"$ref":"#/components/schemas/Uuid"},"target_wallet_id":{"$ref":"#/components/schemas/Uuid"},"amount":{"type":"string","pattern":"^\\d+(?:\\.\\d+)?$","description":"Valor na unidade do ativo de origem."},"slippage_bps":{"type":"integer","minimum":1,"maximum":1000,"default":50,"description":"Tolerância máxima de desvio em pontos-base."}}},"BrlUsdtConversionPreviewRequest":{"type":"object","additionalProperties":false,"required":["amount"],"properties":{"amount":{"type":"string","pattern":"^\\d+(?:\\.\\d{1,2})?$","description":"Valor em BRL a converter, antes da taxa."},"destination_mode":{"type":"string","enum":["VEXUS_WALLET","EXTERNAL_ADDRESS"],"default":"VEXUS_WALLET"},"destination_address":{"type":"string","minLength":12,"maxLength":500,"description":"Obrigatório quando destination_mode=EXTERNAL_ADDRESS."}}},"BrlUsdtConversionRequest":{"type":"object","additionalProperties":false,"required":["amount","pin"],"properties":{"amount":{"type":"string","pattern":"^\\d+(?:\\.\\d{1,2})?$","description":"Valor em BRL a converter, antes da taxa."},"pin":{"type":"string","minLength":4,"maxLength":32,"writeOnly":true,"description":"PIN de confirmação da própria conta VexusPay."},"destination_mode":{"type":"string","enum":["VEXUS_WALLET","EXTERNAL_ADDRESS"],"default":"VEXUS_WALLET"},"destination_address":{"type":"string","minLength":12,"maxLength":500,"description":"Obrigatório quando destination_mode=EXTERNAL_ADDRESS."}}},"VexusCardIssueRequest":{"type":"object","additionalProperties":false,"required":["product_code","amount","name_on_card"],"properties":{"product_code":{"type":"string","maxLength":80,"description":"Código do produto de cartão habilitado."},"amount":{"type":"string","pattern":"^\\d+(?:\\.\\d{1,2})?$","description":"Valor em USD, mínimo de 10.00."},"name_on_card":{"type":"string","maxLength":100,"description":"Nome impresso no cartão."},"date_of_birth":{"type":["string","null"],"format":"date"}}},"VexusCardFundRequest":{"type":"object","additionalProperties":false,"required":["amount"],"properties":{"amount":{"type":"string","pattern":"^\\d+(?:\\.\\d{1,2})?$","description":"Valor da recarga em USD."}}},"CardWebhookCreateRequest":{"type":"object","additionalProperties":false,"required":["label","url"],"properties":{"label":{"type":"string","maxLength":100,"description":"Nome do endpoint de produção."},"url":{"type":"string","format":"uri","pattern":"^https://","maxLength":500,"description":"URL HTTPS pública, sem credenciais, query string ou redirecionamento."}}},"CheckoutProductRequest":{"type":"object","additionalProperties":false,"required":["name","price","payment_methods"],"properties":{"name":{"type":"string","maxLength":160},"description":{"type":"string","maxLength":4000},"price":{"type":"string","pattern":"^\\d+(?:\\.\\d{1,2})?$"},"currency":{"type":"string","enum":["BRL"],"default":"BRL"},"sku":{"type":"string","maxLength":100},"provider_product_id":{"type":"string","maxLength":200},"image_url":{"type":"string","format":"uri"},"return_url":{"type":"string","format":"uri","pattern":"^https://"},"client_webhook_endpoint_id":{"$ref":"#/components/schemas/Uuid"},"inventory_quantity":{"type":"integer","minimum":0},"payment_methods":{"type":"array","minItems":1,"maxItems":3,"items":{"type":"string","enum":["PIX","BOLETO","CREDIT_CARD"]}},"max_installments":{"type":"integer","minimum":1,"maximum":12},"metadata":{"type":"object","additionalProperties":true},"status":{"type":"string","enum":["ACTIVE","INACTIVE"],"default":"ACTIVE"},"version":{"type":"integer","minimum":1}}},"CheckoutLinkRequest":{"type":"object","additionalProperties":false,"required":["title","payment_methods"],"anyOf":[{"required":["product_id"]},{"required":["amount","currency"]}],"properties":{"product_id":{"type":"integer","minimum":1},"title":{"type":"string","maxLength":160},"description":{"type":"string","maxLength":4000},"amount":{"type":"string","pattern":"^\\d+(?:\\.\\d{1,2})?$"},"currency":{"type":"string","enum":["BRL"],"default":"BRL"},"payment_methods":{"type":"array","minItems":1,"maxItems":3,"items":{"type":"string","enum":["PIX","BOLETO","CREDIT_CARD"]}},"usage_limit":{"type":"integer","minimum":1},"expires_at":{"type":"string","format":"date-time"},"redirect_url":{"type":"string","format":"uri","pattern":"^https://"},"client_webhook_endpoint_id":{"$ref":"#/components/schemas/Uuid"},"image_url":{"type":"string","format":"uri"},"banner_url":{"type":"string","format":"uri"},"favicon_url":{"type":"string","format":"uri"},"logo_url":{"type":"string","format":"uri"},"accent_color":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$"},"checkout_text":{"type":"string","maxLength":500},"success_text":{"type":"string","maxLength":500},"buyer_fields":{"type":"array","items":{"type":"string"}},"theme":{"type":"object","additionalProperties":true},"pass_fee":{"type":"boolean"},"show_countdown":{"type":"boolean"},"max_installments":{"type":"integer","minimum":1,"maximum":12},"version":{"type":"integer","minimum":1}}},"CheckoutCancelRequest":{"type":"object","additionalProperties":false,"required":["reason"],"properties":{"reason":{"type":"string","minLength":5,"maxLength":500}}},"SplitParticipantInput":{"type":"object","additionalProperties":false,"required":["handle"],"properties":{"handle":{"type":"string","maxLength":100,"description":"Identificador público da conta participante."},"percentage":{"type":"string","pattern":"^\\d+(?:\\.\\d{1,6})?$"},"amount":{"$ref":"#/components/schemas/MoneyDecimal"},"fixed_minor":{"$ref":"#/components/schemas/MinorAmount"}}},"SplitRuleRequest":{"type":"object","additionalProperties":false,"required":["name","mode","participants"],"properties":{"name":{"type":"string","maxLength":120,"description":"Nome da regra."},"mode":{"type":"string","enum":["PERCENTAGE","FIXED"]},"currency":{"type":"string","enum":["BRL"],"default":"BRL"},"participants":{"type":"array","minItems":1,"maxItems":100,"items":{"$ref":"#/components/schemas/SplitParticipantInput"}}}},"SplitPayer":{"type":"object","additionalProperties":true,"properties":{"name":{"type":"string","maxLength":150,"description":"Nome do pagador."},"document":{"type":"string","maxLength":20,"description":"Documento do pagador."},"email":{"type":"string","format":"email"}}},"SplitCreateRequest":{"type":"object","additionalProperties":false,"required":["rule_id"],"anyOf":[{"required":["amount"]},{"required":["amount_minor"]}],"properties":{"rule_id":{"$ref":"#/components/schemas/Uuid"},"amount":{"$ref":"#/components/schemas/MoneyDecimal"},"amount_minor":{"$ref":"#/components/schemas/MinorAmount"},"payer":{"$ref":"#/components/schemas/SplitPayer"}}},"SplitRefundRequest":{"type":"object","additionalProperties":false,"anyOf":[{"required":["amount"]},{"required":["amount_minor"]}],"properties":{"amount":{"$ref":"#/components/schemas/MoneyDecimal"},"amount_minor":{"$ref":"#/components/schemas/MinorAmount"},"comment":{"type":"string","maxLength":500,"description":"Motivo seguro da devolução."}}},"OperationResponse":{"type":"object","required":["statusCode"],"properties":{"statusCode":{"type":"integer","const":200},"ok":{"type":"boolean"},"reference":{"type":"string","maxLength":120,"description":"Referência local para conciliação."},"provider_reference":{"type":"string","maxLength":180,"description":"Referência externa opaca, quando disponível."},"status":{"type":"string"},"data":{"type":["object","array","null"],"additionalProperties":true}},"additionalProperties":true},"DataResponse":{"type":"object","required":["statusCode","data"],"properties":{"statusCode":{"type":"integer"},"data":{"type":["object","array"],"additionalProperties":true}},"additionalProperties":false},"ApiError":{"type":"object","required":["code","message","details","correlationId","retryable"],"properties":{"code":{"type":"string","pattern":"^[A-Z0-9_]+$"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true},"correlationId":{"type":"string"},"retryable":{"type":"boolean"}}},"ErrorEnvelope":{"type":"object","required":["statusCode","message","error"],"properties":{"statusCode":{"type":"integer"},"message":{"type":"string"},"error":{"$ref":"#/components/schemas/ApiError"}}},"HealthLive":{"type":"object","required":["status","service","release","timestamp"],"properties":{"status":{"type":"string","const":"ok"},"service":{"type":"string","const":"vexus-baas"},"release":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}},"HealthReady":{"type":"object","required":["status","checks","timestamp"],"properties":{"status":{"type":"string","enum":["ready","not_ready"]},"checks":{"type":"object","additionalProperties":true},"timestamp":{"type":"string","format":"date-time"}}},"CheckoutWebhookEvent":{"type":"object","required":["id","type","createdAt","data"],"properties":{"id":{"$ref":"#/components/schemas/Uuid"},"type":{"type":"string","const":"checkout.order.status_changed"},"createdAt":{"type":"string","format":"date-time"},"data":{"type":"object","required":["orderId","status","method","currency","currencyExponent","amountMinor"],"properties":{"orderId":{"type":"string"},"status":{"type":"string","enum":["CREATED","PROCESSING","PENDING","AUTHORIZED","PAID","FAILED","EXPIRED","CANCELED","REFUNDED","REVIEW"]},"previousStatus":{"type":["string","null"]},"method":{"type":"string"},"currency":{"type":"string"},"currencyExponent":{"type":"integer"},"amountMinor":{"$ref":"#/components/schemas/MinorAmount"}},"additionalProperties":false}},"additionalProperties":false}}},"x-vexus-idempotency":{"required_for":["createPixCashIn","createPixCashOut","payPixQr","issueBoleto","payBoleto","createCryptoWithdrawal","createBrlUsdtConversion","createSplitRule","reviseSplitRule","createSplit","refundSplit","createVirtualCard","fundVirtualCard","freezeVirtualCard","unfreezeVirtualCard","cancelVirtualCard","createCardOtpWebhook","createCheckoutProduct","updateCheckoutProduct","archiveCheckoutProduct","createCheckoutLink","updateCheckoutLink","archiveCheckoutLink","cancelCheckoutLink"],"rules":"Use de 8 a 100 caracteres e repita a mesma chave somente ao repetir exatamente o mesmo corpo. Corpo divergente com a mesma chave retorna conflito."},"x-vexus-pagination":{"status":"NOT_APPLICABLE_TO_PUBLISHED_LISTS","detail":"A lista de regras é restrita à conta. O relatório de split usa os filtros from/to. Não envie page, cursor ou limit: esses parâmetros ainda não fazem parte do contrato."},"x-vexus-examples":{"classification":"FICTIONAL_DOCUMENTATION_DATA","detail":"Nomes, documentos, identificadores, códigos, endereços e valores dos exemplos não representam dados ou operações de produção."},"x-vexus-availability":[{"capability":"PIX cash-in/cash-out/QR","status":"PUBLISHED","surface":"Public API"},{"capability":"Boleto issue/info/pay","status":"PUBLISHED","surface":"Public API"},{"capability":"Crypto assets/wallets/deposits/withdrawals/history","status":"PUBLISHED","surface":"Public API"},{"capability":"Crypto swap quote","status":"PUBLISHED_QUOTE_ONLY","surface":"Public API","reason":"A cotação é real. A execução on-chain não é publicada até existir transação assinada, validada e homologada."},{"capability":"BRL para USDT BEP20","status":"PUBLISHED","surface":"Public API","reason":"Prévia, confirmação idempotente e acompanhamento da conversão estão disponíveis para contas autorizadas."},{"capability":"Split rules/create/get/cancel/refund/report","status":"PUBLISHED","surface":"Public API"},{"capability":"Virtual cards/products/issue/fund/freeze","status":"PUBLISHED","surface":"Public API"},{"capability":"Generic transaction query","status":"NOT_PUBLISHED","reason":"Use o painel e a referência retornada; não existe rota pública de consulta genérica nesta versão."},{"capability":"VexusPay Cards","status":"PUBLISHED_WITH_EXPLICIT_AUTHORIZATION","surface":"Public API","reason":"Exige autorização explícita de cartões virtuais por conta. PAN e CVV não são fornecidos por API. OTP é entregue somente pelo webhook assinado."},{"capability":"Checkout management API","status":"PUBLISHED","surface":"Public API","reason":"Produtos, links, meios habilitados e relatório exigem produto checkout e escopo checkout."},{"capability":"Account fees and limits","status":"PUBLISHED_WITH_EXPLICIT_AUTHORIZATION","surface":"Public API","reason":"Exige produto account e escopo account.read."},{"capability":"White Label contract/plan/fees/billing/status","status":"PUBLISHED","surface":"Public API","reason":"Consultas não mutáveis; a autorização comercial efetiva continua sendo aplicada pela Vexus."},{"capability":"Client webhooks","status":"PUBLISHED","surface":"Webhook assinado","reason":"Eventos publicados: checkout.order.status_changed e virtual_card.otp.received."},{"capability":"Public MED/dispute API","status":"NOT_PUBLISHED","reason":"Disputas são acompanhadas pelo painel e suporte; nenhuma rota pública deve ser presumida."}],"x-vexus-changelog":[{"date":"2026-08-21","changes":["Carteiras cripto, endereços, saldos, histórico e saque on-chain seguro publicados.","Contrato OpenAPI 3.1 e coleção Postman derivados da mesma fonte.","Split Payment publicado com idempotência nas mutações financeiras.","Cartões virtuais publicados com emissão, recarga, congelamento e consulta.","Swap quote, conversão BRL para USDT BEP20, taxas de cartão e webhook OTP publicados.","Produtos, links, meios e relatório de checkout publicados para contas autorizadas.","Assinatura e política de retry do webhook de checkout documentadas.","Matriz de disponibilidade explícita para recursos ainda não publicados."]}]}