# Cobrar com conta salva

Cobra um usuário através de uma conta de pagamento salva.


ObserveNo modo sandbox, essa chamada de API só funciona com cartões de teste que não tenham a função 3-D Secure.





AvisoPara a chamada de API funcionar corretamente, configure um tempo limite 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 do projeto.

  - `user_id` (string, required)
    ID de usuário único no jogo armazenado do seu lado. Certifique-se de passar o ID de usuário existente. Em caso de erro, consulte às respostas às Perguntas Frequentes (FAQ).

  - `type` (string, required)
    Tipo de conta de pagamento.
    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 uma conta salva no banco de dados da Xsolla.

## Request fields (application/json):

  - `custom_parameters` (object)
    Este objeto contém parâmetros para configurar filtros antifraude. A lista de parâmetros é exibida abaixo. Para adicionar parâmetros personalizados, contate seu Gerente de Sucesso do Cliente ou envie um e-mail para [csm@xsolla.com](mailto:csm@xsolla.com).

  - `custom_parameters.active_date` (string)
    Última data de visualização, de acordo com o [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `custom_parameters.additional_verification` (boolean)
    Se o jogador utiliza procedimentos de verificação de conta ou não.

  - `custom_parameters.character_customized` (boolean)
    Se o jogador personalizou seu personagem ou não.

  - `custom_parameters.chat_activity` (boolean)
    Se o jogador utiliza a função de chat ou não.

  - `custom_parameters.completed_tasks` (integer)
    Quantidade de tarefas/objetivos concluídos.

  - `custom_parameters.forum_activity` (boolean)
    Se o jogador utiliza a função do fórum ou não.

  - `custom_parameters.items_used` (boolean)
    Se o jogador usa itens de jogo comprados ou não.

  - `custom_parameters.karma_points` (integer)
    Karma do jogador.

  - `custom_parameters.last_change_password_date` (string)
    Data da última alteração de senha, de acordo com o [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `custom_parameters.non_premium_currency` (number)
    Quantidade de moedas não Premium.

  - `custom_parameters.notifications_enabled` (boolean)
    Se o jogador habilitou notificações ou não.

  - `custom_parameters.profile_completed` (boolean)
    Se o jogador adicionou informações adicionais ao seu perfil ou não.

  - `custom_parameters.profile_image_added` (boolean)
    Se o jogador enviou uma imagem de perfil nova ou não.

  - `custom_parameters.pvp_activity` (boolean)
    Se o jogador participa de batalhas PvP (Jogador vs jogador).

  - `custom_parameters.registration_date` (string)
    Data de criação da conta, de acordo com o [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `custom_parameters.session_time` (string)
    Tempo de sessão médio, de acordo com o [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `custom_parameters.social_networks_added` (boolean)
    Se o jogador conectou seus perfis de mídias sociais ou não.

  - `custom_parameters.total_bans` (integer)
    Quantidade de vezes que o jogador foi banido do chat/fórum.

  - `custom_parameters.total_characters` (integer)
    Quantidade de personagens no jogo.

  - `custom_parameters.total_clans` (integer)
    Quantidade de clãs dos quais o jogador fez parte.

  - `custom_parameters.total_friends` (integer)
    Quantidade de amigos.

  - `custom_parameters.total_game_events` (integer)
    Quantidade de eventos no jogo dos quais o jogador participou.

  - `custom_parameters.total_gifts` (integer)
    Quantidade de presentes no jogo que o jogador enviou/recebeu.

  - `custom_parameters.total_hours` (integer)
    Tempo total de horas no jogo.

  - `custom_parameters.total_inventory_value` (number)
    Valor total do inventário (moeda do jogo).

  - `custom_parameters.total_sum` (number)
    Quantia total de pagamentos.

  - `custom_parameters.tutorial_completed` (boolean)
    Se o jogador concluiu o tutorial do jogo ou não.

  - `custom_parameters.unlocked_achievements` (integer)
    Quantidade de conquistas desbloqueadas.

  - `custom_parameters.user_level` (integer)
    Nível, reputação ou classificação do jogador.

  - `custom_parameters.win_rate` (integer)
    Taxa de vitórias.

  - `purchase` (object)
    Objeto que contém dados de compra.

  - `purchase.checkout` (object)
    Objeto que contém dados de pagamento.

  - `purchase.checkout.amount` (number)
    Quantia de compra.

  - `purchase.checkout.currency` (string)
    Moeda da compra. Código da moeda de três letras de acordo com o [ISO 4217](https://developers.xsolla.com/pt/doc/pay-station/references/supported-currencies/).

  - `purchase.description` (object)

  - `purchase.description.value` (string)

  - `purchase.virtual_currency` (object)
    Objeto que contém dados da moeda virtual.

  - `purchase.virtual_currency.quantity` (number)
    Quantia da compra em moedas virtuais.

  - `settings` (object)
    Objeto que contém configurações de compra.

  - `settings.currency` (string)
    Moeda de compra preferencial. Código da moeda de três letras de acordo com o [ISO 4217](https://developers.xsolla.com/pt/doc/pay-station/references/supported-currencies/).

  - `settings.external_id` (string)
    ID da transação no jogo. Deve ser único para cada pagamento. Confira a documentação para obter mais detalhes.

  - `settings.mock_code` (integer)
    Um código de erro que você deseja reproduzir ao testar o processo de pagamento via PayPal no modo sandbox. Ele só funciona corretamente se você passar o parâmetro "mode":"sandbox".
    Enum: 1002, 1015, 1039, 1046, 1057, 1089, 1201, 1203, 1801, 1803, 2031, 3006, 3031, 5004

  - `settings.mode` (string)
    Defina como sandbox para testar o processo de pagamento. Remova o parâmetro para realizar pagamentos reais.

  - `user` (object)
    Dados do usuário.

  - `user.ip` (string, required)
    Endereço IP do usuário.

  - `user.legal` (object)
    Objeto com dados da entidade legal.

  - `user.legal.address` (string)
    Endereço legal completo.

  - `user.legal.country` (string)
    País da incorporação. É utilizado o código de país de duas letras maiúsculas, de acordo com o [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

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

  - `user.legal.vat_id` (string)
    Identificação de contribuinte individual.

  - `user.name` (string)
    Nome de usuário.

## Response 201 fields (application/json):

  - `transaction_id` (integer)


## Response 422 fields
