Testes

Pagamentos na testnet são transações reais na testnet de cada rede, com tokens de teste sem valor. Status, depósitos, varreduras e webhooks funcionam como na mainnet.

Mude para a testnet

Ative a chave Testnet no topo do painel do comerciante. Sua conta e seus projetos são compartilhados; chaves de API, webhooks, configurações e registros de recebimento são separados.
Em Configurações de recebimento do projeto, registre um endereço de recebimento na testnet e selecione tokens. Sua carteira precisa de um pouco de gas da testnet.
Crie uma chave de API (começa com sk_test_) e configure um webhook.

Faça um pagamento de teste

curl https://api.kokiwa.com/v1/payment_intents \
  -H "Authorization: Bearer $KOKIWA_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "currency": "USDT", "amount": "10.00", "customer": "test_user_1" }'

Abra a checkout_url retornada; o checkout mostra o rótulo Testnet. Pague com uma carteira ou, na BNB Chain, envie tUSDT para o deposit_address do pagamento. Obtenha tUSDT no fim desta página.

As taxas são as da mainnet. Com as taxas padrão, um pagamento de 10 USDT com carteira custa 0,035 e você recebe 9,965; uma transferência de 10 USDT custa 0,335 e você recebe 9,665.

Casos para testar

Caso	O que fazer	Confira se seu sistema
Pagamento normal	Pague o total com uma carteira	Marca o pedido como pago em `payment_intent.paid`
Pagamento a menor	Envie metade para `deposit_address` e depois o restante	Não envia após a primeira transferência e envia ao completar
Expiração	Crie um pagamento com `expires_in: 60` e não pague	Cancela o pedido em `payment_intent.expired`
Pagamento tardio	Transfira para `deposit_address` depois que o pagamento expirar	Envia ou reembolsa em `payment_intent.paid_late`
Recarga	Envie 10 tUSDT para o endereço de depósito do usuário	Soma ao saldo em `deposit.confirmed`
Recargas pequenas	Envie 3 tUSDT duas vezes para o endereço de depósito	Credita as duas e recebe `deposit.settled` após a varredura
Novas tentativas	Faça sua URL retornar 500 no início	Credita uma só vez depois das novas tentativas do kokiwa
Assinatura	Verifique com o segredo errado	Rejeita a requisição e não credita nada

Obtenha tokens de teste

Sua carteira resgata tUSDT do contrato, até 1000 por vez e sem limite de resgates. O gas é a moeda nativa da testnet, do faucet oficial, como o faucet da BNB Chain.

Emita tUSDT você mesmo

Sua carteira chama faucet no contrato do token de teste e os tokens são emitidos para o seu próprio endereço. Até 1000 por chamada, quantas vezes quiser; sua carteira paga o gas (tBNB).

Rede

Nenhuma carteira detectada.

Pagamentos criados com uma chave sk_test_ são pagos na testnet da TON, então mude a carteira para testnet. Obtenha TON de teste com @testgiver_ton_bot no Telegram e tUSDT aqui:

Emita tUSDT na TON testnet

Sua carteira TON envia a mensagem pública Faucet ao contrato do tUSDT (kQBOp0yfL-_QhS_0IF-1TrYrfFIg7qpDKMoS3mGrMbXWd003) com 0,1 TON para o gas; o que sobrar volta. Até 1000 por chamada, quantas vezes quiser. Escaneie o QR code com uma carteira TON na testnet ou abra o link no celular.

Abrir na carteira

Entrada em produção

Registre endereços de recebimento na mainnet, crie uma chave que começa com sk_live_ e um webhook da mainnet, e troque a chave e o segredo de assinatura. A URL da API continua a mesma.

Próximo: Referência da API