Pruebas
Los pagos en testnet son transacciones reales en la testnet de cada cadena, con tokens de prueba sin valor. Los estados, depósitos, barridos y webhooks funcionan igual que en mainnet.
Cambia a testnet
- Activa el interruptor Testnet en la parte superior del panel de comercio. Tu cuenta y tus proyectos son compartidos; las claves API, webhooks, ajustes de cobro y registros de cobro son independientes.
- En Ajustes de cobro del proyecto, registra una dirección de cobro en testnet y selecciona tokens. Tu billetera necesita un poco de gas de testnet.
- Crea una clave API (empieza por
sk_test_) y configura un webhook.
Haz un pago de prueba
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" }'Abre la checkout_url devuelta; el checkout muestra la etiqueta Testnet. Paga con una billetera o, en BNB Chain, envía tUSDT a la deposit_address del pago. Consigue tUSDT al final de esta página.
Las comisiones son las de mainnet. Con las comisiones predeterminadas, un pago con billetera de 10 USDT cuesta 0,035 y recibes 9,965; una transferencia de 10 USDT cuesta 0,335 y recibes 9,665.
Casos a probar
| Caso | Qué hacer | Comprueba que tu sistema |
|---|---|---|
| Pago normal | Paga el total con una billetera | Marca el pedido como pagado con payment_intent.paid |
| Pago insuficiente | Envía la mitad a deposit_address y luego el resto | No envía tras la primera transferencia y envía al completarse |
| Caducidad | Crea un pago con expires_in: 60 y no lo pagues | Cancela el pedido con payment_intent.expired |
| Pago tardío | Transfiere a deposit_address después de que caduque | Envía o reembolsa con payment_intent.paid_late |
| Recarga | Envía 10 tUSDT a la dirección de depósito del usuario | Suma al saldo con deposit.confirmed |
| Recargas pequeñas | Envía 3 tUSDT dos veces a la dirección de depósito | Abona ambas y recibe deposit.settled tras el barrido |
| Reintentos | Haz que tu URL devuelva 500 al principio | Abona una sola vez tras los reintentos de kokiwa |
| Firma | Verifica con un secreto incorrecto | Rechaza la solicitud y no abona nada |
Consigue tokens de prueba
Tu billetera reclama tUSDT del contrato, hasta 1000 cada vez y sin límite de veces. El gas es la moneda nativa de la testnet, de su faucet oficial, como el faucet de BNB Chain.
Tu billetera llama a faucet en el contrato del token de prueba y los tokens se acuñan en tu propia dirección. Hasta 1000 por llamada, tantas veces como quieras; tu billetera paga el gas (tBNB).
No se detectó ninguna billetera.
Los pagos creados con una clave sk_test_ se pagan en la testnet de TON, así que cambia la billetera a testnet. Consigue TON de prueba con @testgiver_ton_bot en Telegram y tUSDT aquí:
Tu billetera TON envía el mensaje público Faucet al contrato de tUSDT (kQBOp0yfL-_QhS_0IF-1TrYrfFIg7qpDKMoS3mGrMbXWd003) con 0,1 TON para el gas; lo que no se usa vuelve. Hasta 1000 por llamada, tantas veces como quieras. Escanea el código QR con una billetera TON en testnet o abre el enlace en tu teléfono.
Abrir en la billeteraPaso a producción
Registra direcciones de cobro en mainnet, crea una clave que empiece por sk_live_ y un webhook de mainnet, y sustituye la clave y el secreto de firma. La URL de la API no cambia.