Xsolla-logo

Оплата по сохраненному платежному аккаунтуServer-side

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

Оплата по сохраненному платежному аккаунту.

Примечание

Данный метод API в тестовом окружении (sandbox-режиме) работает только с тестовыми картами, у которых нет проверки 3-D Secure.

Внимание

Для корректной работы метода настройте время ожидания 2 минуты.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

ID проекта.

user_id
required
string

Уникальный ID пользователя в игре, который хранится на вашей стороне. Убедитесь, что указываете существующий ID пользователя. При возникновении ошибок изучите ответы на частые вопросы.

type
required
string

Тип платежного аккаунта.

Enum: Description
alipayplus_boost

Boost.

alipayplus_cn

Alipay.

alipayplus_dana

DANA

alipayplus_gcash

GCash

alipayplus_hk

Alipay (Гонконг).

alipayplus_rabbitlinepay

Rabbit LINE pay

alipayplus_tng

Touch 'n Go

alipayplus_truemoney

TrueMoney Wallet.

amazon

Amazon Pay.

card

Банковские карты.

klarna

Klarna. Сохранение платежных аккаунтов доступно только для следующих стран: США, Великобритания, Швеция, Германия, Австрия, Норвегия, Финляндия, Дания, Нидерланды.

paypal

PayPal.

paysafecard_eu

Paysafecard (ЕС).

paysafecard_us

Paysafecard (США).

skrill

Skrill Digital Wallet.

softbank_paypay

PayPay.

toss

Toss Wallet.

account_id
required
integer

Идентификатор сохраненного платежного аккаунта в базе данных Xsolla.

Request Body schema: application/json
object

Объект с параметрами для настройки антифрод-фильтров. Список параметров приведен ниже на этой странице. Чтобы добавить кастомные параметры, свяжитесь с вашим персональным менеджером или напишите на csm@xsolla.com.

active_date
string

Дата последнего посещения согласно стандарту ISO 8601.

additional_verification
boolean

Использует ли игрок дополнительные способы защиты аккаунта.

character_customized
boolean

Настраивал ли игрок персонажа.

chat_activity
boolean

Пишет ли игрок в чате.

completed_tasks
integer

Количество выполненных заданий.

forum_activity
boolean

Пишет ли игрок в форуме.

items_used
boolean

Использует ли игрок купленные в игре предметы.

karma_points
integer

Карма игрока.

last_change_password_date
string

Дата последней смены пароля согласно стандарту ISO 8601.

non_premium_currency
number <float>

Сумма непремиальной валюты игрока.

notifications_enabled
boolean

Подписался ли игрок на рассылку уведомлений.

profile_completed
boolean

Добавил ли игрок дополнительную информацию в профиль.

profile_image_added
boolean

Загрузил ли игрок изображение профиля.

pvp_activity
boolean

Участвует ли игрок в PvP.

registration_date
string

Дата регистрации аккаунта согласно стандарту ISO 8601.

session_time
string

Период времени, который пользователь проводит в игре, согласно стандарту ISO 8601.

social_networks_added
boolean

Подключил ли игрок профили в социальных сетях.

total_bans
integer

Количество банов игрока в чате/на форуме.

total_characters
integer

Количество персонажей игрока.

total_clans
integer

Количество кланов, в которых состоит игрок.

total_friends
integer

Количество друзей игрока.

total_game_events
integer

Количество внутриигровых событий, в которых участвовал игрок.

total_gifts
integer

Количество подарков, отправленных или полученных игроком.

total_hours
integer

Общее количество часов, проведенных в игре.

total_inventory_value
number <float>

Суммарная стоимость инвентаря во внутриигровой валюте.

total_sum
number <float>

Общая сумма платежей.

tutorial_completed
boolean

Завершил ли игрок обучение в игре.

unlocked_achievements
integer

Количество разблокированных умений.

user_level
integer

Уровень игрока, репутация или ранг.

win_rate
integer

Рейтинг побед игрока.

object

Объект с информацией о заказе.

object

Объект с информацией о заказе.

amount
number <float>

Сумма заказа.

currency
string

Валюта заказа. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

object <= 4000 characters
value
string
object

Объект с данными о виртуальной валюте.

quantity
number <float>

Количество виртуальной валюты в заказе.

object

Объект с данными о настройках.

currency
string

Предпочтительная валюта платежа. Используется трехбуквенное обозначение валюты согласно стандарту ISO 4217.

external_id
string

ID транзакции в игре. Должен быть уникальным для каждого платежа пользователя. Изучите подробную информацию в документации.

mock_code
integer

Код ошибки, которую вы хотите воспроизвести при тестировании оплаты через PayPal в тестовом окружении (sandbox-режиме). Работает корректно, только если передан параметр "mode":"sandbox".

Enum: 1057 1015 3006 1801 1803 1039 3031 1203 3006 1201 1002 1089 2031 1046 5004
mode
string

Передайте значение sandbox, чтобы провести тестовые платежи. Для проведения реальных платежей этот параметр необходимо убрать.

object

Объект с информацией о пользователе.

ip
required
string

IP адрес пользователя.

object

Объект с реквизитами юридического лица.

address
string

Полный юридический адрес.

country
string

Страна регистрации. Используется двухбуквенное обозначение страны согласно стандарту ISO 3166-1 alpha-2.

name
string

Полное юридическое наименование.

vat_id
string

Индивидуальный идентификатор налогоплательщика.

name
string

Имя пользователя.

Responses
201

Created.

422

Unprocessable Entity.

Request samples
application/json
{
  • "purchase": {
    },
  • "settings": {
    },
  • "user": {
    }
}
Response samples
application/json
{
  • "transaction_id": 123458390
}