Cobrar con cuenta guardada

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_maya	Maya.
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.
mercadopago	Mercado Pago.
paypal	PayPal.
paysafecard_eu	Paysafecard (EU).
paysafecard_us	Paysafecard (EE. UU.).
skrill	Monedero digital Skrill.
softbank_au	au Easy Payment.
softbank_docomo	Docomo.
softbank_paypay	PayPay.
softbank_softbank2	SoftBank.
softbank_ymobile	Y!mobile.
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 Whether the player takes part in PvP (Player(s) versus player(s)) battles.
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.

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": {"description": {"value": "currency purchase"
},
"virtual_currency": {"quantity": 100
}
},
"settings": {"currency": "USD",
"external_id": "ext123",
"mode": "sandbox"
},
"user": {"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
}