Contestation

ContestationWebhook POST

Lorsqu'une nouvelle contestation est ouverte ou lorsqu'une contestation change de statut, Xsolla envoie un webhook contenant le type de dispute à l'URL du webhook. Pour recevoir ce webhook, contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com.

Request

Request Body schema: application/json

notification_type

required

string

Type de notification.

action

required

string

Type d'action.

Enum:	Description
adding	Nouvelle contestation ouverte.
updating	Changement de statut de contestation.

required

object

Objet contenant des informations sur la transaction.

required

integer

ID de transaction.

date_create

required

string

Date de paiement.

required

object

Objet contenant des informations sur le montant de la transaction.

amount required	number <float> Montant du paiement.
currency required	string Devise. Code de devise à trois lettres selon la norme ISO 4217.

payment_method

required

string

Mode de paiement.

Enum:	Description
credit_debit_card	Carte de crédit ou de débit
paypal	PayPal

country_code

required

string

Pays de l'utilisateur. Code pays à deux lettres majuscules selon la norme ISO 3166-1 alpha-2.

external_id

string

External ID de la transaction. Pour obtenir des informations détaillée, reportez-vous à la FAQs.

required

object

Objet contenant des informations sur les paramètres personnalisés du projet.

project_id required	integer ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.
merchant_id required	integer ID de commerçant.

required

object

Objet contenant des informations sur l'utilisateur.

id required	string ID utilisateur.
email	string Adresse e-mail de l'utilisateur.

required

object

Objet contenant des informations sur la contestation.

incoming_date

required

string

Date d'ouverture de la contestation selon la norme RFC 3339.

reason

required

string

Motif de l'ouverture de la contestation. Référez-vous à la documentation pour une description des groupes de raisons.

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

Type de contestation.

Enum:	Description
1st_time_chargeback	1er chargeback.
2nd_time_chargeback	2e chargeback (pré-arbitrage).
arbitration	Résolution d'une contestation entre la banque émettrice et le commerçant lorsque le premier et le deuxième chargebacks ont été rejetés.
chargeback	1er chargeback.
chargeback_reversal	Le chargeback a été révoqué.
claim	Contestation entre un client et un commerçant sur PayPal.
dispute	Le titulaire de la carte a demandé les informations de paiement à la banque.
inquiry	Le titulaire de la carte a demandé les informations de paiement à la banque.
other	Utilisé pour les types de chargeback qui ne sont couverts par aucun autre type.
reimbursement	Le remboursement a été effectué.
reimbursement_reversal	Le chargeback a été révoqué.
representment	L'équipe de gestion des chargebacks a envoyé les preuves au système de paiement.
representment_reversal	Le chargeback a été révoqué.
retrieval	Le titulaire de la carte a demandé les informations de paiement à la banque.

status

required

string

Statut de la contestation.

Enum:	Description
accepted	Accepté
lost	Perdu
new	Nouveau
no_actions_required	En cours
won	Gagné

Responses

204

Renvoyez pour indiquer un traitement réussi.

400

Renvoyez en cas d'erreur dans les informations fournies (par exemple, un paramètre requis manquant, une autorisation échouée, etc.).

500

Renvoyez pour indiquer des erreurs temporaires liées à vos serveurs.

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"
}
}