# Cobrar con cuenta guardada

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


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





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

Endpoint: POST /projects/{project_id}/users/{user_id}/payments/{type}/{account_id}
Version: 2.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    ID del proyecto.

  - `user_id` (string, required)
    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` (string, required)
    Tipo de cuenta de pago.
    Enum: "card", "ais", "alipayplus_boost", "alipayplus_cn", "alipayplus_dana", "alipayplus_gcash", "alipayplus_hk", "alipayplus_kplus", "alipayplus_maya", "alipayplus_rabbitlinepay", "alipayplus_tng", "alipayplus_truemoney", "amazon", "klarna", "mercadopago", "nupay", "paidy", "paypal", "paysafecard_eu", "paysafecard_us", "skrill", "softbank_au", "softbank_docomo", "softbank_paypay", "softbank_softbank2", "softbank_ymobile", "toss"

  - `account_id` (integer, required)
    ID de la cuenta guardada en la base de datos de Xsolla.

## Request fields (application/json):

  - `custom_parameters` (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](mailto:csm@xsolla.com).

  - `custom_parameters.active_date` (string)
    Fecha de última visita conforme a la norma [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `custom_parameters.additional_verification` (boolean)
    Si el jugador usa o no procedimientos de verificación de cuenta.

  - `custom_parameters.character_customized` (boolean)
    Si el jugador ha personalizado o no su personaje.

  - `custom_parameters.chat_activity` (boolean)
    Si el jugador emplea o no la función de chat.

  - `custom_parameters.completed_tasks` (integer)
    Número de tareas/objetivos realizados/alcanzados.

  - `custom_parameters.forum_activity` (boolean)
    Si el jugador emplea o no la función del foro.

  - `custom_parameters.items_used` (boolean)
    Si el jugador usa o no artículos comprados en el juego.

  - `custom_parameters.karma_points` (integer)
    Karma del jugador.

  - `custom_parameters.last_change_password_date` (string)
    Fecha del último cambio de contraseña conforme a la norma [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `custom_parameters.non_premium_currency` (number)
    Importe de la moneda no prémium.

  - `custom_parameters.notifications_enabled` (boolean)
    Si el jugador habilitó o no las notificaciones.

  - `custom_parameters.profile_completed` (boolean)
    Si el jugador añadió o no información adicional a su perfil.

  - `custom_parameters.profile_image_added` (boolean)
    Si el jugador ha subido o no una imagen de perfil.

  - `custom_parameters.pvp_activity` (boolean)
    Si el jugador participa en batallas PvP (jugadores contra jugadores).

  - `custom_parameters.registration_date` (string)
    Fecha de creación de la cuenta conforme a la norma [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `custom_parameters.session_time` (string)
    Duración media de sesión conforme a la norma [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `custom_parameters.social_networks_added` (boolean)
    Si el jugador ha conectado o no perfiles de redes sociales.

  - `custom_parameters.total_bans` (integer)
    Número de veces que el jugador fue expulsado del chat/foro.

  - `custom_parameters.total_characters` (integer)
    Número de personajes dentro del juego.

  - `custom_parameters.total_clans` (integer)
    Número de clanes a los que pertenece el jugador.

  - `custom_parameters.total_friends` (integer)
    Número de amigas/os.

  - `custom_parameters.total_game_events` (integer)
    Número de eventos internos del juego en los que participó el jugador.

  - `custom_parameters.total_gifts` (integer)
    Número de regalos internos del juego que el jugador ha enviado/recibido.

  - `custom_parameters.total_hours` (integer)
    Número total de horas dentro del juego.

  - `custom_parameters.total_inventory_value` (number)
    Valor total del inventario (moneda del juego).

  - `custom_parameters.total_sum` (number)
    Importe total de los pagos.

  - `custom_parameters.tutorial_completed` (boolean)
    Si el jugador ha finalizado o no el tutorial del juego.

  - `custom_parameters.unlocked_achievements` (integer)
    Número de logros desbloqueados.

  - `custom_parameters.user_level` (integer)
    Nivel, reputación o rango del jugador.

  - `custom_parameters.win_rate` (integer)
    Índice de victorias.

  - `purchase` (object)
    Objeto con los detalles de la compra.

  - `purchase.checkout` (object)
    Objeto con los detalles del pago.

  - `purchase.checkout.amount` (number)
    Importe de la compra.

  - `purchase.checkout.currency` (string)
    Moneda de la compra. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://developers.xsolla.com/es/doc/pay-station/references/supported-currencies/).

  - `purchase.description` (object)

  - `purchase.description.value` (string)

  - `purchase.virtual_currency` (object)
    Objeto con los detalles de la moneda virtual.

  - `purchase.virtual_currency.quantity` (number)
    Importe de la compra en la moneda virtual.

  - `settings` (object)
    Objeto con la configuración de la compra.

  - `settings.currency` (string)
    Moneda preferida para la compra. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://developers.xsolla.com/es/doc/pay-station/references/supported-currencies/).

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

  - `settings.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: 1002, 1015, 1039, 1046, 1057, 1089, 1201, 1203, 1801, 1803, 2031, 3006, 3031, 5004

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

  - `user` (object)
    Datos del usuario.

  - `user.ip` (string, required)
    Dirección IP del usuario.

  - `user.legal` (object)
    Objeto con datos de la entidad jurídica.

  - `user.legal.address` (string)
    Dirección legal completa.

  - `user.legal.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](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

  - `user.legal.name` (string)
    Nombre legal completo.

  - `user.legal.vat_id` (string)
    Identificador del contribuyente individual.

  - `user.name` (string)
    Nombre de usuario.

## Response 201 fields (application/json):

  - `transaction_id` (integer)


## Response 422 fields
