# Reembolso parcial 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. Ao salvar o URL do webhook na Conta de Distribuidor, você pode conceder permissões para receber informações detalhadas nos webhooks. Para fazer isso, defina a seguinte opção como ativa na Conta de Distribuidor na seção Project settings > Webhooks > Advanced settings. Observação Se você se registrou na Conta de Distribuidor no dia 22 de janeiro de 2025 ou antes, você encontrará as opções na seção Project settings > Webhooks > Testing > Payments > 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:saved_payment_method:0 — o método de pagamento guardado não foi utilizado1 — o método de pagamento foi salvo ao efetuar o pagamento atual2 — o método de pagamento previamente guardado é utilizadopayment_type:1 — pagamento único2 — pagamento recorrente 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. Endpoint: POST partial-refund Version: 1.0 ## Request fields (application/json): - `custom_parameters` (object) Seus parâmetros personalizados. - `notification_type` (string, required) Tipo de notificação. - `payment_details` (object, required) Detalhes de pagamento (objeto). - `payment_details.direct_wht` (object) Imposto retido direto na fonte. - `payment_details.direct_wht.amount` (number) Quantia. - `payment_details.direct_wht.currency` (string) Moeda. Código da moeda de três letras de acordo com o [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). - `payment_details.direct_wht.percent` (number) Alíquota de retenção direta na fonte. - `payment_details.payment` (object) Valor pago pelo usuário (objeto). - `payment_details.payment_method_fee` (object) Taxa do sistema de pagamento. - `payment_details.payment_method_sum` (object) Valor debitado do sistema de pagamento. - `payment_details.payout` (object) Dados de pagamento (objeto). - `payment_details.payout_currency_rate` (string) Taxa de câmbio entre as moedas de pagamento e remuneração. - `payment_details.repatriation_commission` (object) Objeto com dados sobre os custos de repatriamento, imposto à Xsolla por terceiros. - `payment_details.sales_tax` (object) Imposto sobre vendas (objeto; apenas EUA e Canadá). - `payment_details.sales_tax.percent` (number) Alíquota de imposto sobre vendas. - `payment_details.vat` (object) Dados do IVA (objeto; apenas na UE). - `payment_details.vat.percent` (number) Taxa de IVA. - `payment_details.xsolla_balance_sum` (object) Valor debitado do saldo Xsolla. - `payment_details.xsolla_fee` (object) Taxa Xsolla (objeto). - `purchase` (object) Dados da compra (objeto). - `purchase.checkout` (object) Dados do checkout (objeto). - `purchase.checkout.amount` (number) Valor da compra. - `purchase.total` (object, required) Preço total de compra (objeto). - `purchase.total.amount` (number) Quantia do reembolso parcial. - `refund_details` (object) Detalhes do reembolso (objeto). - `refund_details.author` (string) Iniciador de reembolso. O valor do campo é passado de acordo com a tabela: Iniciador de reembolso Valor do campo Jogo (via API). API Usuário da Publisher Account (reembolso automático). E-mail do usuário Usuário da Publisher Account (com assistência do suporte ao cliente Xsolla). support@xsolla.com Xsolla (com assistência do suporte ao cliente Xsolla). support@xsolla.com - `refund_details.code` (integer) ID do código. - `refund_details.date` (string) Data do reembolso. - `refund_details.reason` (string) Motivo do reembolso. - `settings` (object) Configurações personalizadas do projeto (objeto). - `settings.merchant_id` (integer) ID de comerciante. - `settings.project_id` (integer) ID do projeto. Você pode encontrar esse parâmetro em sua [Conta de Distribuidor](https://publisher.xsolla.com/) ao lado do nome do projeto. - `transaction` (object, required) Detalhes da transação (objeto). - `transaction.agreement` (integer) ID do contrato. - `transaction.date` (string) Data da transação. - `transaction.dry_run` (integer) Transação de teste. O parâmetro tem valor 1 se for uma transação de teste ou não for enviado se a transação for real. - `transaction.external_id` (string) ID externo de transação. - `transaction.id` (integer) ID de transação. - `user` (object) Dados do usuário (objeto). - `user.country` (string) País do usuário. Código de país de duas letras maiúsculas, de acordo com o [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). - `user.email` (string) E-mail do usuário. - `user.id` (string, required) ID de usuário. - `user.ip` (string) IP do usuário. - `user.name` (string) Nome de usuário. - `user.phone` (string) Telefone do usuário. - `user.zip` (string) CEP ou código postal do usuário. ## Response 400 fields (application/json): - `error` (object) - `error.code` (string) - `error.message` (string) ## Response 204 fields ## Response 500 fields