Integración API
API de cobros USDT / USDC: crear y consultar órdenes
Usa vinculaciones exclusivas para depósitos y pedidos de cobro para montos fijos. Compara firmas, solicitudes y respuestas en las herramientas oficiales.
Guía paso a paso
Sigue los pasos en tu propio panel. Haz clic en una imagen para ampliarla.
Abre el depurador API del centro de desarrolladores. Para depósitos de miembros, elige Crear wallet exclusiva y sigue esa guía. Estos pasos describen cobros de monto fijo. LIVE · Producción indica que crear guarda datos reales; puedes empezar consultando un pedido existente.
Paso 1 · Haz clic para ampliar Introduce tu Merchant UID de seis dígitos y tu API Key, que empieza por mch_, en la herramienta oficial. Se conservan solo en la memoria de esa página y debes introducirlos de nuevo al actualizar. No compartas capturas ni encabezados que contengan la clave.
Elige Crear pedido de cobro y revisa moneda, merchantOrderNo, amount y notifyUrl. El monto se envía como cadena; merchantOrderNo enlaza el pedido de tu sistema. notifyUrl debe usar HTTPS. Usa la dirección de depuración para observar callbacks en su receptor y tu propia URL desplegada para operaciones del negocio.
Confirma la creación en producción solo cuando quieras crear un pedido real. La herramienta genera timestamp, nonce y firma, y muestra solicitud y respuesta. Revisa estado HTTP, orderNo, merchantOrderNo, cashierUrl y status. Obtener un enlace de checkout confirma la creación, no el cobro.
Cambia a Consulta de estado e introduce el orderNo de la plataforma: PI para cobros y PO para pagos salientes. No uses merchantOrderNo. Un cobro tiene éxito en completed; un pago saliente, en confirmed, o falla en failed. Si el resultado es incierto, consulta el pedido original antes de crear otro.
Compara encabezados, mensaje de firma, body y respuesta original. 20005: revisa la clave; 20011: ruta, orden y normalización; 20012: reloj; 20016: genera un nonce nuevo; 40105: pedidos vigentes del mismo monto; 51004: saldo de comisiones. Guarda requestId y comparte el error sin datos sensibles. Usa los ejemplos Node.js o PHP y lee las credenciales desde variables de entorno.
La herramienta usa producción. Crear pedidos o wallets guarda datos reales; crear un pago saliente intenta enviar fondos. Si hay un timeout o un resultado desconocido, consulta el pedido original antes de repetirlo.