¿Cómo integrar pagos en cripto en mi sitio por API?

El flujo de la integración

1. Crear cobro: POST /v1/invoices con el importe y tu clave de API.
2. Checkout: redirige al cliente al checkout_url devuelto (QR + dirección, alojado por Stackfy).
3. Webhook: cuando el pago se confirma, Stackfy hace un POST firmado a tu URL.
4. Estado (opcional): GET /v1/invoices/{id} para consultar cuando quieras.

Ejemplo — crear un cobro

curl -X POST https://api.stackfy.io/v1/invoices \
  -H "Authorization: Bearer SU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"price":"49.90","currency":"BRL","store_id":"SU_STORE_ID"}'

La respuesta incluye el id del cobro y el checkout_url al que envías al cliente.

Webhook firmado (no confíes en el redirect)

La confirmación llega por un webhook firmado con HMAC-SHA256 (mismo esquema que Stripe): el header X-Stackfy-Signature: t=…,v1=… permite verificar que el evento vino realmente de Stackfy. Libera siempre el pedido por el webhook verificado (o la consulta de estado), nunca por lo que el navegador del cliente devuelve.

Por qué es fácil de integrar

Además de ser no-custodial y sin comisión por transacción, la integración es sencilla: un endpoint para crear, un checkout listo y un webhook firmado. Y el mercado que atiendes es enorme — en Brasil, las stablecoins dominan el volumen:

La documentación completa está en api.stackfy.io/docs, con una versión en Markdown (docs.md) que un agente de IA puede leer y usar para generar la integración.