Ir para o conteúdo

Integração com GMPay (recomendada) ​

Utilize o GMPay para todas as novas integrações.

Rota ​

text
POST /payments/gmpay/v1/order/create-transaction

Requisito de credencial de comerciante ​

Antes de chamar a API, crie ou consulte uma chave de API no painel de administração.

Você precisa:

  • pid
  • secret_key

Envie pid na requisição e use secret_key como chave de assinatura.

Solicitação mínima. ​

json
{
  "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 mensagem 401 Unauthorized. As solicitações compatíveis com EPay não serão afetadas.

  1. Mantenha todos os campos não vazios, exceto signature
  2. Ordene as chaves pela ordem ASCII
  3. Concatene os pares no formato key=value&...
  4. Calcule o HMAC-SHA256 usando a secret_key do lojista como chave HMAC
  5. Envie o resumo hexadecimal de 64 caracteres em minúsculas no campo signature

Rotas de companhia úteis ​

  • GET /payments/gmpay/v1/config
  • POST /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.