Ir al contenido

Referencia de la API ​

Consulte API de Comerciante para ejemplos de firma, estados de los pedidos y verificación de notificaciones.

Rutas públicas en vivo ​

FinalidadMétodoRutaAutenticación
Crear un pedido GMPayPOST/payments/gmpay/v1/order/create-transactionHMAC-SHA256 del comercio
Consultar configuraciónGET/payments/gmpay/v1/configPúblico
Abrir la página de pagoGET/pay/checkout-counter/{trade_id}Público
Consultar los datos del pagoGET/pay/checkout-counter-resp/{trade_id}Público
Consultar estado del pedidoGET/pay/check-status/{trade_id}Público
Seleccionar red o proveedorPOST/pay/switch-networkPúblico
Enviar el hash de la transacciónPOST/pay/submit-tx-hash/{trade_id}Público
Volver al comercioGET/pay/return/{trade_id}Redirección del navegador
Crear un pedido EPayGET o POST/payments/epay/v1/order/create-transaction/submit.phpMD5 del comercio
Recibir una notificación de OKPayPOST/payments/okpay/v1/notifyFirma de OKPay

Superficie de la API de administración ​

Las APIs de gestión se encuentran en /admin/api/v1/* y están protegidas con JWT, excepto los puntos finales de inicio de sesión y el establecimiento inicial de la contraseña.

Grupos principales visibles en la fuente actual:

  • El cajero público acepta un hash para un pedido pendiente en la cadena. Un administrador también puede revisar un pedido caducado o un candidato en revisión manual.
  • Tipos de cambio: rate.mode admite fixed o auto. El modo fijo usa rate.forced_rate_list. El automático consulta rate.api_url, guarda en caché las respuestas correctas por moneda base y conserva la última caché persistente si falla la actualización. Dejar rate.forced_rate_list vacío restaura el tipo predeterminado de CNY para USDT y USDC.
  • /auth/*
  • /api-keys/*
  • /notification-channels/*
  • /config
  • gestión de cadenas / gestión de tokens de cadena
  • Gestión de la dirección de billetera
  • gestión de la configuración

Normas sobre credenciales comerciales ​

GMPay ​

  • Identificador obligatorio del comercio: pid
  • Campo de firma: signature
  • Algoritmo de firma desde v2.0.0: HMAC-SHA256 sobre la cadena de parámetros canónica y no vacía, con clave utilizando la clave secreta habilitada de api_keys.secret_key que coincida con pid.
  • Los clientes de Pre-v2 GMPay MD5 deben actualizarse antes de implementar v2.0.0 o versiones posteriores.

Flujo compatible con EPay ​

  • Identificador obligatorio del comercio: pid
  • Campo de firma: sign
  • Clave de firma: la secret_key de la fila api_keys habilitada que coincida con pid.
  • sign_type es aceptado y, normalmente, se utiliza MD5.
  • EPay type acepta alipay o un selector compatible de token.network como usdt.tron. Los selectores aceptados se conservan en las funciones de devolución/notificación de EPay.
  1. Crear o inspeccionar las credenciales de los comerciantes en el panel de administración (pid + secret_key)
  2. Consulta /payments/gmpay/v1/config y lee data.supported_assets si el cliente necesita opciones de red/token dinámicas.
  3. Prefiera GMPay para nuevas integraciones.
  4. Utilice la redirección compatible con EPay únicamente cuando el sistema upstream (o de origen) lo requiera.
  5. Verifica los callbacks con la misma secret_key del comercio