Pasarela de Pagos · API

Empezar en 3 pasos

1. 1. Crea un cobro desde tu servidor

   curl -X POST https://p2p.falcox.net/api/v1/charges \
     -H "Authorization: Bearer TU_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "amount": 25.00,
       "order_id": "PEDIDO-1001",
       "description": "Suscripción Pro",
       "redirect_url": "https://tu-sitio.com/gracias",
       "metadata": { "user_id": "42" }
     }'

   Copiar

2. 2. Respuesta — redirige al cliente a hosted_url

   {
     "id": "clx123...",
     "status": "pending",
     "amount": 25,
     "currency": "USDT",
     "network": "bsc",
     "address": "0xABC...123",
     "hosted_url": "https://p2p.falcox.net/pay/clx123...",
     "expires_at": "2025-01-01T12:00:00.000Z"
   }

3. 3. Recibe la confirmación por webhook

   Cuando el pago se confirma on-chain enviamos un POST a tu Webhook URL con el evento charge.paid y la cabecera de firma:

   X-Falcox-Signature: t=<unix>,v1=<hmac_sha256>
   X-Falcox-Event: charge.paid
   
   // Verifica: HMAC_SHA256(webhookSecret, `${t}.${rawBody}`) === v1