API para lojistas
GMPay é o protocolo de comércio principal. EPay é um adaptador de compatibilidade que utiliza o mesmo credencial, serviço de pedidos, regras de idempotência, máquina de estados, processo de checkout, comportamento de consulta e pipeline de callback.
Para campos e valores de status de fontes confiáveis, utilize a página /docs da instância implantada ou o contrato OpenAPI rastreado no repositório: public/openapi.yaml.
Assinaturas GMPay
As requisições do GMPay incluem um pid numérico e uma signature HMAC-SHA256 em minúsculas.
Para assinar um pedido:
- Exclua
signaturee os valores vazios. - Classificar os campos pela ordem de chave ASCII.
- Una os pares
key=valuecom&. - Utilize o credencial "Secret" como a chave HMAC.
- Calcular HMAC-SHA256 em letras minúsculas.
Crie ordem.
POST /payments/gmpay/v1/order/create-transaction
Reutilizar um order_id existente não cria um segundo pedido. Excluir tanto o token quanto o network cria um pedido selecionável; o GMPay Edge não define silenciosamente para a TRON.
Consulta de pedido
GET /payments/gmpay/v1/order/query
Informe apenas um dos campos, trade_id ou order_id, e assine a requisição com a mesma credencial. Cada credencial só pode consultar os pedidos que criou.
Receber retornos/ligações de volta
O comerciante fornece o notify_url ao criar um pedido. Os destinos de callback devem passar a instância SSRF e a política de segurança.
Os eventos entregues possuem assinaturas determinísticas, tentativas preservadas, tentativas limitadas, e um caminho de repetição manual auditado. Os manipuladores devem verificar a assinatura, processar eventos duplicados de forma idempotente, e somente confirmar após a atualização do estado local.
Para as chamadas de retorno do GMPay, retorne um texto simples "ok" com código HTTP 200 após o processamento bem-sucedido.
Compatibilidade EPay
A compatibilidade do EPay utiliza a mesma credencial e fluxo de pedidos, mas mantém o sistema de fronteira MD5 do EPay legado para solicitações de entrada e callbacks compatíveis.