Integração compatível com EPay por redirecionamento
Utilize este fluxo somente quando o sistema upstream exigir uma entrada de pedido de redirecionamento no estilo EPay.
Rota
GET /payments/epay/v1/order/create-transaction/submit.php
POST /payments/epay/v1/order/create-transaction/submit.phpRequisito de credencial de comerciante
As solicitações de entrada não são validadas utilizando chaves de ambiente desatualizadas, como epay_pid ou epay_key.
A fonte atual faz o seguinte:
- Leia o
pidem trânsito. - Encontre a linha
api_keyshabilitada com aquele PID. - Verifique
signusando asecret_keydesse registro - Aplicar verificação opcional de lista de IPs permitidos
Campos obrigatórios
pidmoneyout_trade_nonotify_urlsign
Campos opcionais comuns:
return_urlnametypetokennetworkcurrencysign_type
type aceita dois formatos:
alipay— valor de compatibilidade; token/rede são resolvidos a partir dos parâmetros de solicitação explícitostoken+network, e, em seguida, a partir das configurações padrão do EPay do administrador.- O seletor
token.networkcomo, por exemplo,usdt.tron– é aceito somente quando essa combinação de token/rede é atualmente suportada. Um seletor válido substituitoken,network,epay.default_tokeneepay.default_network.
Outros valores não vazios para type são rejeitados como parâmetros inválidos. O type selecionado ou compatível é armazenado no pedido para callbacks futuros de retorno/notificação do EPay.
As configurações padrão do EPay.
Após a verificação da assinatura ser bem-sucedida, a fonte atual constrói o payload de pedido interno compartilhado, incluindo as configurações administrativas:
epay.default_tokenepay.default_currencyepay.default_network
Ordem de resolução para o EPay submit.php é:
- Suportado o seletor
type=token.network, caso seja fornecido. - Solicitação explícita dos parâmetros
token/network. - Administrar
epay.default_token/epay.default_network - Se ambos os tokens e a rede ainda estiverem vazios, crie um pedido de status “
4” como placeholder para o fluxo de seleção do caixa.
A moeda é independente: solicitar currency → epay.default_currency → cny.
Comportamento de sucesso
Em caso de sucesso, o destino redireciona o navegador para:
/pay/checkout-counter/{trade_id}At a fonte, esse caminho agora é a entrada de redirecionamento para a SPA (aplicação web) de caixa. Os dados da página de checkout são servidos através de:
/pay/checkout-counter-resp/{trade_id}Escolhas diretas de token/rede
Para as listas de métodos de pagamento "New API" upstream, expor opções separadas, onde o type é um seletor token.network suportado. Por exemplo, usdt.tron cria uma ordem USDT TRON diretamente, enquanto usdt.binance cria uma ordem USDT Binance/BSC quando esse ativo é habilitado.
Lista de métodos de origem:
[
{ "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 é apenas um nome genérico de opção de nível superior. Não envie-o sem alterações para o submit.php do EPay; não envie sem um type, type=alipay, ou um seletor válido como usdt.tron.
Verificação de callbacks
Quando o pedido criado contém payment_type = Epay, o processo em segundo plano chama a sua notify_url com parâmetros de consulta no formato EPay. A assinatura usa a mesma secret_key do lojista.
O campo type do callback reproduz o tipo armazenado na requisição: alipay ou um seletor aceito, como usdt.tron. Se a requisição omitir type, os callbacks enviados usam alipay por compatibilidade.
Não verifique essas chamadas de retorno com uma antiga epay_key isolada.