Pagos

Aceptar un pago cripto con una invoice

Cobrar en cripto se reduce a tres movimientos: crea una invoice por un importe, dirige al pagador a un checkout y reacciona a un webhook de liquidación. El procesamiento, la gestión de direcciones y el seguimiento de confirmaciones se hacen por ti.

Antes de empezar
  • Una clave API en vivo
  • Un endpoint de webhook configurado y un secreto de firma

1Crea una invoice

Pide una invoice por un importe denominado en fiat y las cadenas que aceptas. Recibes una dirección de cobro y una URL de checkout.

curl https://api.1st-node.com/v1/payments/invoices \
  -H "Authorization: Bearer sk_live_..." \
  -d '{"amount_usd":49,"accept":["eth","tron"]}'

2Presenta el checkout

Redirige al pagador a la URL de checkout devuelta, o renderiza la dirección y el importe tú mismo. La invoice rastrea subpago, sobrepago y confirmaciones.

3Confirma vía webhook

Al liquidarse, un webhook firmado (HMAC-SHA256) se dispara con el id de la invoice y el estado. Verifica la firma y luego marca el pedido como pagado. La entrega del webhook es idempotente —los eventos duplicados no acreditan dos veces.

> POST /your/webhook  X-Signature: <hmac>
> { "invoice":"in_..","status":"settled","amount_usd":49 }

Preguntas frecuentes

¿Cómo confío en el webhook?

Cada evento se firma con HMAC-SHA256 sobre el cuerpo bruto. Recalcúlalo con tu secreto y rechaza los que no coincidan.

¿Puedo pagar además de cobrar?

Sí —el pago masivo y la liquidación son primitivas de pago hermanas sobre el mismo saldo.

Sigue leyendo

Recarga, obtén tu clave y publica.

Autoservicio. Paga en cripto o con tarjeta. Medido por créditos: las primitivas pesadas cuestan más, las simples son baratas.

Obtener clave API