Создание заявки на перевод с карты на карту и расчет комиссии из ERP-системы клиента
Запрос позволяет создать черновик документа «Заявление на перевод с бизнес-карты и получить актуальный размер комиссии за перевод в ответе. POST-запрос должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка и реквизиты перевода для расчета комиссии в теле запросе.
В блоке receiverInfo укажите либо номер карты получателя, либо номер телефона получателя, в зависимости от способа перевода.
В параметре scope ссылки авторизации пользователя должен быть укажите значение BUSINESS_CARDS_TRANSFER для получения доступа к этому запросу.
В песочнице при создании заявки на перевод и расчете комиссии ответ зависит от того, какой externalId вы укажете.
Что обязательно нужно передать в запросе:
externalId— идентификатор заявки, который вы сгенерировали на своей сторонеtransferPurpose— назначение переводаamount— сумма перевода (должна быть больше 0)senderInfo.businessCardId— идентификатор карты отправителяreceiverInfo— данные получателя. Нужно передать или номер телефона, или зашифрованный номер карты
Как правильно заполнить данные отправителя:
В поле senderInfo.businessCardId всегда указывайте значение 1d192d78-7877-412a-a17b-cceaf5de1803. Это тестовая бизнес-карта, заведенная в песочнице.
Как шифровать номер карты получателя:
Если вы передаете номер карты в зашифрованном виде (поле encryptedCardNumber), его нужно зашифровать по следующему алгоритму:
- Получите публичный ключ через запрос
GET /v2/corporate-cards/transfer/public-key - Зашифруйте номер карты алгоритмом
RSA/ECB/OAEPWithSHA-1AndMGF1Padding - Полученную зашифрованную строку укажите в поле
encryptedCardNumber
Какие номера карт можно шифровать и передавать:
| Номер карты (DPAN) | С каким externalId использовать | Что вернется в ответе |
|---|---|---|
2202201000011111 | 56721b72-dcab-40e8-af62-9180a8e74195 | ФИО + ПАО ВСПЫШКА + Сбербанк |
2202201000011112 | 844ee51d-10dc-43fd-9f18-d8672593558d | ФИО + Сбербанк |
2202201000011113 | e068ee1a-4b34-41ce-abd2-e550d5c786f3 | только банк ВТБ |
Если у вас нет возможности шифровать номер карты, вы можете передать номер телефона. Шифровать его не нужно. В поле phoneNumber укажите 79112223344, а в externalId — 4ef04bbe-f861-4407-93a2-4054cb7baa3c.
Какие ответы можно получить:
externalId | Что будет в ответе |
|---|---|
56721b72-dcab-40e8-af62-9180a8e74195 | Успешный ответ. В receiverInfo вернутся ФИО получателя, название организации ПАО ВСПЫШКА и банк ПАО Сбербанк |
844ee51d-10dc-43fd-9f18-d8672593558d | Успешный ответ. В receiverInfo вернутся ФИО получателя и банк ПАО Сбербанк |
e068ee1a-4b34-41ce-abd2-e550d5c786f3 | Успешный ответ. В receiverInfo вернется только название банка ВТБ |
4ef04bbe-f861-4407-93a2-4054cb7baa3c | Успешный ответ. В ответе будут только данные по номеру телефона. В receiverInfo.phoneNumber — 79112223344 |
9a3b5c8f-2d4e-4a6f-8b1c-3d2e5f7a9b0c | Успешный ответ. Статус заявки — FORM (черновик). Заявка создана, требуется подтверждение |
1e2f3a4b-5c6d-4e7f-8a9b-0c1d2e3f4a5b | Успешный ответ. Статус заявки — ERROR (ошибка исполнения). Нужно сформировать новую заявку |
Какие ошибки могут возникнуть при неправильном заполнении:
| Что не так | Какой код вернется | Код ошибки |
|---|---|---|
Сумма amount меньше или равна 0 | HTTP 400 | 428-072 |
senderInfo.businessCardId не равен 1d192d78-7877-412a-a17b-cceaf5de1803 | HTTP 400 | 428-172 |
В receiverInfo не указаны ни phoneNumber, ни encryptedCardNumber | HTTP 400 | 428-001 |