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
| Finalidad | Método | Ruta | Autenticación |
|---|---|---|---|
| Crear un pedido GMPay | POST | /payments/gmpay/v1/order/create-transaction | HMAC-SHA256 del comercio |
| Consultar configuración | GET | /payments/gmpay/v1/config | Público |
| Abrir la página de pago | GET | /pay/checkout-counter/{trade_id} | Público |
| Consultar los datos del pago | GET | /pay/checkout-counter-resp/{trade_id} | Público |
| Consultar estado del pedido | GET | /pay/check-status/{trade_id} | Público |
| Seleccionar red o proveedor | POST | /pay/switch-network | Público |
| Enviar el hash de la transacción | POST | /pay/submit-tx-hash/{trade_id} | Público |
| Volver al comercio | GET | /pay/return/{trade_id} | Redirección del navegador |
| Crear un pedido EPay | GET o POST | /payments/epay/v1/order/create-transaction/submit.php | MD5 del comercio |
| Recibir una notificación de OKPay | POST | /payments/okpay/v1/notify | Firma 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.modeadmitefixedoauto. El modo fijo usarate.forced_rate_list. El automático consultarate.api_url, guarda en caché las respuestas correctas por moneda base y conserva la última caché persistente si falla la actualización. Dejarrate.forced_rate_listvací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 deapi_keys.secret_keyque coincida conpid. - Los clientes de Pre-v2 GMPay MD5 deben actualizarse antes de implementar
v2.0.0o versiones posteriores.
Flujo compatible con EPay
- Identificador obligatorio del comercio:
pid - Campo de firma:
sign - Clave de firma: la
secret_keyde la filaapi_keyshabilitada que coincida conpid. sign_typees aceptado y, normalmente, se utilizaMD5.- EPay
typeaceptaalipayo un selector compatible detoken.networkcomousdt.tron. Los selectores aceptados se conservan en las funciones de devolución/notificación de EPay.
Orden de integración recomendado
- Crear o inspeccionar las credenciales de los comerciantes en el panel de administración (
pid+secret_key) - Consulta
/payments/gmpay/v1/configy leedata.supported_assetssi el cliente necesita opciones de red/token dinámicas. - Prefiera GMPay para nuevas integraciones.
- Utilice la redirección compatible con EPay únicamente cuando el sistema upstream (o de origen) lo requiera.
- Verifica los callbacks con la misma
secret_keydel comercio