Disputa

DisputaWebhook POST

Cuando se abre una nueva disputa o una disputa cambia de estado, Xsolla envía un webhook con el tipo dispute a la URL del webhook. Para recibir este webhook, contacte con su gestor de éxito del cliente o envíe un correo electrónico a csm@xsolla.com.

Request

Request Body schema: application/json

notification_type

required

string

Tipo de notificación.

action

required

string

Tipo de acción.

Enum:	Description
adding	Se ha abierto una nueva disputa.
updating	El estado de una disputa ha cambiado.

required

object

Objeto con información sobre la transacción.

required

integer

ID de la transacción.

date_create

required

string

Fecha de pago.

required

object

Objeto con información sobre el importe de la transacción.

amount required	number <float> Importe del pago.
currency required	string Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

payment_method

required

string

Método de pago.

Enum:	Description
credit_debit_card	Tarjeta de crédito o débito
paypal	PayPal

country_code

required

string

Código de país. Dos letras mayúsculas de conformidad con la norma ISO 3166-1 alpha-2.

external_id

string

ID externo de la transacción. Consulte FAQs para obtener información detallada.

required

object

Objeto con información sobre la configuración del proyecto personalizada.

project_id required	integer ID del proyecto. Encontrará este parámetro en su cuenta Publisher junto al nombre del proyecto.
merchant_id required	integer ID de vendedor.

required

object

Objeto con información sobre un usuario.

id required	string ID de usuario.
email	string Correo electrónico del usuario.

required

object

Objeto con información sobre la disputa.

incoming_date

required

string

Fecha de apertura de la disputa según la norma RFC 3339.

reason

required

string

Motivo de la apertura de la disputa. Consulte la documentación para obtener una descripción de los 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	Primer contracargo.
2nd_time_chargeback	Segundo contracargo (previo al arbitraje).
arbitration	Resolver una disputa entre el banco emisor y el comerciante cuando se rechazaron el 1.er contracargo y el 2.º contracargo.
chargeback	Primer contracargo.
chargeback_reversal	El contracargo ha sido revocado.
claim	Una disputa en PayPal entre un cliente y un comerciante.
dispute	Un titular de tarjeta ha solicitado los detalles del pago al banco.
inquiry	Un titular de tarjeta ha solicitado los detalles del pago al banco.
other	Se utiliza para los tipos de contracargos no cubiertos por ningún otro tipo.
reimbursement	Se ha realizado el reembolso.
reimbursement_reversal	El contracargo ha sido revocado.
representment	El equipo de gestión de contracargos ha enviado las pruebas al sistema de pago.
representment_reversal	El contracargo ha sido revocado.
retrieval	Un titular de tarjeta ha solicitado los detalles del pago al banco.

status

required

string

Estado de la disputa.

Enum:	Description
accepted	Aceptada
lost	Perdida
new	Nueva
no_actions_required	En curso
won	Ganada

Responses

204

Devuelve para indicar un procesamiento realizado correctamente.

400

Devuelve en caso de error en la información proporcionada (p. ej., falta un parámetro obligatorio, autorización fallida, etc.).

500

Devuelve para indicar errores temporales en sus 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"
}
}