Crea tu primera factura de prueba con la API de CrptoX
Configura una billetera y clave TEST, consulta métodos de pago, crea una factura y verifica su estado con la API de CrptoX.
1. Crear cuenta comercial
Verifica tu correo, añade una billetera TRON Shasta activa en modo de prueba y crea una clave TEST. La clave determina el entorno; no hay otro dominio para la API de pruebas.
2. Consulta los métodos de pago disponibles
read -r -s -p 'TEST API key: ' CRPTOX_TEST_KEY
printf '\n'
curl --fail-with-body --silent --show-error \
-H "Authorization: Bearer $CRPTOX_TEST_KEY" \
-H 'Accept: application/json' \
'https://crptox.com/api/v1/payment-methods'
Lista vacía o merchant_wallet_unavailable: añade una billetera activa en la misma red y entorno de la factura. Una billetera LIVE no sirve a una clave TEST.
3. Crea una factura
curl --fail-with-body --silent --show-error \
-X POST 'https://crptox.com/api/v1/invoices' \
-H "Authorization: Bearer $CRPTOX_TEST_KEY" \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
--data '{"amount":"1","network":"tron","asset":"USDT","expires_in":1800}'
4. Paga la factura y consulta su estado
Usa data.invoice.uuid para abrir la página de pago y consultar la factura. Envía exactamente data.payment.amount con tokens de prueba en Shasta y espera la confirmación. Los tokens de prueba no tienen valor monetario real.
read -r -p 'data.invoice.uuid: ' CRPTOX_INVOICE_UUID
printf '%s\n' "https://crptox.com/pay/$CRPTOX_INVOICE_UUID"
curl --fail-with-body --silent --show-error \
-H "Authorization: Bearer $CRPTOX_TEST_KEY" \
-H 'Accept: application/json' \
"https://crptox.com/api/v1/invoices/$CRPTOX_INVOICE_UUID"
Entrega el pedido solo cuando data.invoice.status sea paid. Un pago detectado o en confirmación aún no tiene confirmación final.
Guarda la clave en el servidor. Verifica las firmas de los webhooks y consulta la factura con una clave del mismo entorno antes de entregar. Volver al navegador o enviar una captura no demuestra el pago.
Si falla la primera solicitud
- 401: comprueba la clave Bearer, su vigencia y si está activa. Nunca la publiques en mensajes de soporte.
- Lista vacía o merchant_wallet_unavailable: añade una billetera activa en la misma red y entorno de la factura. Una billetera LIVE no sirve a una clave TEST.
- 422: consulta error.details y las combinaciones de red y token. Para errores de cuota, revisa el límite compartido entre TEST y LIVE. Ante 429, reduce las peticiones y respeta la espera indicada.