Pago rechazado

Xsolla Developers

Pago rechazadoWebhook POST

Si una transacción es rechazada por un sistema de pago, Xsolla envía los detalles de la transacción en un webhook del tipo ps_declined a la URL configurada de su webhook. El webhook se envía durante la fase de autorización o de procesamiento del pago. En este caso, el webhook payment\ order_paid no se envía.

Razones habituales del rechazo por parte de los sistemas de pago:

Se produjo un error en la autorización de la tarjeta (por ejemplo, el sistema de pago no pudo finalizar el proceso de autorización debido a un error técnico o a la falta de respuesta del banco) o la transacción fue rechazada (por ejemplo, el banco respondió pero denegó la transacción por fondos insuficientes o porque los datos de la tarjeta no eran válidos).
Se produjo un error en la verificación 3-D Secure, no se ha realizado o se agotó el tiempo de confirmación del usuario.
El procesador o el banco adquirente no está disponible temporalmente o devuelve un rechazo definitivo debido a un error irreversible, como una cuenta cerrada o un número de tarjeta no válido. Volver a intentarlo sin solucionar el problema de fondo no resultará en una transacción satisfactoria.

No debe confundirse con:

Rechazos por el sistema antifraude, que se notifican mediante el webhook afs_reject.
Reembolsos y reembolsos parciales tras un pago realizado con éxito, que se notifican mediante los webhooks refund y partial_refund.

Observación

Para recibir el webhook ps_declined, 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.

required

object

Datos de la transacción (objeto).

dry_run	integer Transacción de prueba. El parámetro tiene el valor 1 si es una transacción de prueba, o no se envía si la transacción es real.
external_id	string ID externo de la transacción.
id	integer ID de la transacción.
payment_method	integer ID del método de pago.

object

Detalles del reembolso (objeto).

author

string

Iniciador del reembolso. El valor del campo se transmite de acuerdo con la tabla:

Iniciador del reembolso	Valor de campo
Juego (vía API).	API
Usuario de Cuenta del editor (reembolso automático).	Correo electrónico del usuario
Usuario de Cuenta del editor (con asistencia del servicio de atención al cliente de Xsolla).	support@xsolla.com
Xsolla (con asistencia del servicio de atención al cliente de Xsolla).	support@xsolla.com

code

integer

ID del código.

reason

string

Motivo del reembolso.

object

Configuración del proyecto personalizada (objeto).

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

object

Datos del usuario (objeto).

id required	string ID de usuario.
country	string Código de país. Dos letras mayúsculas de conformidad con la norma ISO 3166-1 alpha-2.
email	string Correo electrónico del usuario.
ip	string IP del usuario.
name	string Nombre de usuario.

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.). En este caso, se carga el importe en la cuenta del usuario, pero hay un fallo en la compra. Para hacer un reembolso, contacte con el servicio de atención al cliente de Xsolla escribiendo a support@xsolla.com.

500

Devuelve para indicar errores temporales en sus servidores.

Request samples

CURL
PHP
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Signature 80543ba63e1e50cf05f15150fe75e7245da9a898' \
-d '{
  "notification_type": "ps_declined",
  "settings": {
    "project_id": "18404",
    "merchant_id": "2340"
  },
  "user": {
    "ip": "127.0.0.1",
    "email": "email@example.com",
    "id": "1234567",
    "country": "US"
  },
  "transaction": {
    "id": "1",
    "dry_run": "1",
    "payment_method": "1"
  },
  "refund_details": {
    "author": "support@xsolla.com",
    "code": "8",
    "reason": "Cancellation by the PS request",
    "reason_detail": "Insufficient funds"
  }
}'

Response samples

application/json

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