Información general
La interfaz de pago se basa en el producto Pay Station. La elección de los métodos de pago disponibles y otros ajustes están disponibles en Cuenta del editor en la sección Pay Station.
El SDK admite la compra de artículos del catálogo en un solo clic o mediante la cesta de la compra.
Para probar el proceso de compra, puede utilizar el modo de aislador de proceso (sandbox) de la interfaz de pago y las tarjetas de prueba. El modo sandbox sólo simula el comportamiento de un método de pago; no hay dinero real involucrado. Para probar sandbox, no necesita firmar ningún acuerdo con Xsolla ni pagar ninguna cuota.
Instrucciones
Para redirigir a los usuarios a otra página después de que hayan hecho el pago, puede configurar dos tipos de redireccionamientos:
- automático: un redireccionamiento con un tiempo de retardo establecido.
- manual: un redireccionamiento después de que un usuario pulse el botón de redireccionamiento.
Puede configurar un redireccionamiento de las siguientes formas:
- en la Cuenta del editor: use esta opción si está configurando un proyecto para una única aplicación y no prevé crear compilaciones para diferentes plataformas.
- en la configuración del SDK: utilice esta opción si prevé:
- utilizar el proyecto para varias aplicaciones
- crear compilaciones para distintas plataformas
- vender artículos del juego a través del sitio web
Configurar redireccionamientos en la Cuenta del editor
- Abra su proyecto en Cuenta del editor.
- Pulse en Pay Station en el menú lateral.
- Vaya a la sección Settings > Redirect policy.
- En el campo Return URL, introduzca la URL o ruta a la que es redirigido un usuario después de realizar un pago.
app://xpayment.<ANDROID_PACKAGE_NAME>
, en el cual<ANDROID_PACKAGE_NAME>
es el nombre del paquete de la aplicación Android.app://xpayment.<BUNDLE_ID>
, en el cual<BUNDLE_ID>
es el identificador de la aplicación de iOS.
- Para configurar los parámetros de redireccionamiento automático:
- En la lista desplegable, elija Automatic redirect condition:
- None — do not redirect.
- Successful payment: redirigir cuando un pago se realiza con éxito.
- Successful or canceled payment: redirige cuando un pago se realiza correctamente o se cancela.
- Any payment: redirige para cualquier estado de pago.
- En el campo Delay, introduzca un tiempo de espera de redireccionamiento en segundos. Por defecto, un redireccionamiento se activa en 0 segundos.
- En la lista desplegable, elija Automatic redirect condition:
- Para establecer los parámetros de redireccionamiento manual:
- En la lista desplegable, elija Manual redirect condition:
- None — do not redirect.
- Successful payment: el botón de redireccionamiento aparece cuando un pago se realiza correctamente.
- Successful or canceled payment: el botón de redireccionamiento aparece cuando un pago se realiza correctamente o se cancela.
- Any payment: el botón de redireccionamiento aparece para cualquier estado de pago.
- En el campo Redirect button caption, introduzca el texto del botón que redirige al usuario a la URL de retorno.
- En la lista desplegable, elija Manual redirect condition:
Por defecto, el texto del botón de redireccionamiento es Volver al juego. Está traducido a todos los idiomas de Pay Station.
Si su proyecto admite varios idiomas, puede especificar el texto del botón de redireccionamiento para cada uno de ellos en los respectivos campos.
Cuando un usuario cierra la interfaz de pago, también se le redirige a la URL de retorno especificada.
- Haga clic en Save.
Configurar redireccionamientos en los ajustes del SDK
Transmita los parámetros de redireccionamiento al método init
. Para ello, añada las líneas en el código fuente de su proyecto en Cocos Creator de acuerdo con el ejemplo para la compilación de Android que aparece a continuación. Establezca los parámetros de redireccionamiento:
- En el parámetro
useSettingsFromPublisherAccount
transmitafalse
. - En el parámetro
returnUrl
, transmita una URL o una ruta a la que se redirigirá a un usuario después de realizar un pago.
app://xpayment.<ANDROID_PACKAGE_NAME>
, en el cual<ANDROID_PACKAGE_NAME>
es el nombre del paquete de la aplicación Android.app://xpayment.<BUNDLE_ID>
, en el cual<BUNDLE_ID>
es el identificador de la aplicación de iOS.
- Para establecer parámetros de redireccionamiento automático:
- En el parámetro
redirectCondition
, transmita las condiciones cuando se active un redireccionamiento:PaymentRedirectCondition.none
: no redirigir.PaymentRedirectCondition.successful
: redirigir cuando se acepta un pago.PaymentRedirectCondition.successful_or_canceled
: redirige cuando un pago se realiza correctamente o se cancela.PaymentRedirectCondition.any
: redirige para cualquier estado de pago.
- En el parámetro
redirectDelay
, introduzca un tiempo de espera de redireccionamiento en segundos.
- En el parámetro
- Para establecer los parámetros de redireccionamiento manual:
- En el parámetro
redirectStatusManual
, introduzca un estado de pago cuando aparezca el botón de redireccionamiento:PaymentRedirectCondition.none
: no redirigir.PaymentRedirectCondition.successful
: redirigir cuando un pago se realice correctamente.PaymentRedirectCondition.successful_or_canceled
: redirige cuando un pago se realiza correctamente o se cancela.PaymentRedirectCondition.any
: redirige para cualquier estado de pago.
- En el parámetro
redirectButtonCaption
, introduzca el texto para el botón que redirige a un usuario a la URL de retorno.
- En el parámetro
Por defecto, el texto del botón de redireccionamiento es Volver al juego. Está traducido a todos los idiomas de Pay Station.
Si su proyecto admite varios idiomas, puede especificar el texto del botón de redireccionamiento para cada uno de ellos en los respectivos campos.
Cuando un usuario cierra la interfaz de pago, también se le redirige a la URL de retorno especificada.
Ejemplo de configuración de redireccionamientos para una compilación de Android:
- typescript
let redirectPolicySettingsAndroid: RedirectPolicySettings = {
useSettingsFromPublisherAccount: false,
returnUrl: 'app://xpayment.com.example.myapp',
redirectCondition: PaymentRedirectCondition.successful,
redirectDelay: 0,
redirectStatusManual: PaymentRedirectStatusManual.successful,
redirectButtonCaption: 'Back to the game'
};
var settings: XsollaSettings = {
loginId: '<yourLoginId>',
projectId: '<yourProjectId>',
clientId: '<yourClientId>',
enableSandbox: IsSandbox,
redirectPolicySettingsAndroid: redirectPolicySettingsAndroid
}
Xsolla.init(settings);
redirectPolicySettingsAndroid
redirectPolicySettingsIOS
redirectPolicySettingsWebGL
Seguir leyendo
¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.