API para comercios
GMPay es el protocolo comercial principal. EPay es un adaptador de compatibilidad que utiliza el mismo sistema de credenciales, servicio de pedidos, reglas de idempotencia, máquina de estados, proceso de checkout, comportamiento de consulta y canal de callback.
Para campos de autoridad y valores de estado, utilice la página /docs de la instancia desplegada o el contrato OpenAPI rastreado del repositorio: public/openapi.yaml.
Firmas de GMPay
Las solicitudes de GMPay incluyen un pid numérico y una signature HMAC-SHA256 en minúsculas.
Para firmar una solicitud:
- Excluye
signaturey los valores vacíos. - Ordenar los campos por el orden de los caracteres ASCII.
- Une los pares
key=valuecon&. - Utilice el credencial "Secret" como clave HMAC.
- Calcular HMAC-SHA256 en minúsculas.
Establecer orden.
POST /payments/gmpay/v1/order/create-transaction
Reutilizar un order_id existente no crea un segundo pedido. Omitir tanto el token como la network crea un pedido seleccionable; GMPay Edge no lo establece silenciosamente en TRON.
Solicitud de orden
GET /payments/gmpay/v1/order/query
Indica exactamente uno de los dos campos, trade_id u order_id, y firma la solicitud con la misma credencial. Cada credencial solo puede consultar los pedidos que creó.
Recibir llamadas de retorno
El comerciante proporciona la URL notify_url al crear un pedido. Los destinos de llamada (callbacks) deben pasar la instancia de SSRF y la política de seguridad.
Los eventos entregados tienen firmas deterministas, intentos conservados, reintentos limitados y una ruta de reintento manual auditada. Los manejadores deben verificar la firma, procesar eventos duplicados de forma idempotente y solo confirmar una vez que se haya confirmado el estado local.
Para las respuestas de GMPay, devuelve texto plano "ok" con código HTTP 200 después del procesamiento exitoso.
Compatibilidad con EPay
La compatibilidad de EPay utiliza la misma credencial y flujo de procesamiento de pedidos, pero mantiene el límite MD5 de EPay heredado para las solicitudes entrantes y las llamadas de retorno compatibles.