Guía de integración rápida

Conecte pagos con monedas estables (USDT / USDC) en cuatro pasos. Configure primero una clave API, un secreto Webhook y billeteras receptoras para las redes habilitadas. El ejemplo de la derecha verifica su clave API.

1

Crear una orden de pago

Su servidor

Llame a /api/v1/order/create desde su backend con el precio, la moneda, la red y el pedido comercial ID. La respuesta contiene su billetera configurada y el monto final a pagar; varios pedidos pueden compartir la misma billetera.

GET /api/v1/ping comprueba su clave API. Para crear un pedido también se requiere un timestamp y una firma de solicitud.
2

Mostrar detalles de pago

Tu interfaz

Abre checkoutUrl de la respuesta o muestra el importe, la dirección, la red y la moneda del objeto payment. Los fondos llegan directamente a la cartera configurada.

Utilice el payment.amount completo. payment.qrData contiene QR data, no una imagen.
3

Esperar la confirmación del pago

BoltUtil

BoltUtil compara las transferencias por red, moneda, billetera y monto, luego envía una notificación al notifyUrl asociado cuando se cumplen los requisitos de confirmación. Las excepciones de pago elegibles requieren la revisión del comerciante.

La confirmación y la entrega dependen de las condiciones de la cadena de bloques y de la red. Una redirección de página no prueba el pago.
4

Verificar y cumplir

Su servidor

Verifica la firma del cuerpo original y la marca de tiempo, y vincula el evento con tu pedido. Revisa el importe exigible, el importe pagado y el tipo de liquidación. Devuelve HTTP 2xx después de guardar el evento de forma duradera y no repitas la entrega del mismo pedido.

Detecta eventos duplicados mediante eventId y evita entregar el pedido comercial más de una vez. En pagos insuficientes aceptados manualmente, el importe pagado puede ser menor que el exigible.

Redes y monedas

Consulte las monedas admitidas, las versiones de tokens y las reglas de confirmación de pago.

Ver redes compatibles →