Quando um reembolso parcial é feito, a Xsolla envia detalhes da transação
cancelada em um webhook com o tipo partial_refund
para o URL do webhook.
Saiba mais sobre o processo de reembolso parcial nestas instruções.
When you save the webhook URL in Publisher Account, you can give permissions to receive detailed information in webhooks. To do that, set the following toggle to active in Publisher Account in the Project settings > Webhooks > Advanced settings section.
Note
If you registered in Publisher Account on or before January 22, 2025, you can find the toggles in the Project settings > Webhooks > Testing > Payments > Advanced settings section.
Opção | Descrição |
---|---|
Exibir informações sobre transações pelos métodos de pagamento salvos | As informações são passadas nos seguintes parâmetros personalizados do webhook:
|
Códigos de reembolso:
Código | Motivo | Descrição |
---|---|---|
1 | Cancellation by the user request / the game request | Cancelamento iniciado a partir da Publisher Account. |
3 | Integration error | Problemas na integração entre a Xsolla e o jogo. Recomendação: não adicione o usuário à lista de bloqueio. |
5 | Test payment | Transação de teste seguida de cancelamento. Recomendação: não adicione o usuário à lista de bloqueio. |
7 | Fraud notification from PS | Pagamento recusado pelo sistema de pagamento. Potencial fraude detectada pelo PS. Recomendação: adicionar o usuário à lista de bloqueio. |
9 | Cancellation by the user request | O usuário não ficou satisfeito com o jogo ou a compra por qualquer motivo. Recomendação: não adicionar o usuário à lista de bloqueio. |
10 | Cancellation by the game request | Cancelamento solicitado pelo jogo. Recomendação: não adicionar o usuário à lista de bloqueio. |
notification_type required | string Tipo de notificação. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
required | object Detalhes da transação (objeto). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
required | object Detalhes de pagamento (objeto). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
custom_parameters | object Seus parâmetros personalizados. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object Dados da compra (objeto). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object Detalhes do reembolso (objeto). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object Configurações personalizadas do projeto (objeto). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object Dados do usuário (objeto). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Retorne para indicar o processamento bem-sucedido.
Retorne em caso de erro nas informações fornecidas (por exemplo, um parâmetro obrigatório ausente, falha na autorização, etc.).
Retorne para indicar erros temporários com seus servidores.
curl -v 'https://your.hostname/your/uri' \ -X POST \ -d '{ "notification_type": "partial_refund", "settings": { "project_id": 18404, "merchant_id": 2340 }, "purchase": { "checkout": { "currency": "USD", "amount": 50 }, "total":{ "currency": "USD", "amount": 200 } }, "user": { "ip": "127.0.0.1", "phone": "18777976552", "email": "email@example.com", "id": "1234567", "name": "John Smith", "country": "US" }, "transaction": { "id": 1, "external_id": 1, "dry_run": 1, "agreement": 1, "date": "2022-03-01 10:53:15" }, "refund_details": { "author": "email@example.com", "date": "2022-03-01 10:56:48" }, "payment_details": { "sales_tax": { "currency": "USD", "amount": 0 }, "direct_wht": { "currency": "USD", "amount": 0.70 }, "xsolla_fee": { "currency": "USD", "amount": "10" }, "payout": { "currency": "USD", "amount": "200" }, "payment_method_fee": { "currency": "USD", "amount": "20" }, "payment": { "currency": "USD", "amount": "230" }, "repatriation_commission": { "currency": "USD", "amount": 10 } } } }'
{- "error": {
- "code": "INCORRECT_AMOUNT",
- "message": "Incorrect amount"
}
}