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

Puede vender tanto cualquier cantidad de un artículo con un código (SKU), como una cesta de artículos con diferentes códigos de artículo (SKU) prellenada por un usuario. Para crear un pedido con los datos de un usuario y artículos en el lado de Xsolla, utilice una de las siguientes llamadas API:

• Crear pedido con un artículo especificado
• Crear pedido con todos los artículos de la cesta actual
• Crear pedido con todos los artículos de una cesta específica

La llamada API utilizada 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

Puede vender tanto cualquier cantidad de un artículo con un código (SKU), como una cesta de artículos con diferentes códigos de artículo (SKU) prellenada por un usuario.

Para crear un pedido con los datos de un usuario y un artículo con un código de artículo (SKU) en el lado de Xsolla, invoque al método SDK XsollaCatalog.Purchase, 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.

Para crear un pedido con datos sobre un usuario y una cesta de artículos en el lado de Xsolla, primero debe implementar la lógica de llenado y edición de la cesta, así como obtener su contenido. Consulte las instrucciones para obtener información detallada sobre la compra a través de una cesta de la compra.

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

Puede vender tanto cualquier cantidad de un artículo con un código (SKU), como una cesta de artículos con diferentes códigos de artículo (SKU) prellenada por un usuario.

1. Para crear un pedido con los datos de un usuario y un artículo con un código de artículo (SKU) 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")
        }
    }
}

Para crear un pedido con datos sobre un usuario y una cesta de artículos en el lado de Xsolla, primero debe implementar la lógica de llenado y edición de la cesta, así como obtener su contenido. Consulte las instrucciones para obtener información detallada sobre la compra a través de una cesta de la compra.

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

Puede vender tanto cualquier cantidad de un artículo con un código (SKU), como una cesta de artículos con diferentes códigos de artículo (SKU) prellenada por un usuario.

1. Para crear un pedido con los datos de un usuario y un artículo con un código de artículo (SKU) en el lado de Xsolla, invoque al método SDK FetchPaymentToken, 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.

Para crear un pedido con datos sobre un usuario y una cesta de artículos en el lado de Xsolla, primero debe implementar la lógica de llenado y edición de la cesta, así como obtener su contenido. Consulte las instrucciones para obtener información detallada sobre la compra a través de una cesta de la compra.

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.