Guías

Pruebas

Construye y prueba tu integración de principio a fin sin dinero real.

Todo lo que creas con una clave cp_test_ tiene livemode: false: las claves live no lo ven, el panel lo marca como prueba y sus emails llevan [PRUEBA]. El checkout de una factura de prueba ofrece un pago simulado.

Simular un pago

Llama a POST /test/invoices/{id}/simulate con una clave de prueba. El pago pasa por la misma máquina de estados que uno real y envía los mismos webhooks (con livemode: false). Una factura todavía en new toma primero la primera moneda que tu workspace puede recibir.

curl -X POST 'https://cryptopay.yanselmask.com/api/v1/test/invoices/7d61d9f9-a9e4-49c1-a1b8-b5d465d7a939/simulate' \
  -H 'Authorization: Bearer cp_test_••••' \
  -H 'Content-Type: application/json' \
  -d '{
  "scenario": "paid"
}'

paidEnvía exactamente lo que falta: la factura pasa a paid.
partialEnvía el 60 % de lo que falta: la factura pasa a partial.
overpaidEnvía el 110 %: la factura pasa a overpaid.
expiredHace caducar una factura new o pending sin pagos.

Tu workspace necesita al menos una moneda aceptada con wallet verificada, incluso para facturas de prueba: la simulación paga a esa dirección sin tocar la blockchain.

Prueba los webhooks en local

Crea un endpoint de prueba con http://localhost:4000/webhooks y usa «Enviar evento de prueba» en el panel, o un túnel público hacia tu máquina. Cada entrega aparece en Desarrolladores → Entregas con la petición y la respuesta completas.