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

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

POST

/cards

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

Запрос

• application/json

Body

return_urls

user_id object

oneOf

• partner_client_id
• user_uid
• encrypted_sub_id
• partner_client_sub_id

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 objectrequired

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

Ответы

• 200
• 400
• 401
• default

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

• application/json

• Схема
• Пример из схемы

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

• application/json

• Схема
• Пример из схемы

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

• application/json

• Схема
• Пример из схемы

Schema

error object

user_message

string

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

error_description

string

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

error_code

string

Код ответа

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

Loading...

Loading...