Добавить банковскую карту клиента

Обновлено 20 февраля 2025

Добавить связку для банковской карты. Затем эту связку можно использовать для безакцептной оплаты. По факту это создание счета на оплату, например, 1 руб. для проверки валидности карты, после подтверждения оплаты счет автоматически удаляется.

Запрос

Body

return_urls

user_id

object

oneOf

partner_client_id

string

required

Внешний идентификатор клиента партнера

user_uid

string

required

Внутренний идентификатор пользователя в приложении

encrypted_sub_id

string

required

Зашифрованный sub_id пользователя

partner_client_sub_id

string

required

Внешний идентификатор sub-а клиента партнера

device_info

object

Информация об устройстве

device_platform_type

string

Наименование операционной системы устройства

device_platform_version

string

Версия операционной системы устройства

device_model

string

Модель устройства

device_manufacturer

string

Производитель устройства

device_id

string

Серийный номер устройства

surface

string

Поверхность

surface_version

string

Версия ПО

order_id

object

required

order_id

string

Идентификатор заказа.

Должен быть уникален в рамках выделенного для приложения service_id, иначе не будет создан новый invoice_id

code

string

Возможные значения: [new, app2sbol]

Код инструмента

return_url

string

URL, на который требуется переадресовать пользователя в случае успешной оплаты.

Адрес должен быть указан полностью, включая используемый протокол (например, https://test.ru вместо test.ru). Указывается либо return_url, либо return_deeplink

fail_url

string

URL, на который требуется переадресовать пользователя в случае неуспешной оплаты.

Адрес должен быть указан полностью, включая используемый протокол (например, https://test.ru вместо test.ru).

return_deeplink

string

Deeplink, на который требуется переадресовать пользователя после успешной оплаты через мобильное приложение.

Указывается либо return_url, либо return_deeplink

Ответы

Ссылка для проведения оплаты

Schema

error

object

user_message

string

Сообщение для пользователя

error_description

string

Техническое описание ошибки

error_code

string

Код ответа

form_url

string

URL платежной формы, на который надо переадресовать клиента

deeplink

string

Deeplink, на который надо переадресовать клиента для оплаты в мобильном приложении

{
  "error": {
    "user_message": "",
    "error_description": "",
    "error_code": "0"
  },
  "form_url": "https://3dsec.sberbank.ru/payment/merchants/test/payment_ru.html?mdOrder=70906e55-7114-41d6-8332-4609dc6590f4",
  "deeplink": "sberbankonline://connect?addcard"
}

bad input parameter

Schema

error

object

user_message

string

Сообщение для пользователя

error_description

string

Техническое описание ошибки

error_code

string

Код ответа

{
  "error": {
    "user_message": "",
    "error_description": "",
    "error_code": "0"
  }
}

Access token is missing or invalid

Unexpected error

Schema

error

object

user_message

string

Сообщение для пользователя

error_description

string

Техническое описание ошибки

error_code

string

Код ответа

{
  "error": {
    "user_message": "",
    "error_description": "",
    "error_code": "0"
  }
}

Loading...