Cómo abrir la interfaz de pago
Antes de firmar un contrato con Xsolla, probar su proceso de pago solo está disponible en modo aislador de proceso (Sandbox). Si se produce cualquier error, vea sus descripciones.
Para abrir la interfaz de pago en el modo de aislador de proceso (Sandbox), use la siguiente URL: https://sandbox-secure.xsolla.com/paystation4/?token=ACCESS_TOKEN
, en la cual ACCESS_TOKEN
es el token obtenido en el paso previo.
Nueva ventana
Para abrir la interfaz de pago en una nueva ventana, use la siguiente URL: https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN
, en la cual TOKEN
es el token obtenido.
https://secure.xsolla.com/paystation4/?token=TOKEN
.- Con Pay Station Embed. Limitación: puede haber problemas al abrirla en el navegador del juego (WebView).
- Con iframe. Limitación: puede haber problemas al abrirla en el navegador del juego (WebView) y en la versión móvil de su aplicación.
Pay Station Embed
- html
<script>
var options = {
access_token: 'ACCESS_TOKEN', //TODO use access token, received on previous step
sandbox: true //TODO please do not forget to remove this setting when going live
};
var s = document.createElement('script');
s.type = "text/javascript";
s.async = true;
s.src = "https://static.xsolla.com/embed/paystation/1.0.7/widget.min.js";
s.addEventListener('load', function (e) {
XPayStationWidget.init(options);
}, false);
var head = document.getElementsByTagName('head')[0];
head.appendChild(s);
</script>
<button data-xpaystation-widget-open>Buy Credits</button>
Pay Station Embed permite obtener eventos de la interfaz de pago a través de postMessage
. Puede enviar estos eventos a sistemas de análisis. Para configurar el procesamiento de eventos en su sistema analítico, contacte con su gestor del éxito del cliente o envíe un correo electrónico a csm@xsolla.com.
El equipo de Xsolla ha creado un widget que simplifica la integración de la interfaz de pago en su sitio web. El script del widget está disponible en nuestro repositorio de GitHub.
Parámetros de inicialización del script:
Parámetro | Tipo | Descripción |
---|---|---|
access_token | string | Token, recibido a través de API. Obligatorio. |
sandbox | boolean | Establécelo en true para probar el proceso de pago: sandbox-secure.xsolla.com se utilizará en lugar de secure.xsolla.com . |
lightbox | object | Parámetros del Lightbox (objeto, solo versión de escritorio). |
payment_widget_ui.lightbox.width | string | Anchura del marco del Lightbox. Si es null , depende de la altura de Pay Station. Por defecto es null . |
payment_widget_ui.lightbox.height | string | Altura del marco del Lightbox. Si es null , depende de la altura de Pay Station. Por defecto es 100% . |
payment_widget_ui.lightbox.zIndex | integer | Define el orden de disposición. Por defecto es 1000 . |
payment_widget_ui.lightbox.overlayOpacity | integer | Opacidad del fondo del widget (0 - totalmente transparente, 1 - totalmente opaco). El valor por defecto es 60 % (.6 ). |
payment_widget_ui.lightbox.overlayBackground | string | Color de fondo de la superposición. Por defecto es #000000 . |
payment_widget_ui.lightbox.modal | boolean | Si es true , el marco del Lightbox no se puede cerrar. Por defecto es false . |
lightbox.closeByClick | boolean | Si es true , al hacer clic en la superposición se cerrará el Lightbox. Por defecto es true . |
lightbox.closeByKeyboard | boolean | Si es true , al pulsar ESC se cerrará el Lightbox. Por defecto es true . |
payment_widget_ui.lightbox.contentBackground | string | Color de fondo del marco. Por defecto es #ffffff . Tenga en cuenta que estos cambios de color no afectan al propio iframe de Pay Station, solo a la configuración del Lightbox que lo contiene. |
payment_widget_ui.lightbox.contentMargin | string | Margen del marco. Por defecto es 10px . |
payment_widget_ui.lightbox.spinner | string | Tipo de indicador de carga animado. Puede ser xsolla o round . Por defecto es xsolla . |
payment_widget_ui.lightbox.spinnerColor | string | Color del indicador giratorio. Sin valor por defecto. |
childWindow | object | Opciones para la ventana secundaria que contiene la interfaz de usuario de Pay Station. Compatible con la versión móvil. |
childWindow.target | string | Dónde abrir la ventana de Pay Station. Puede ser _blank , _self , _parent . Por defecto es _blank . |
El script permite realizar un seguimiento de los eventos de la interfaz de pago. En función del tipo de evento, puede realizar diversas acciones en la página web.
Lista de eventos:
Parámetro | Descripción |
---|---|
init | Widget inicializado. |
open | Widget abierto. |
load | Interfaz de pago (Pay Station) cargada. |
close | Interfaz de pago (Pay Station) cerrada. |
status | El usuario está en la página de estado. |
status-invoice | El usuario está en la página de estado; pago en curso. |
status-delivering | Evento cuando el usuario se movió en la página de estado, el pago se finalizó, y estamos enviando la notificación de pago. |
status-done | El usuario está en la página de estado; pago abonado en la cuenta del usuario. |
status-troubled | Evento cuando el usuario se movió en la página de estado, pero el pago no se pudo procesar. |
https://secure.xsolla.com/paystation4/?token=TOKEN
.https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN
.access_token
contiene datos privados del usuario. Asegúrese de utilizar la comunicación de servidor a servidor al obtener este parámetro.Iframe
Para abrir la interfaz de pago en un iframe:
- Implemente el mecanismo
postMessage
para recibir eventos de la interfaz de pago. - Abra la interfaz de pago pulsando en el enlace
https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN
, en el cualTOKEN
es el token recibido.
Problema potencial: si no aparece un botón para copiar un código de confirmación de pago requerido por algunos sistemas de pago al abrir la interfaz de pago en un iframe, transmita el atributo allow=“clipboard-read; clipboard-write; payment”
al iframe.
Ejemplo:
- html
<iframe
src="https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN"
width="800"
height="700"
allow="clipboard-read; clipboard-write; payment"
></iframe>
Seguir leyendo
¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.