Testes no sandbox
O ciclo completo em segundos e um valor para cada caso de erro.
O sandbox é um ambiente simulado: nenhum dinheiro se move. Use a chave oxk_sandbox_parceirodemo2026.
Linha do tempo
| Tempo desde a criação | status | Etapa atual |
|---|---|---|
| 0 a 15 s | PROCESSING | PAYMENT aguardando pagamento |
| 15 a 30 s | PROCESSING | SETTLEMENT em andamento |
| 30 a 45 s | PROCESSING | DELIVERY em andamento |
| Após 45 s | COMPLETED | Todas concluídas |
Valores para testar erros
Os dois últimos dígitos do amount da cotação escolhem o cenário:
| Centavos | Exemplo | Resultado |
|---|---|---|
13 | 100013 | A entrega falha aos 30 s (FAILED), o reembolso automático começa aos 45 s (REFUNDING) e termina aos 60 s (REFUNDED) |
14 | 100014 | O pagamento não chega e a transferência expira aos 15 s (EXPIRED) |
15 | 100015 | A entrega fica parada em andamento até você pedir o reembolso |
99 | 100099 | A cotação responde 422 ROUTE_UNAVAILABLE |
Outros cenários
| Para testar | Faça |
|---|---|
| Cliente sem KYC | Cote antes de enviar a atestação: 422 KYC_ATTESTATION_REQUIRED |
| Assinatura inválida | Envie uma assinatura que não tenha 64 bytes: 422 INVALID_ATTESTATION_SIGNATURE |
| Cotação expirada | Crie a transferência mais de 5 minutos depois de cotar: 422 QUOTE_EXPIRED |
| Retentativa | Repita POST /v1/transfers com a mesma Idempotency-Key |
| Conflito | Repita com a mesma chave e outro corpo: 409 IDEMPOTENCY_CONFLICT |
| Reembolso | Peça entre 15 e 45 s depois de criar a transferência, ou a qualquer momento com os centavos 15. Termina 15 s depois (REFUNDED) |
| Reembolso fora da janela | Peça antes de 15 s ou depois da entrega: 409 TRANSFER_NOT_REFUNDABLE |
| Ambiente errado | Use uma chave oxk_production_…: 403 FORBIDDEN |
IDs prontos
Funcionam direto na Referência da API:
| Recurso | ID |
|---|---|
| Cliente | cus_8f2a91c04d7e |
| Conta de destino | rcv_AHShHbju |
| Cotação (não expira) | quo_jyqRwE1-AHShHbjuAAAAAAAPQkBqxmlC |
| Transferência concluída | trf_jyqRwE1-AHShHbjuAAAAAAAPQkBqxmlCasZpQgD6yA |
| Transferência parada na entrega (aceita reembolso) | trf_jyqRwE1-AHShHbjuAAAAAAAPQk9qxm0WasZtIQBdIQ |
| Auditoria pendente | aud_3c9f1e2b7a44 |
| Endpoint de webhook | whe_7b2d4f6a8c1e |