Xsolla-logo

Cobrar con cuenta guardadaServer-side

post/projects/{project_id}/users/{user_id}/payments/{type}/{account_id}

Cobra a un usuario a través de una cuenta de pago guardada.

Nota

En modo aislador de proceso (sandbox), esta llamada API funciona solamente con tarjetas de prueba que no tienen función 3-D Secure.

Aviso

Para que la llamada API funcione correctamente, establezca un tiempo de espera de 2 minutos.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

ID del proyecto.

user_id
required
string

ID único de usuario en el juego que está almacenado en su lado. Asegúrese de transmitir el ID de usuario existente. Si se produce un error, consulte las respuestas a las Preguntas frecuentes.

type
required
string

Tipo de cuenta de pago.

Enum: Description
alipayplus_boost

Boost.

alipayplus_cn

Alipay.

alipayplus_dana

DANA.

alipayplus_gcash

GCash.

alipayplus_hk

Alipay (Hong Kong).

alipayplus_rabbitlinepay

Rabbit LINE Pay

alipayplus_tng

Touch 'n Go.

alipayplus_truemoney

Monedero TrueMoney.

amazon

Amazon Pay.

card

Tarjetas bancarias.

klarna

Klarna. El almacenamiento de los datos de las cuentas de pago únicamente está disponible para los siguientes países: EE. UU., Reino Unido, Suecia, Alemania, Austria, Noruega, Finlandia, Dinamarca y Países Bajos.

paypal

PayPal.

paysafecard_eu

Paysafecard (EU).

paysafecard_us

Paysafecard (EE. UU.).

skrill

Monedero digital Skrill.

softbank_paypay

PayPay.

toss

Monedero Toss.

account_id
required
integer

ID de la cuenta guardada en la base de datos de Xsolla.

Request Body schema: application/json
object

Este objeto contiene parámetros destinados a configurar los filtros antifraude. La lista de parámetros se muestra a continuación. Para agregar parámetros personalizados, contacte con su gestor del éxito del cliente o envíe un correo electrónico a csm@xsolla.com.

active_date
string

Fecha de última visita conforme a la norma ISO 8601.

additional_verification
boolean

Si el jugador usa o no procedimientos de verificación de cuenta.

character_customized
boolean

Si el jugador ha personalizado o no su personaje.

chat_activity
boolean

Si el jugador emplea o no la función de chat.

completed_tasks
integer

Número de tareas/objetivos realizados/alcanzados.

forum_activity
boolean

Si el jugador emplea o no la función del foro.

items_used
boolean

Si el jugador usa o no artículos comprados en el juego.

karma_points
integer

Karma del jugador.

last_change_password_date
string

Fecha del último cambio de contraseña conforme a la norma ISO 8601.

non_premium_currency
number <float>

Importe de la moneda no prémium.

notifications_enabled
boolean

Si el jugador habilitó o no las notificaciones.

profile_completed
boolean

Si el jugador añadió o no información adicional a su perfil.

profile_image_added
boolean

Si el jugador ha subido o no una imagen de perfil.

pvp_activity
boolean

Si el jugador participa o no en combates JvJ.

registration_date
string

Fecha de creación de la cuenta conforme a la norma ISO 8601.

session_time
string

Duración media de sesión conforme a la norma ISO 8601.

social_networks_added
boolean

Si el jugador ha conectado o no perfiles de redes sociales.

total_bans
integer

Número de veces que el jugador fue expulsado del chat/foro.

total_characters
integer

Número de personajes dentro del juego.

total_clans
integer

Número de clanes a los que pertenece el jugador.

total_friends
integer

Número de amigas/os.

total_game_events
integer

Número de eventos internos del juego en los que participó el jugador.

total_gifts
integer

Número de regalos internos del juego que el jugador ha enviado/recibido.

total_hours
integer

Número total de horas dentro del juego.

total_inventory_value
number <float>

Valor total del inventario (moneda del juego).

total_sum
number <float>

Importe total de los pagos.

tutorial_completed
boolean

Si el jugador ha finalizado o no el tutorial del juego.

unlocked_achievements
integer

Número de logros desbloqueados.

user_level
integer

Nivel, reputación o rango del jugador.

win_rate
integer

Índice de victorias.

object

Objeto con los detalles de la compra.

object

Objeto con los detalles del pago.

amount
number <float>

Importe de la compra.

currency
string

Moneda de la compra. Código de moneda de tres letras de conformidad con la norma ISO 4217.

object <= 4000 characters
value
string
object

Objeto con los detalles de la moneda virtual.

quantity
number <float>

Importe de la compra en la moneda virtual.

object

Objeto con la configuración de la compra.

currency
string

Moneda preferida para la compra. Código de moneda de tres letras de conformidad con la norma ISO 4217.

external_id
string

ID de transacción en el juego. Debe ser distinto para cada pago de usuario. Consulta la documentación para obtener información detallada.

mock_code
integer

Un código de error que se debe reproducir al probar el proceso de pago a través de PayPal en modo de entorno de pruebas (sandbox). Solo funciona correctamente si se transmite el parámetro "mode":"sandbox".

Enum: 1057 1015 3006 1801 1803 1039 3031 1203 3006 1201 1002 1089 2031 1046 5004
mode
string

Establecer en entorno de pruebas (sandbox) para probar el proceso de pago. Elimina el parámetro para pagos reales.

object

Datos del usuario.

ip
required
string

Dirección IP del usuario.

object

Objeto con datos de la entidad jurídica.

address
string

Dirección legal completa.

country
string

País de constitución. Código de país de dos letras mayúsculas de conformidad con la norma ISO 3166-1 alpha-2.

name
string

Nombre legal completo.

vat_id
string

Identificador del contribuyente individual.

name
string

Nombre de usuario.

Responses
201

Created.

422

Unprocessable Entity.

Request samples
application/json
{
  • "purchase": {
    },
  • "settings": {
    },
  • "user": {
    }
}
Response samples
application/json
{
  • "transaction_id": 123458390
}