# 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.php
```

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

1. Leia o `pid` em trânsito.
2. Encontre a linha `api_keys` habilitada com aquele PID.
3. Verifique `sign` usando a `secret_key` desse registro
4. Aplicar verificação opcional de lista de IPs permitidos

## Campos obrigatórios 

* `pid`
* `money`
* `out_trade_no`
* `notify_url`
* `sign`

Campos opcionais comuns:

* `return_url`
* `name`
* `type`
* `token`
* `network`
* `currency`
* `sign_type`

`type` aceita dois formatos:

* `alipay` — valor de compatibilidade; token/rede são resolvidos a partir dos parâmetros de solicitação explícitos `token` \+ `network`, e, em seguida, a partir das configurações padrão do EPay do administrador.
* O seletor `token.network` como, por exemplo, `usdt.tron` – é aceito somente quando essa combinação de token/rede é atualmente suportada. Um seletor válido substitui `token`, `network`, `epay.default_token` e `epay.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_token`
* `epay.default_currency`
* `epay.default_network`

Ordem de resolução para o EPay submit.php é:

1. Suportado o seletor `type=token.network`, caso seja fornecido.
2. Solicitação explícita dos parâmetros `token` / `network`.
3. Administrar `epay.default_token` / `epay.default_network`
4. 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.
