Crear un pedido en el lado del cliente de la aplicación

Para crear un pedido con los datos del usuario y del artículo en el lado de Xsolla, use la llamada API Crear pedido con un artículo especificado. Este método devolverá un token de pago, el cual es necesario para abrir la interfaz de pago y realizar un pago. Para utilizar el modo de aislador de proceso (sandbox), transmita el parámetro “sandbox”: true en el cuerpo de la solicitud para obtener un token.

Abrir la interfaz de pago

<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>

<iframe
  src="https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN"
  width="800"
  height="700"
  allow="clipboard-read; clipboard-write; payment"
></iframe>

Realizar pago de prueba

Para probar el proceso de pago, puede utilizar el modo de aislador de proceso (sandbox). El modo sandbox es un entorno independiente que admite todas las funciones de un entorno real, excepto los pagos reales y los rechazados. Puede acceder al modo sandbox enviando “sandbox”: true cuando cree un pedido.

1. Abra la interfaz de pago en modo Aislador de proceso (Sandbox).
2. Elija el método de pago Tarjeta bancaria.
3. Introduzca los datos de la tarjeta bancaria. En otros campos (p. ej., nombre o dirección), puede introducir cualquier dato. También puede especificar detalles incorrectos (número de tarjeta o fecha de expiración) para comprobar si se genera un error.
4. Haga clic en Pagar.

Lista de tarjetas de prueba

Consulte la lista de tarjetas bancarias de pruebas.

Para obtener más información sobre las transacciones, incluyendo las tasas, realizadas en modo aislador de proceso (Sandbox):

1. Abra su Cuenta del editor.
2. Vaya a Accounting > Transaction registry.
3. Marque la casilla Show test transactions.

Asimismo, puede ver los detalles de las transacciones y solicitar reembolsos en Cuenta del editor, en la sección Support > Transaction search.

Crear el pedido y abrir la interfaz de pago

Para crear un pedido con los datos del usuario y del artículo en el lado de Xsolla, invoque el método createOrderByItemSku del SDK, transmitiéndole los siguientes parámetros:

• itemSku — el código (SKU) del artículo que el usuario desea adquirir.
• onSuccess — la devolución de llamada de compra realizada con éxito, que se desencadena cuando el pedido pasa al estado done.
• onError — devolución de llamada de error de solicitud.
• onBrowseClosed — la devolución de llamada de cierre del navegador (opcional). El evento solamente se rastrea al abrir la interfaz de pago del usuario en el navegador integrado. Los eventos de navegadores externos no se rastrean.
• purchaseParams — parámetros de compra y configuración de la interfaz de pago del usuario, como configuración regional y divisa (opcional).
• customHeaders — encabezados de solicitud web personalizados (opcional).

El método XsollaCatalog.Purchase inicia el proceso de compra del artículo especificado, el cual incluye la creación del pedido, la apertura de la interfaz de pago y el seguimiento del estado del pedido. En el parámetro onSuccess transmita una función, que se invoca cuando el pedido pasa al estado done.

Realizar pago de prueba

Para probar el proceso de pago, puede utilizar el modo de aislador de proceso (sandbox). El modo sandbox es un entorno independiente que admite todas las funciones de un entorno real, excepto los pagos reales y los rechazados. Para acceder al modo sandbox, debe haber marcado la casilla Test Payments Mode del Unity Editor en el panel Inspector (marcada por defecto).

1. Ejecute su aplicación o escena en Unity Editor.
2. Elija el método de pago Bank card (Tarjeta bancaria).
3. Introduzca los datos de la tarjeta bancaria. En otros campos (p. ej., nombre o dirección), puede introducir cualquier dato. También puede especificar detalles incorrectos (número de tarjeta o fecha de caducidad) para comprobar si se genera un error.
4. Haga clic en Pay.

Lista de tarjetas de prueba

Consulte la lista de tarjetas bancarias de pruebas.

Para obtener más información sobre las transacciones, incluyendo las tasas, realizadas en modo aislador de proceso (Sandbox):

1. Abra su Cuenta del editor.
2. Vaya a Accounting > Transaction registry.
3. Marque la casilla Show test transactions.

Asimismo, puede ver los detalles de las transacciones y solicitar reembolsos en Cuenta del editor, en la sección Support > Transaction search.

Crear el pedido y abrir la interfaz de pago

1. Para crear un pedido con los datos del usuario y del artículo en el lado de Xsolla, invoque al método createOrderByItemSku de la biblioteca de Store, transmitiéndole los siguientes parámetros:

1. • activity — la devolución de llamada de creación de pedido realizada correctamente. Recibe el token de pago necesario para abrir la interfaz de pago y efectuar el pago.

1. • itemSku — el código de artículo (SKU) del artículo que el usuario desea adquirir.

1. • callbackk — parámetros de pago (opcional).

1. • quantity — el número de artículos que el usuario desea adquirir (opcional). Si no se especifica la cantidad, el valor por defecto se establecerá como 1.

2. Implemente la lógica de apertura de la interfaz de pago:

val intent = XPayments.createIntentBuilder(activity)
    .accessToken(AccessToken(<payment token>))
    .isSandbox(<isSandbox>)
    .build()
startActivityForResult(intent, RC_PAYSTATION)

3. Implemente el control de resultados de pago:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == RC_PAYSTATION) {
        val (status, _) = XPayments.Result.fromResultIntent(data)
        when (status) {
            XPayments.Status.COMPLETED -> Log.d("MainActivity", "Payment completed")
            XPayments.Status.CANCELLED -> Log.d("MainActivity", "Payment cancelled")
            XPayments.Status.UNKNOWN -> Log.d("MainActivity", "Status unknown")
        }
    }
}

Realizar pago de prueba

Para probar el proceso de pago, puede utilizar el modo de aislador de proceso (sandbox). El modo sandbox es un entorno independiente que admite todas las funciones destinadas a un entorno real, excepto los pagos reales y los rechazados. Para acceder al modo sandbox, debe invocar el método isSandbox y transmitir true como un argumento, cuando cree un objeto IntentBuilder.

1. Ejecute su aplicación.
2. Elija el método de pago Bank card (Tarjeta bancaria).
3. Introduzca los datos de la tarjeta bancaria. En otros campos (p. ej., nombre o dirección), puede introducir cualquier dato. También puede especificar detalles incorrectos (número de tarjeta o fecha de caducidad) para comprobar si se genera un error.
4. Haga clic en Pay.

Lista de tarjetas de prueba

Consulte la lista de tarjetas bancarias de pruebas.

Para obtener más información sobre las transacciones, incluyendo las tasas, realizadas en modo aislador de proceso (Sandbox):

1. Abra su Cuenta del editor.
2. Vaya a Accounting > Transaction registry.
3. Marque la casilla Show test transactions.

Asimismo, puede ver los detalles de las transacciones y solicitar reembolsos en Cuenta del editor, en la sección Support > Transaction search.

Crear el pedido y abrir la interfaz de pago

1. Para crear un pedido con los datos del usuario y del artículo en el lado de Xsolla, invoque el método FetchPaymentToken del SDK, transmitiéndole los siguientes parámetros:

1. • AuthToken — el token de autenticación del usuario, obtenido durante la autenticación mediante Xsolla Login.

1. • ItemSKU — el código (SKU) del artículo que el usuario desea adquirir.

1. • SuccessCallback: la devolución de llamada del estado desencadenada cuando se recibe correctamente el token de pago.

1. • ErrorCallback — la devolución de llamada de error de la solicitud.

1. • PurchaseParams — parámetros de la interfaz de compra y pago del usuario, como configuración regional y divisa (opcional).

2. Implemente la apertura de la interfaz de pago. Para ello, llame al método LaunchPaymentConsole del SDK, transmitiéndole los siguientes parámetros.

1. • WorldContextObject — el objeto de contexto mundial (para llamada C++).

1. • OrderId — el ID del pedido.

1. • AccessToken — el token de pago.

1. • SuccessCallback — la devolución de llamada desencadenada cuando se recibe correctamente el token de pago.

1. • ErrorCallback — la devolución de llamada de error de la solicitud.

1. • BrowserClosedCallback — la devolución de llamada de cierre del navegador. El evento solamente se rastrea al abrir la interfaz de pago del usuario en el navegador integrado. Los eventos del navegador externo no se rastrean.

1. • PayStationVersion — la versión de Pay Station. Por defecto se usa la versión 4.

Realizar pago de prueba

Para probar el proceso de pago, puede utilizar el modo de aislador de proceso (sandbox). El modo sandbox es un entorno independiente que admite todas las funciones de un entorno real, excepto los pagos reales y los rechazados. Para acceder al modo sandbox, debe haber marcado la casilla Enable Sandbox de Unreal Editor en el panel Settings > Project Settings > Plugins > Xsolla Settings > Purchases (marcada por defecto).

1. Ejecute su aplicación o mapa en Unreal Editor.
2. Elija el método de pago Bank card (Tarjeta bancaria).
3. Introduzca los datos de la tarjeta bancaria. En otros campos (p. ej., nombre o dirección), puede introducir cualquier dato. También puede especificar detalles incorrectos (número de tarjeta o fecha de caducidad) para comprobar si se genera un error.
4. Haga clic en Pay.

Lista de tarjetas de prueba

Consulte la lista de tarjetas bancarias de pruebas.

Para obtener más información sobre las transacciones, incluyendo las tasas, realizadas en modo aislador de proceso (Sandbox):

1. Abra su Cuenta del editor.
2. Vaya a Accounting > Transaction registry.
3. Marque la casilla Show test transactions.

Asimismo, puede ver los detalles de las transacciones y solicitar reembolsos en Cuenta del editor, en la sección Support > Transaction search.