Cobrar com conta salva

Cobrar com conta salvaServer-side

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

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

Observe

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

Aviso

Para a chamada de API funcionar corretamente, configure um tempo limite de 2 minutos.

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

ID do projeto.

user_id

required

string

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

required

string

Tipo de conta de pagamento.

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	TrueMoney Wallet.
amazon	Amazon Pay.
card	Cartões bancários.
klarna	Klarna. O salvamento da conta de pagamento Klarna só está disponível nos seguintes países: EUA, RU, Suécia, Alemanha, Áustria, Noruega, Finlândia, Dinamarca e Holanda.
paypal	PayPal.
paysafecard_eu	Paysafecard (UE).
paysafecard_us	Paysafecard (EUA).
skrill	Skrill Digital Wallet.
softbank_paypay	PayPay.
toss	Toss Wallet.

account_id

required

integer

ID de uma conta salva no banco de dados da Xsolla.

Request Body schema: application/json

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.

active_date	string Última data de visualização, de acordo com o ISO 8601.
additional_verification	boolean Se o jogador utiliza procedimentos de verificação de conta ou não.
character_customized	boolean Se o jogador personalizou seu personagem ou não.
chat_activity	boolean Se o jogador utiliza a função de chat ou não.
completed_tasks	integer Quantidade de tarefas/objetivos concluídos.
forum_activity	boolean Se o jogador utiliza a função do fórum ou não.
items_used	boolean Se o jogador usa itens de jogo comprados ou não.
karma_points	integer Karma do jogador.
last_change_password_date	string Data da última alteração de senha, de acordo com o ISO 8601.
non_premium_currency	number <float> Quantidade de moedas não Premium.
notifications_enabled	boolean Se o jogador habilitou notificações ou não.
profile_completed	boolean Se o jogador adicionou informações adicionais ao seu perfil ou não.
profile_image_added	boolean Se o jogador enviou uma imagem de perfil nova ou não.
pvp_activity	boolean Se o jogador participa de batalhas JvJ ou não.
registration_date	string Data de criação da conta, de acordo com o ISO 8601.
session_time	string Tempo de sessão médio, de acordo com o ISO 8601.
social_networks_added	boolean Se o jogador conectou seus perfis de mídias sociais ou não.
total_bans	integer Quantidade de vezes que o jogador foi banido do chat/fórum.
total_characters	integer Quantidade de personagens no jogo.
total_clans	integer Quantidade de clãs dos quais o jogador fez parte.
total_friends	integer Quantidade de amigos.
total_game_events	integer Quantidade de eventos no jogo dos quais o jogador participou.
total_gifts	integer Quantidade de presentes no jogo que o jogador enviou/recebeu.
total_hours	integer Tempo total de horas no jogo.
total_inventory_value	number <float> Valor total do inventário (moeda do jogo).
total_sum	number <float> Quantia total de pagamentos.
tutorial_completed	boolean Se o jogador concluiu o tutorial do jogo ou não.
unlocked_achievements	integer Quantidade de conquistas desbloqueadas.
user_level	integer Nível, reputação ou classificação do jogador.
win_rate	integer Taxa de vitórias.

object

Objeto que contém dados de compra.

object

Objeto que contém dados de pagamento.

amount	number <float> Quantia de compra.
currency	string Moeda da compra. Código da moeda de três letras de acordo com o ISO 4217.

object <= 4000 characters

value

string

object

Objeto que contém dados da moeda virtual.

quantity

number <float>

Quantia da compra em moedas virtuais.

object

Objeto que contém configurações de compra.

currency	string Moeda de compra preferencial. Código da moeda de três letras de acordo com o ISO 4217.
external_id	string ID da transação no jogo. Deve ser único para cada pagamento. Confira a documentação para obter mais detalhes.
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: 1057 1015 3006 1801 1803 1039 3031 1203 3006 1201 1002 1089 2031 1046 5004
mode	string Defina como `sandbox` para testar o processo de pagamento. Remova o parâmetro para realizar pagamentos reais.

object

Dados do usuário.

required

string

Endereço IP do usuário.

object

Objeto com dados da entidade legal.

address	string Endereço legal completo.
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.
name	string Nome legal completo.
vat_id	string Identificação de contribuinte individual.

name

string

Nome de usuário.

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
}