Integração com GMPay (recomendada)
Utilize o GMPay para todas as novas integrações.
Rota
POST /payments/gmpay/v1/order/create-transactionRequisito de credencial de comerciante
Antes de chamar a API, crie ou consulte uma chave de API no painel de administração.
Você precisa:
pidsecret_key
Envie pid na requisição e use secret_key como chave de assinatura.
Solicitação mínima.
{
"pid": "1000",
"order_id": "ORD20260424001",
"currency": "cny",
"token": "usdt",
"network": "tron",
"amount": 100,
"notify_url": "https://merchant.example.com/notify",
"signature": "hmac-sha256-hex(...)"
}Regra de assinatura
A partir da versão
v2.0.0, o GMPay utiliza HMAC-SHA256 em vez de MD5. É necessário atualizar os clientes antes de implementar a versão v2, caso contrário, eles receberão a mensagem401 Unauthorized. As solicitações compatíveis com EPay não serão afetadas.
- Mantenha todos os campos não vazios, exceto
signature - Ordene as chaves pela ordem ASCII
- Concatene os pares no formato
key=value&... - Calcule o HMAC-SHA256 usando a
secret_keydo lojista como chave HMAC - Envie o resumo hexadecimal de 64 caracteres em minúsculas no campo
signature
Rotas de companhia úteis
GET /payments/gmpay/v1/configPOST /pay/switch-network
Se o cliente precisar de opções de rede/tokens dinâmicas, leia-as de data.supported_assets na resposta do /payments/gmpay/v1/config.
Consulte data.site para a identidade visual e data.epay, data.okpay e data.xlayer para as configurações de checkout.
Verificação de callbacks
As chamadas de retorno do GMPay são enviadas como JSON POST para o notify_url.
Verifique a assinatura HMAC-SHA256, confira se o pagamento corresponde ao pedido e processe-o de forma idempotente. Confirme o recebimento com HTTP 200 e o texto simples ok ou success, sem distinção entre maiúsculas e minúsculas.
Anotação de resposta bem-sucedida
A fonte atual inclui payment_url nas respostas de criação de pedidos bem-sucedidas, permitindo que o chamador tenha um destino de redirecionamento de checkout hospedado, em vez de reconstruir essa URL manualmente.