API REST

USDT y USDC

Webhooks

Node.js y PHP

API Pix a USDT: recibe con Pix y convierte a USDT o USDC

Crea el cobro Pix con una instrucción de compra. Cuando se confirma el Pix, el valor se convierte a USDT o USDC y se envía a la billetera de tu empresa, con webhooks en cada etapa y paquetes oficiales para Node.js y PHP.

QR Code dinámico

Pix

R$ 4.500,00

Esperando pago ⬢ 04:58

Pix Copia y Pega

00020126580014BR.GOV.BCB.PIX0136a3f5e1c2-7b4d-4e8f-9c1a-5f6e8d3b2a4f5204000053039865406450.005802BR5919XGate PAGAMENTOS6011SAO PAULO62070503***6304A1B2

API Pix a USDT

Cada cobro Pix creado en POST /deposit puede llevar el objeto purchase, con moneda, red y billetera de destino. Tras la confirmación del Pix, la compra se dispara automáticamente con el valor recibido, y sigues todo por webhook.

Tú envías

POST /deposit
Con purchase

Tu empresa recibe

USDT o USDC
En la billetera de la empresa

Una llamada para cobrar con Pix y recibir en dólar digital

Flujo de la API

Del cobro Pix a la entrega on-chain

La API usa REST y JSON, con autenticación por token JWT. El flujo más directo crea el cobro y la compra en la misma llamada: cuando el Pix se confirma y se acredita en reales, la compra se hace a mercado y la cripto va a la billetera externa de la empresa.

Paso a paso:

01 Inicia sesión y obtén el token JWT, válido por 15 días
02 Consulta activos, redes y límites en GET /crypto/options
03 Crea el cobro en POST /deposit con el objeto purchase
04 Tu cliente paga el Pix y el valor se acredita en reales
05 Sigue por webhook hasta DELIVERED, con el hash on-chain

POST /deposit Ejemplo ilustrativo

R$ 349

Pix confirmado Reales en saldo

R$ 349

Compra BRL → USDT

A mercado

Entrega DELIVERED · Tron

69,10 USDT

Cotización

¿Prefieres fijar el precio antes de comprar?

Si la empresa ya tiene saldo en reales, POST /crypto/quotes garantiza el precio por 30 segundos. Después, POST /crypto/purchases ejecuta la compra con esa cotización. Pedir una cotización y no usarla no cuesta nada. El precio ya incluye el margen comercial, y solo se descuenta la tarifa de red en la entrega.

Formas de comprar:

01 En el cobro: objeto purchase en POST /deposit, a mercado
02 Con saldo: POST /crypto/purchases, a mercado
03 Con cotización: quoteId válido por 30 segundos
04 Solo para mostrar un valor: POST /crypto/quotes/estimate
05 Idempotencia con externalId, único por empresa

JWT

REST + JSON

externalId

Webhooks

Monedas y redes

USDT y USDC en las principales redes

La API acepta USDT en Tron, Ethereum, Polygon y Solana y USDC en Ethereum, Polygon y Solana. XGate no ofrece custodia: no existe saldo cripto en la plataforma, y la cripto va a la billetera externa de la empresa, sin memo ni tag.

Estado de la compra:

EXECUTING: compra en ejecución
PENDING_APPROVAL: en análisis de compliance, cuando aplique
DELIVERED: cripto confirmada en la red, con txHash
REJECTED: el valor en reales vuelve al saldo

Webhooks purchase.*

Cobro creado

QR Code y Pix Copia y Pega

Pix confirmado

Reales acreditados en el saldo

Cripto entregada

Evento purchase.delivered con txHash

Integración

Integra con REST o con los paquetes oficiales

Usa la API REST directamente o los paquetes oficiales para Node.js (NPM) y PHP (Composer), que se encargan del inicio de sesión y las llamadas. Antes de operar, registra en el panel la lista de IP permitidas y la URL de webhook.

La compra puede pasar por aprobación de compliance antes de la entrega, según la configuración de la cuenta, y los límites de cada empresa aparecen en GET /crypto/options.

Opciones GET

Cobro POST

Pix confirmado Webhook

Compra Purchase

Entrega txHash

Ejemplo de llamada

Ejemplo: cobro Pix con compra de USDT

Esta llamada crea el cobro en reales y programa la compra para cuando se confirme el Pix. Los valores son ilustrativos.

POST https://api.xgateglobal.com/deposit
Authorization: Bearer <token>

{
  "amount": 1500.00,
  "customerId": "<customer_id>",
  "currency": { "_id": "<currency_id>", "name": "BRL", "type": "PIX", "symbol": "R$" },
  "purchase": {
    "asset": "USDT",
    "network": "TRON",
    "address": "<company_wallet>"
  },
  "externalId": "pedido-7722"
}

Ver documentación completa

Para quién es

Para plataformas que reciben Pix y quieren recibir en stablecoin

Empresas con equipo técnico y volumen recurrente que quieren automatizar la conversión de Pix a USDT o USDC dentro de su propio sistema.

E-commerce

Checkout con Pix y recepción en USDT o USDC.

SaaS

Cobra suscripciones con Pix y recibe en stablecoin.

Marketplaces

Combina la API con subcuentas y split entre participantes.

Fintechs

Incluye Pix y conversión en tu producto con la API de Pix.

Importadores

Automatiza la compra de USDT para tu operación en el exterior.

Grandes volúmenes

Para operaciones mayores, la mesa OTC atiende con cotización directa.

Preguntas frecuentes

¿Existe una API para recibir con Pix y convertir a USDT?

Sí. En la API de XGate, creas el cobro Pix en POST /deposit con el objeto purchase. Cuando se confirma el Pix, se dispara la compra de USDT o USDC y la cripto va a la billetera de la empresa.

¿Qué monedas y redes acepta la API?

USDT en las redes Tron, Ethereum, Polygon y Solana, y USDC en las redes Ethereum, Polygon y Solana.

¿Se puede fijar el precio?

Sí, al comprar con saldo en reales: POST /crypto/quotes garantiza el precio por 30 segundos. La compra vinculada al cobro Pix se hace a mercado.

¿Cómo sigo la operación?

Por webhooks o consultando la compra. El estado DELIVERED trae el hash de la transacción. En REJECTED, el valor en reales vuelve al saldo de la empresa.

¿XGate guarda la cripto?

No. XGate no ofrece custodia y no existe saldo cripto en la plataforma. La cripto va a la billetera externa de la empresa.

¿Cuánto cuesta?

El precio cotizado ya incluye el margen comercial, y la tarifa de red se descuenta en la entrega. Las condiciones varían según la operación y se presentan en la propuesta.

¿Hay paquetes listos para integrar?

Sí. Hay paquetes oficiales para Node.js (NPM) y PHP (Composer), además de la API REST con documentación pública.

¿Listo para integrar Pix y USDT?

Habla con el equipo para abrir la cuenta y habilitar la compra de cripto en tu empresa.

Habla con el equipo