Integración compatible con EPay mediante redirección
Utilice este flujo solo cuando su sistema previo requiera una entrada de orden de tipo EPay.
Ruta
GET /payments/epay/v1/order/create-transaction/submit.php
POST /payments/epay/v1/order/create-transaction/submit.phpRequisito de credenciales comerciales
Las solicitudes entrantes no se validan utilizando claves de entorno obsoletas como epay_pid o epay_key.
La fuente actual hace esto en cambio:
- Leer el
pidentrante. - Encuentra la fila
api_keyshabilitada con ese PID. - Verifica
signcon lasecret_keyde ese registro - Aplicar verificación opcional de lista blanca de IP.
Campos obligatorios
pidmoneyout_trade_nonotify_urlsign
Campos opcionales comunes:
return_urlnametypetokennetworkcurrencysign_type
type admite dos formatos:
alipay— valor de compatibilidad; el token/red se resuelven a partir de los parámetros explícitos de la solicitudtoken+network, y posteriormente a partir de los valores predeterminados de EPay del administrador.- El selector
token.networkcomousdt.tron— solo se acepta cuando la combinación de ese token/red está actualmente soportada. Un selector válido anulatoken,network,epay.default_tokenyepay.default_network.
Otros valores no vacíos para type son rechazados como parámetros inválidos. El type seleccionado o compatible se almacena en el pedido para las posteriores llamadas de devolución/notificación de EPay.
EPay: Por defecto, las opciones de EPay.
Tras la verificación de la firma, la fuente actual construye el paquete de datos interno y compartido para el pedido, incluyendo la configuración del administrador.
epay.default_tokenepay.default_currencyepay.default_network
Orden de resolución para EPay submit.php es:
- Se admite el selector
type=token.network, si se proporciona. - Solicitud explícita de los parámetros
token/network. - Administrar
epay.default_token/epay.default_network - Si tanto el token como la red siguen estando vacíos, crear un pedido con estado
4como marcador para el flujo de selección del cajero.
La moneda es independiente: solicitar currency → epay.default_currency → cny.
Comportamiento exitoso
En caso de éxito, la redirección del navegador se dirige a:
/pay/checkout-counter/{trade_id}En la fuente actual, esa ruta ahora es la entrada de redirección para el cajero alojado (SPA). Los datos de la página de pago se sirven a través de:
/pay/checkout-counter-resp/{trade_id}Elecciones directas de tokens/redes
Para las listas de métodos de pago "New API" en la parte superior, se deben exponer opciones separadas cuyo type sea un selector de token.network compatible. Por ejemplo, usdt.tron crea un pedido de USDT en TRON directamente, mientras que usdt.binance crea un pedido de USDT en Binance/BSC cuando ese activo está habilitado.
Lista de métodos de origen:
[
{ "color": "rgba(var(--semi-blue-5), 1)", "name": "GM Pay", "type": "custom1" },
{ "color": "rgba(var(--semi-blue-5), 1)", "name": "GM Pay usdt.binance", "type": "usdt.binance" },
{ "color": "rgba(var(--semi-blue-5), 1)", "name": "GM Pay usdt.tron", "type": "usdt.tron" }
]custom1 es simplemente un nombre genérico de opción de nivel superior. No lo envíe sin modificarlo a submit.php de EPay; no incluya type, type=alipay, o un selector válido como usdt.tron.
Verificación de callbacks
Si el pedido creado tiene payment_type = Epay, el proceso en segundo plano llama después a tu notify_url con parámetros de consulta en formato EPay. Los firma con la misma secret_key del comercio.
La función de devolución de llamada type reutiliza el tipo de solicitud almacenado. Esto significa que devuelve ya sea alipay o el selector aceptado, como usdt.tron. Si la solicitud omitió el parámetro type, las devoluciones de llamada externas retroceden a alipay para garantizar la compatibilidad.
No verifique esas llamadas de retorno con una antigua clave epay_key independiente.