Implementação
Segurança
Para garantir a segurança, a Xsolla utiliza:
Observação
Chaves API são geradas pela Xsolla e são exclusivas de cada provedor.
Cabeçalhos
Solicitações de entrada da Xsolla contendo os seguintes cabeçalhos:
| Cabeçalho | Descrição | Obrigatório |
|---|---|---|
Request-Id | ID de solicitação exclusivo. | Sim. |
Content-Digest | Valores checksum para o corpo da solicitação. | Sim se houver um corpo de solicitação. |
Signature-Input | Parâmetros usados para gerar a assinatura. | Sim. |
Signature | Assinatura da solicitação. | Sim. |
Prefer | Dados adicionais, ex.: environment=“sandbox”. | Não. |
Observação
Você deve incluir os mesmos cabeçalhos nos webhooks enviados à Xsolla.
Verificação de solicitações de entrada
Ao receber solicitações da Xsolla:
- Extraia a chave secreta que corresponde ao valor
keyiddo cabeçalhoSignature-Input. - Valide o período
created/expires. - Recupere o corpo da solicitação.
- Reconstrua a string da assinatura de acordo com
Signature-Inpute verifique a assinatura usando HMAC-SHA256.
Copy
- http
1sig1=("@method" "@target-uri" "content-digest" "request-id");alg="hmac-sha256";created=1700000000;expires=1700000600;keyid="acc_123"
- Use
Request-Idpara pesquisar pelas solicitações nos registros.
Funcionalidade obrigatória
Para a integração ser bem-sucedida, você deve implementar ao menos os seguintes métodos API:
| Método | Trajeto | Descrição |
|---|---|---|
| POST | /v1/payments | Cria pagamento. Retorna o objeto action. |
| PATCH | /v1/payments/{transaction_id} | Confirma o pagamento se action.type=confirm for retornado. |
| GET | /v1/payments/{transaction_id} | Recupera o status atual do pagamento. |
payment.succeeded— pagamento bem-sucedidopayment.failed— falha no pagamentopayment.refunded— reembolso
Observação
Consulte a especificação para obter descrições detalhadas de métodos API e webhooks.
Este artigo foi útil?
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.
