Configuración de pagos

Validación del usuario

¿Qué es ID de usuario?

El ID de usuario es un parámetro que permite identificar a un usuario en un juego. Puede almacenar los ID de usuario en una base de datos. Cuando reciba ID de usuario inválidos, lance una excepción. Consulte el repositorio de GitHub para ver un ejemplo de validación de usuario.

¿Qué datos debo devolver una vez finalizada la validación?

Si la validación se realiza correctamente, devuelve el código HTTP 200. En caso de error, código 400 (INVALID_USER).

Personalización

¿Puedo personalizar el tema de la interfaz de pago?

Puede habilitar un tema oscuro enviando el parámetro settings.ui.theme = default_dark en el token. El tema oscuro permite establecer la imagen de fondo o cambiar el color de fondo (tal y como aparece en la demo). Para cambiar otros parámetros, contacte con su gestor del éxito del cliente o envíe un correo electrónico a csm@xsolla.com.

¿Puedo cambiar la apariencia de los correos electrónicos enviados a los usuarios?

Sí. Siga las instrucciones de sobre cómo personalizar los correos electrónicos para los usuarios. El orden de los elementos del correo electrónico no puede modificarse, ya que forman parte de una plantilla estándar. Esto es necesario según el acuerdo de licencia con Xsolla, que actúa como comerciante legal registrado.

En pruebas

¿Puedo utilizar tarjetas bancarias de prueba para probar el proceso de pago?

Sí, pero solo cuando ejecute su aplicación o la demo de Pay Station en modo aislador de proceso (sandbox). Consulte la lista general de tarjetas bancarias de prueba de diferentes marcas y países emisores.

¿Puedo probar el flujo de pago de PayPal en el modo sandbox?

Sí. Consulte información detallada en las instrucciones.

¿Cómo puedo probar los reembolsos de pagos?

Puede probar los reembolsos mediante la llamada API Solicitar reembolso. Consulte las instrucciones para obtener más información.

¿Qué es Pay Station demo e Invoice ID en la pestaña de pruebas de webhooks en Cuenta del editor?

El Xsolla Invoice ID es el ID de la transacción en el lado de Xsolla. Para las pruebas, puede utilizar cualquier valor numérico.

El Invoice ID es un ID de transacción opcional en su juego. Para las pruebas, puede introducir cualquier combinación de letras y números.

Payments

¿Cómo puedo validar una solicitud de pago recibida en un webhook?

Primero, compruebe si el ID de usuario especificado existe en su proyecto. A continuación, devuelva el código 200 para validar el pago.

¿Puedo redirigir a un usuario a un método de pago concreto?

Al abrir la interfaz de la tienda, puede transmitir el ID del método de pago en el parámetro settings.payment_method. En este caso, a los usuarios se les redirige al formulario de pago del método seleccionado. Puede encontrar la lista de ID de métodos de pago en Cuenta del editor en Payments > Payment methods.

¿Puedo redirigir automáticamente a un usuario a una página de pago aceptado/rechazado después de procesar un pago, en función del resultado?

Sí, puede configurar las condiciones de redireccionamiento. Consulte las instrucciones para obtener más información.

Nuestro sistema de facturación establece automáticamente el order_id para cada pedido. ¿Puedo utilizar order_id en lugar de user_id al recibir un token?

No, necesita el user_id para que todo funcione correctamente.

Además, puede transmitir el order_id en el parámetro external_id. Para ello:

1. Abra su proyecto en Cuenta del editor y vaya a Project setting > Integration settings.
2. Marque la casilla Use external ID.
3. Haga clic en Save.

¿Puedo anular la URL del webhook para cada transacción?

No, la URL del webhook para todas las transacciones se establece en la configuración del proyecto en Cuenta del editor.

¿Recibiré los detalles de las transacciones fallidas?

No, Xsolla solamente envía webhooks para transacciones aceptadas. Si ha recibido una notificación sobre un pago, significa que la transacción se ha realizado correctamente.

¿Cómo puedo añadir el IVA al importe total del pago?

¿Qué significan las siglas 'PID'?

PID es el identificador del método de pago en el lado de Xsolla.

¿Qué es el ID externo?

El ID externo es el ID de una transacción en el juego que se asigna a un pedido en su sistema. En el lado de Xsolla, el ID externo está asociado a un ID de transacción. Por ese motivo un ID externo habilitado permite que Xsolla pueda evitar pagos repetidos para la misma transacción.

1. Abra su proyecto en Cuenta del editor y vaya a Project setting > Integration settings.
2. En la sección Payments section, seleccione las casillas de verificación pertinentes:
   • Use external ID: para exigir la validación del ID externo al crear un token.
   • Skip verification for external ID: para deshabilitar la validación de la ID externa a la hora de crear un token.

3. Haga clic en Save.

Nota

Cuando la opción Use external ID está habilitada, no puede realizar un pago de prueba mediante Cuenta del editor. Para hacer un pago de prueba correctamente, deshabilite temporalmente esta opción.

¿Tengo que generar un nuevo ID externo para cada transacción?

Sí, el ID externo debe ser único para cada pago.

¿Qué valor debo establecer para el método setExternalPaymentId?

El método setExternalPaymentId debe tener el mismo valor que el external_id, si usted lo tiene.

¿Qué son las pasarelas?

Cuando haya firmado un contrato con los sistemas de pago, puede utilizar pasarelas para mostrar estas opciones de pago en la interfaz de pago. Los jugadores pueden seguir pagando sus compras usando los métodos de pago seleccionados, y usted recibiría los pagos directamente de estos proveedores. Para conectar las pasarelas, abra su proyecto en Cuenta del editor y vaya a Payments > Payments settings > Gateways.

Xsolla actúa como proveedor de servicios técnicos y se lleva una parte reducida de los ingresos: 1,25 % del importe de la transacción + 0,10 $. Tendrá acceso completo a todas las soluciones de Xsolla, pero deberá hacer lo siguiente:

• gestionar las cuestiones fiscales;
• firmar acuerdos independientes con cada sistema de pago;
• retener el flujo de dinero directo de los sistemas de pago;
• gestionar las comisiones de los sistemas de pago, los contracargos y reembolsos, las comisiones de pago y los costes operativos.

Por ejemplo, si trabaja con PayPal y desea establecerlo como método de pago directo, puede conectar una pasarela. La interfaz de pago no cambiará: los cambios solo afectarán al proceso de desembolso. Después de procesar un pago, el dinero de un jugador se transferirá a su cuenta de PayPal. En este caso, Xsolla no interviene en el proceso de pago.

¿Cómo puedo migrar los datos del usuario (cuentas de pago guardadas, suscripciones, etc.) a Xsolla?

Contacte con su gestor del éxito del cliente o envíe un correo electrónico a csm@xsolla.com. Asegúrese de utilizar el cifrado PGP para garantizar la seguridad de los datos.

Parámetros de la clave PGP de Xsolla:

• ID de la clave: DA1E62CB
• Tipo de clave: RSA
• Longitud de la clave: 4096
• Huella digital: 0209 8489 757F 4451 F431 FB0C FBFC 4D97 DA1E 62CB
• ID de usuario: admins@xsolla.com

 1-----BEGIN PGP PUBLIC KEY BLOCK-----
 2
 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
62=naL7
63-----END PGP PUBLIC KEY BLOCK-----

¿Cómo se determina el país de un usuario?

Cuando se utiliza la llamada API del lado del cliente para generar el token de pago, Xsolla determina el país del usuario mediante la dirección IP de la solicitud.

Cuando se utiliza la llamada API del lado del servidor para generar el token de pago, el país se determina mediante la comprobación secuencial de:

• el valor del parámetro user.country.value en el cuerpo de la solicitud
• la dirección IP en el encabezado X-User-Ip

Si no se transmite ninguno de estos valores, aparece un error. Si se transmiten ambos valores, se utiliza la información del cuerpo de la solicitud.