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

Bash / cURL BASH
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

POST /api/v1/invoices BASH
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}'
Crear una factura

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.

GET /api/v1/invoices/{uuid} BASH
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.
errores