Xsolla-logoXsolla Developers
o
A Cuenta del editor

Validación del usuarioWebhook POST

Xsolla envía un webhook con el tipo user_validation a la dirección URL del webhook para verificar que un usuario esté registrado en el juego. La solicitud se envía varias veces como parte del proceso de pago:

  • cuando un usuario elige un método de pago en la interfaz de pago
  • cuando un usuario introduce datos en el formulario de pago, p. ej., los datos de la tarjeta bancaria o el código postal al pagar a través de PayPal
  • cuando un usuario hace clic en Pagar ahora para proceder al pago
  • cuando finalice el proceso de pago y el estado de la transacción cambie a done

La solicitud se envía al pagar con cualquier método de pago.

Al guardar la URL del webhook en Cuenta del editor, puede dar permisos para recibir información detallada en los webhooks. Para ello, active las opciones correspondientes en Cuenta del editor en Project settings > Webhooks > Advanced settings.

Nota

Si se registró en Cuenta del editor el 22 de enero de 2025 o antes, encontrará las opciones en Project settings > Webhooks > Testing > Payments > Advanced settings.

Conmutador Descripción
Enviar solamente los parámetros de usuario necesarios sin datos confidenciales

Solamente la siguiente información sobre el usuario se transmite en el webhook:

  • ID
  • país
Enviar parámetros personalizados La información sobre los parámetros de token personalizados se transmite en el webhook.
Request
Request Body schema: application/json
notification_type
required
string

Tipo de notificación.

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.

phone
string

Teléfono del 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.).

500

Devuelve para indicar errores temporales en sus servidores.

Request samples
curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Signature 13342703ccaca5064ad33ba451d800c5e823db8f' \
-d '{
    "notification_type":"user_validation",
    "settings": {
      "project_id": 18404,
      "merchant_id": 2340
    },
    "user": {
        "ip": "127.0.0.1",
        "phone": "18777976552",
        "email": "[email protected]",
        "id": "1234567",
        "name": "John Smith",
        "country": "US"
    }
}'
Response samples
application/json
{
  • "error": {
    }
}
OSZAR »