Disputa

DisputaWebhook POST

Quando uma nova disputa é aberta ou quando seu status é alterado, a Xsolla envia um webhook com o tipo dispute ao URL do webhook. Para receber esse webhook, contate seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.

Request

Request Body schema: application/json

notification_type

required

string

Tipo de notificação.

action

required

string

Tipo de ação.

Enum:	Description
adding	Uma nova disputa foi aberta.
updating	O status de uma disputa foi alterado.

required

object

Objeto com informações sobre a transação.

required

integer

ID de transação.

date_create

required

string

Data de pagamento.

required

object

Objeto com informações sobre a quantia da transação.

amount required	number <float> Quantia de pagamento.
currency required	string Moeda. Código da moeda de três letras de acordo com o ISO 4217.

payment_method

required

string

Método de pagamento.

Enum:	Description
credit_debit_card	Cartão de crédito ou débito
paypal	PayPal

country_code

required

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.

external_id

string

ID de transação externo. Consulte o FAQs para saber mais.

required

object

Objeto com informações sobre as configurações de projeto personalizadas.

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

required

object

Objeto com informações sobre um usuário.

id required	string ID de usuário.
email	string E-mail do usuário.

required

object

Objeto com informações sobre a disputa.

incoming_date

required

string

Data da abertura da disputa de acordo com o padrão RFC 3339.

reason

required

string

Motivo para a abertura da disputa. Consulte documentation para obter uma descrição dos grupos de motivos.

Enum: "non_receipt" "not_as_described" "duplicate_processing" "paid_by_other_means" "incorrect_amount" "credit_not_processed" "general" "fraud" "cancelled_recurring" "cancelled_merchandise" "late_presentment" "no_authorization" "problem_with_remittance" "other"

type

required

string

Tipo de disputa.

Enum:	Description
1st_time_chargeback	1º chargeback
2nd_time_chargeback	2º chargeback (pré-arbitragem).
arbitration	Resolvendo uma disputa entre o banco emissor e o comerciante quando o 1º chargeback e o 2º chargeback foram rejeitados.
chargeback	1º chargeback
chargeback_reversal	O chargeback foi revogado.
claim	Um disputa entre um cliente e um comerciante no PayPal.
dispute	Um titular de cartão solicitou dados de pagamento ao banco.
inquiry	Um titular de cartão solicitou dados de pagamento ao banco.
other	Utilizado para tipos de chargeback não cobertos por qualquer outro tipo.
reimbursement	O reembolso foi feito.
reimbursement_reversal	O chargeback foi revogado.
representment	A equipe de gerenciamento de chargebacks enviou evidências ao sistema de pagamento.
representment_reversal	O chargeback foi revogado.
retrieval	Um titular de cartão solicitou dados de pagamento ao banco.

status

required

string

Status da disputa.

Enum:	Description
accepted	Aceita
lost	Perdida
new	Nova
no_actions_required	Em progresso
won	Ganha

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
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Authorization: Signature 32c64a80d2527dc08906ae1891bac4489509b9f6' \
-d '{
  "notification_type": "dispute",
  "action": "adding",
  "transaction": {
    "id": 123456789,
    "date_create": "2023-08-24T10:21:00+04:00",
    "total": {
      "amount": 1,
      "currency": "EUR"
    },
    "payment_method": "credit_debit_card"
  },
  "settings": {
    "project_id": 18404,
    "merchant_id": 2340
  },
  "user": {
    "id": "1234567",
    "email": "email@example.com",
    "country_code": "US"
  },
  "dispute": {
    "incoming_date": "2024-01-25T01:02:03+04:00",
    "reason": "not_as_described",
    "type": "retrieval",
    "status": "new"
  }
}'

Response samples

application/json

{"error": {"code": "INCORRECT_AMOUNT",
"message": "Incorrect amount"
}
}