Cobrar con cuenta guardada

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

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

Aviso

Para que la solicitud API funcione correctamente, establece un tiempo de espera de 2 minutos.

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

ID del proyecto.

user_id

required

string

ID del usuario.

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

This object contains parameters to configure anti-fraud filters. The list of parameters is shown below. To add custom parameters, contact your Customer Success Manager or email at 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.

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.

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

{"card": {"cvn": "123"
},
"purchase": {"description": {"value": "currency purchase"
},
"virtual_currency": {"quantity": 100
}
},
"settings": {"currency": "USD",
"external_id": "ext123",
"save": true
},
"user": {"id": "user123",
"ip": "111.11.11.11",
"legal": {"address": "17 Crown Street London SW2 0JW United Kingdom",
"country": "GB",
"name": "My Awesome Company",
"vat_id": "GB111111111"
},
"name": "John Smith"
}
}

Response samples

application/json

{"transaction_id": 123458390
}