Ir al contenido

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 ​

text
GET /payments/epay/v1/order/create-transaction/submit.php
POST /payments/epay/v1/order/create-transaction/submit.php

Requisito 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:

  1. Leer el pid entrante.
  2. Encuentra la fila api_keys habilitada con ese PID.
  3. Verifica sign con la secret_key de ese registro
  4. Aplicar verificación opcional de lista blanca de IP.

Campos obligatorios ​

  • pid
  • money
  • out_trade_no
  • notify_url
  • sign

Campos opcionales comunes:

  • return_url
  • name
  • type
  • token
  • network
  • currency
  • sign_type

type admite dos formatos:

  • alipay — valor de compatibilidad; el token/red se resuelven a partir de los parámetros explícitos de la solicitud token + network, y posteriormente a partir de los valores predeterminados de EPay del administrador.
  • El selector token.network como usdt.tron — solo se acepta cuando la combinación de ese token/red está actualmente soportada. Un selector válido anula token, network, epay.default_token y epay.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_token
  • epay.default_currency
  • epay.default_network

Orden de resolución para EPay submit.php es:

  1. Se admite el selector type=token.network, si se proporciona.
  2. Solicitud explícita de los parámetros token / network.
  3. Administrar epay.default_token / epay.default_network
  4. Si tanto el token como la red siguen estando vacíos, crear un pedido con estado 4 como 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:

text
/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:

text
/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:

json
[
  { "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.