Inicio rápido

Los pagos van directos a tus propias wallets: CryptoPay nunca custodia los fondos. La API es REST sobre HTTPS, cada respuesta es JSON con el sobre { data, error, request_id } y los importes viajan como strings decimales.

1. Crea una clave de API de prueba

   En el panel abre Desarrolladores → Claves de API y crea una clave en modo prueba. Tiene esta forma: cp_test_••••. Las claves de prueba crean facturas de prueba que puedes pagar con una simulación, sin dinero real.

2. Crea una factura desde tu servidor

   Envía el precio en tu moneda. La respuesta incluye la URL del checkout alojado en urls.checkout.

   POST /invoicescURLJavaScriptPHPPython

   Copiar

   curl -X POST 'https://cryptopay.yanselmask.com/api/v1/invoices' \
     -H 'Authorization: Bearer cp_test_••••' \
     -H 'Idempotency-Key: 6f1c2a0e-order-1001' \
     -H 'Content-Type: application/json' \
     -d '{
     "amount": "25.00",
     "currency": "USD",
     "order_id": "SO-1001",
     "description": "T-shirt",
     "success_url": "https://shop.example.com/thanks"
   }'

3. Redirige a tu cliente al checkout

   El checkout permite al cliente elegir moneda, muestra el importe exacto y la dirección con un código QR y se actualiza en vivo. Cuando el pago se confirma vuelve a tu success_url.

   JavaScriptCopiar

   const { data: invoice } = await res.json()
   window.location.href = invoice.urls.checkout // https://cryptopay.yanselmask.com/pay/<id>

4. Completa el pedido con un webhook

   Añade un endpoint en Desarrolladores → Webhooks. Enviamos invoice.paid cuando el pago tiene suficientes confirmaciones. Verifica la firma y marca el pedido como pagado.

   Cómo verificar los webhooks →