Xsolla-logo

Reembolso parcialWebhook POST

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:

  • saved_payment_method:
    • 0 — o método de pagamento guardado não foi utilizado
    • 1 — o método de pagamento foi salvo ao efetuar o pagamento atual
    • 2 — o método de pagamento previamente guardado é utilizado
  • payment_type:
    • 1 — pagamento único
    • 2 — 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.
Request
Request Body schema: application/json
notification_type
required
string

Tipo de notificação.

required
object

Detalhes da transação (objeto).

agreement
integer

ID do contrato.

date
string

Data da transação.

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.

external_id
string

ID externo de transação.

id
integer

ID de transação.

required
object

Detalhes de pagamento (objeto).

object

Imposto retido direto na fonte.

amount
number <float>

Quantia.

currency
string

Moeda. Código da moeda de três letras de acordo com o ISO 4217.

percent
number <float>

Alíquota de retenção direta na fonte.

object

Valor pago pelo usuário (objeto).

amount
number <float>

Quantia.

currency
string

Moeda. Código da moeda de três letras de acordo com o ISO 4217.

object

Taxa do sistema de pagamento.

amount
number <float>

Quantia.

currency
string

Moeda. Código da moeda de três letras de acordo com o ISO 4217.

object

Valor debitado do sistema de pagamento.

amount
number <float>

Quantia.

currency
string

Moeda. Código da moeda de três letras de acordo com o ISO 4217.

object

Dados de pagamento (objeto).

amount
number <float>

Quantia.

currency
string

Moeda. Código da moeda de três letras de acordo com o ISO 4217.

payout_currency_rate
string

Taxa de câmbio entre as moedas de pagamento e remuneração.

object

Objeto com dados sobre os custos de repatriamento, imposto à Xsolla por terceiros.

amount
number <float>

Quantia.

currency
string

Moeda. Código da moeda de três letras de acordo com o ISO 4217.

object

Imposto sobre vendas (objeto; apenas EUA e Canadá).

amount
number <float>

Quantia.

currency
string

Moeda. Código da moeda de três letras de acordo com o ISO 4217.

percent
number <float>

Alíquota de imposto sobre vendas.

object

Dados do IVA (objeto; apenas na UE).

amount
number <float>

Quantia.

currency
string

Moeda. Código da moeda de três letras de acordo com o ISO 4217.

percent
number <float>

Taxa de IVA.

object

Valor debitado do saldo Xsolla.

amount
number <float>

Quantia.

currency
string

Moeda. Código da moeda de três letras de acordo com o ISO 4217.

object

Taxa Xsolla (objeto).

amount
number <float>

Quantia.

currency
string

Moeda. Código da moeda de três letras de acordo com o ISO 4217.

custom_parameters
object

Seus parâmetros personalizados.

object

Dados da compra (objeto).

required
object

Preço total de compra (objeto).

amount
number <float>

Quantia do reembolso parcial.

currency
string

Moeda. Código da moeda de três letras de acordo com o ISO 4217.

object

Dados do checkout (objeto).

amount
number <float>

Valor da compra.

currency
string

Moeda. Código da moeda de três letras de acordo com o ISO 4217.

object

Detalhes do reembolso (objeto).

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
code
integer

ID do código.

date
string

Data do reembolso.

reason
string

Motivo do reembolso.

object

Configurações personalizadas do projeto (objeto).

merchant_id
integer

ID de comerciante.

project_id
integer

ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.

object

Dados do usuário (objeto).

id
required
string

ID de usuário.

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.

email
string

E-mail do usuário.

ip
string

IP do usuário.

name
string

Nome de usuário.

phone
string

Telefone do usuário.

zip
string

CEP ou código postal do usuário.

Responses
204

Retorne para indicar o processamento bem-sucedido.

400

Retorne em caso de erro nas informações fornecidas (por exemplo, um parâmetro obrigatório ausente, falha na autorização, etc.).

500

Retorne para indicar erros temporários com seus servidores.

Request samples
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
            }
        }
    }
}'
Response samples
application/json
{
  • "error": {
    }
}