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.
Você pode conceder permissões para receber informações detalhadas em webhooks. Para fazer isso, você pode definir a seguinte opção como On na Conta de Distribuidor na seção Project settings > Webhooks > Advanced settings:
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"
}
}