Integración de pagos

API de pagos cripto para USDT y USDC

Crea órdenes de pago, consulta su estado y verifica webhooks firmados desde tu servidor. Integra pagos desde la cartera o transferencias manuales con USDT y USDC.

Redes de pago compatibles

USDC no es compatible con TRON. Cada ruta debe estar habilitada y tener una cartera receptora activa. USDbC, USDC.e y otros contratos no sustituyen los activos indicados.

USDC emitido por Circle en Ethereum, Polygon, Solana y Base. BNB Smart Chain utiliza Binance-Peg USDC, con 18 decimales. No es USDC nativo emitido por Circle. USDC nativo y USDT puenteado en Base. La disponibilidad depende de las rutas habilitadas y de una dirección de recepción activa.

Pasos

Flujo de integración API

Ideal para desarrolladores que integran pagos cripto en SaaS, membresías, marketplaces o checkouts propios.

  1. 01

    Cree una orden de pago con importe, red, ID de pedido y URL de retorno.

  2. 02

    Muestre al comprador la dirección, el código QR, la página de checkout y el importe exacto en USDT / USDC.

  3. 03

    BoltUtil escanea transferencias TRC20, ERC20, BEP20, Polygon o Solana y compara red, dirección e importe.

  4. 04

    Tras la confirmación on-chain, BoltUtil envía un webhook firmado con el hash de transacción y el estado.

BoltUtil verifica pagos y envía callbacks firmados. Tu servidor valida la firma y el estado, evita duplicados y luego entrega, activa o acredita.

Notas de integración

Lo importante antes de producción

Liquidación no custodial

Los fondos llegan directamente a la billetera del comercio. BoltUtil solo monitorea la cadena y envía notificaciones.

Cinco redes USDT / USDC

Integre TRC20, ERC20, BEP20, Polygon y Solana con una sola API de órdenes y un payload de webhook unificado.

Automatización por webhook

Cuando el pago se detecta y confirma, su backend recibe una devolución firmada para activar, entregar o acreditar.

Node.js 22+ · USDC / Base
import crypto from 'node:crypto'

// Node.js 20+ server module. Call only after authenticating the buyer.
// order must come from your database, with ownership and price checked.
// Never pass req.body directly; persist externalOrderId before calling.
export async function createStablecoinCheckout(order) {
  const key = process.env.BOLTUTIL_API_KEY
  const secret = process.env.BOLTUTIL_API_SECRET
  if (!key || !secret) throw new Error('Missing server credentials')

  const payload = JSON.stringify({
    externalOrderId: order.externalOrderId,
    amount: order.amount,
    currency: 'USDC',
    network: 'BASE',
    notifyUrl: 'https://merchant.com/webhooks/boltutil',
    returnUrl: 'https://merchant.com/orders/complete'
  })
  const timestamp = Date.now().toString()
  const signature = crypto.createHmac('sha256', secret)
    .update(`${timestamp}.${payload}`).digest('hex')

  // A timeout does not prove creation failed. Query order/status using
  // the SAME externalOrderId before deciding whether to retry.
  const response = await fetch('https://api.boltutil.com/api/v1/order/create', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-Bolt-Key': key,
      'X-Bolt-Timestamp': timestamp,
      'X-Bolt-Signature': signature
    },
    body: payload,
    signal: AbortSignal.timeout(10000)
  })
  const result = await response.json()
  if (!response.ok || result.code !== 200 || !result.data?.checkoutUrl) {
    throw new Error('Create order failed; reconcile the saved order')
  }
  // Save result.data on the server. Return only checkout data to the buyer.
  return result.data
}

Ejemplos de integración y diagnóstico. No se envían solicitudes. Use sus pedidos, configuración de red y documentación de la API.

Leer documentación API

Liquidación no custodial

Los fondos llegan directamente a la billetera del comercio. BoltUtil solo monitorea la cadena y envía notificaciones.

Cinco redes USDT / USDC

Integre TRC20, ERC20, BEP20, Polygon y Solana con una sola API de órdenes y un payload de webhook unificado.

Automatización por webhook

Cuando el pago se detecta y confirma, su backend recibe una devolución firmada para activar, entregar o acreditar.

Integración de pagos

Preguntas antes de salir a producción

¿BoltUtil custodia los fondos del comercio?

No. BoltUtil funciona como una capa no custodial de monitoreo y notificación. El comercio configura su propia billetera de cobro.

¿Cómo se empareja un pago con una orden?

El sistema valida red, dirección de destino, importe exacto en USDT / USDC, estado de la orden y ventana de expiración.

¿Qué redes admiten USDT y USDC?

TRON admite solo USDT. Ethereum, BNB Smart Chain, Polygon, Solana y Base usan las versiones configuradas de USDT / USDC. La disponibilidad depende de los canales activos y las billeteras del comerciante.

Lance un flujo de pago USDT / USDC más claro

Cree órdenes, monitoree transferencias y notifique a su backend sin pedir capturas de pago.