# Рассрочка Mandarin.life
# Схема взаимодействия
# Описание процесса
Краткое описание процесса
- Отправка магазином API-запроса на оплату в кредит или рассрочку. Переадресация браузера плательщика на полученную ссылку
userWebLink
. - Аутентификация плательщика по номеру мобильного телефона с помощью СМС-кода, и заполнение анкеты в личном кабинете (opens new window). Для онлайн-оформления обязательна загрузка фотографий.
- Ожидание плательщиком предложений кредиторов на странице покупки в личном кабинете.
- Выбор плательщиком подходящего предложения (срок в месяцах, размер переплаты, наличие/отсутствие первоначального взноса).
- Ввод плательщиком данных банковской карты (для автосписаний в пользу кредитора). Опционально возможна оплата первоначального взноса (если плательщик выбрал предложение, которое включает в себя первоначальный взнос).
- Подписание плательщиком договора займа с помощью СМС-кода.
- Возврат браузера плательщика на url магазина. Получение магазином callback-уведомления.
Полное описание процесса онлайн-оформления находится в отдельной статье в wiki Mandarin (opens new window), начиная с аутентификации плательщика по номеру мобильного телефона (первый шаг по подаче новой заявки на финансирование покупки через интерфейс можно пропустить, т.к. вы уже предоставили в API-запросе на кредит все нужные сведения).
# Тестовые данные
Для тестирования необходимо осуществить подачу заявки от имени плательщика и довести ее до подписания договора СМС-кодом.
Изначально при подключении вам будет установлен тестовый режим кредитования. При этом весь процесс будет выглядеть как настоящий, но в системах кредиторов займ будет рассмотрен как тестовый, и по нему не будет реального движения денежных средств.
В рамках тестирования необходимо выбирать варианты с нулевой предоплатой. В этом случае необходимо использовать реальную карту, на которой будет заблокирован 1 рубль и произведен его возврат после подписания.
Тестирование опции первоначального взноса возможно с использованием данных тестовых карт, которые доступны, если ваш проект был переведен в тестовый режим использования банковских карт. Для этого оставьте заявку в Cлужбу поддержки (opens new window).
Для тестирования рекомендуется использовать следующие данные
Параметр | Значение |
---|---|
ФИО | Шариков Полиграф Полиграфович |
Пол | Мужской |
Дата рождения | 19.05.1975 |
Серия и номер паспорта | 7709 543987 |
Выпустивший орган | УПРАВЛЕНИЕ ФЕДЕРАЛЬНОЙ МИГРАЦИОННОЙ СЛУЖБЫ РОССИИ ПО ГОР.МОСКВЕ |
Дата выпуска | 01.01.2011 |
Код подразделения | 770-001 |
Адрес проживания | Москва, пр. Мира 111, кв. 11 |
Данные о занятости | Любые |
ОБРАТИТЕ ВНИМАНИЕ!
Важно использовать существующий номер телефона и email, так как в СМС придет пароль для подписания договора, а на email придет пароль от личного кабинета при первичной заявке (тогда в дальнейшем можно будет продолжить тестирование с этим же аккаунтом, и не заполнять анкету заново при повторной подаче заявки).
# Параметры запросов
Параметр | Тип | Обязателен | Описание и возможные значения |
---|---|---|---|
payment | object | Да | Объект, содержащий данные о транзакции. |
payment.action | string | Да | Тип транзакции. Для Mandarin.life всегда "action": "pay" . |
payment.method | string | Да | Индикатор оплаты в кредит/рассрочку. Для Mandarin.life всегда method : credit . |
payment.orderId | string | Да | Номер заказа в вашей системе. Должен быть уникальным среди успешных операций! |
payment.price | string | Да | Сумма платежа. Разделитель - точка. |
payment.orderActualTill | string | Да | Срок резервирования товара/услуги. После указанной даты оплата будет невозможна. Формат: 2020-02-20 12:34:56+00:00 . |
customerInfo | object | Да | Объект, содержащий данные о пользователе. |
customerInfo.email | string | Да | Email пользователя. Формат: user@example.com . |
customerInfo.phone | string | Да | Телефон пользователя в формате РФ: +79001234567 . |
customValues[] | array | Нет | Массив, содержащая дополнительную информацию к данным платежа. Может содержать до 8 пар параметров. |
customValues[].name | string | Нет | Заголовок параметра. |
customValues[].value | string | Нет | Значение параметра. |
metadata | object | Да | Объект, который для Mandarin.life содержит дополнительную информацию, которая будет показана пользователю при оформления кредита/рассрочки. |
metadata.type | string | Да | Тип запроса: credit (займ, с переплатой для плательщика) или installments (рассрочка, без переплаты). |
metadata.purchase_amount | string | Да | Стоимость товара без учетка скидки. Разделитель - точка. Если "type": "installments" , то поле обязательно. Если не передано, то значение "type": "installments" будет проигнорировано! |
metadata.discount | string | Да | Размер скидки от стоимости товара, предоставляемый продавцом. Разделитель - точка. Если "type": "installments" , то поле обязательно. Если не передано, то значение "type": "installments" будет проигнорировано! |
metadata.picture_url | string | Нет | Ссылка на картинку товара/услуги. |
metadata.description | string | Нет | Описание товара (возможно использование html-тегов). |
urls | object | Нет | Объект, содержащий url. Если отсутствует, то используются url из настроек. |
urls.return | string | Нет | Url для редиректа пользователя после оплаты. |
urls.callback | string | Нет | Url для отправки callback-уведомления о статусе трaнзакции. |
# Оплата в кредит
Данный метод используется для создания запроса со стороны магазина на продажу товара/услуги в кредит. Плательщик осуществит оплату кредитными деньгами, оформив займ (на 3, 6, 9, 12 или 15 месяцев). Средства будут перечислены магазину сразу после оформления. Плательщик будет платить ежемесячные взносы в пользу кредитора, при этом сумма переплаты финансируется плательщиком.
Перечень и описание параметров запроса, а также их обязательность приведены в отдельной таблице.
Транзакция будет осуществлена в асинхронном режиме. В синхронном ответе вы получите id
транзакции и userWebLink
, на который необходимо перенаправить пользователя.
После окончания оформления кредита вы получите callback-уведомление.
Запрос
POST https://secure.mandarinpay.com/api/transactions
{
"payment": {
"action": "pay",
"method": "credit",
"orderId": "your_unique_order_id",
"price": "1000.00",
"orderActualTill": "2020-02-20 12:34:56+00:00"
},
"customerInfo": {
"email": "user@example.com",
"phone": "+79001234567"
},
"customValues": [
{"name": "first parameter to save and show", "value": "p1"},
{"name": "second parameter to save and show", "value": "p2"}
],
"metadata": {
"type": "credit",
"picture_url": "http://yourdomain.ru/bestgood.png",
"description": "Это замечательный товар в кредит! <br> Лучше него ничего не бывает и мы его рекомендуем абсолютно всем!"
},
"urls": {
"callback": "http://...",
"return": "http://..."
}
}
Ответ в случае успешного создания транзакции (200 ОК
)
{
"id": "43913ddc000c4d3990fddbd3980c1725",
"userWebLink": "https://secure.mandarinpay.com/Pay?transaction=0eb51e74-e704-4c36-b5cb-8f0227621518"
}
Ответ в случае, если транзакция не создана (400 Bad request
)
{
"error": "Invalid request"
}
# Оплата в рассрочку
Данный метод используется для создания запроса со стороны магазина на продажу товара/услуги в рассрочку. Плательщик осуществит оплату кредитными деньгами, оформив займ (на 3, 6, 9, 12 или 15 месяцев). Средства будут перечислены магазину сразу после оформления. Плательщик будет платить ежемесячные взносы в пользу кредитора, при этом сумма переплаты финансируется магазином за счет скидки (discount
).
Перечень и описание параметров запроса, а также их обязательность приведены в отдельной таблице.
Транзакция будет осуществлена в асинхронном режиме. В синхронном ответе вы получите id
транзакции и userWebLink
, на который необходимо перенаправить пользователя.
После окончания оформления рассрочки вы получите callback-уведомление.
Запрос
POST https://secure.mandarinpay.com/api/transactions
{
"payment": {
"action": "pay",
"method": "credit",
"orderId": "your_unique_order_id",
"price": "1000.00",
"orderActualTill": "2020-02-20 12:34:56+00:00"
},
"customerInfo": {
"email": "user@example.com",
"phone": "+79001234567"
},
"customValues": [
{"name": "first parameter to save and show", "value": "p1"},
{"name": "second parameter to save and show", "value": "p2"}
],
"metadata": {
"type": "credit",
"type": "installments",
"discount": "2000.00",
"purchase_amount": "1000.00",
"picture_url": "http://yourdomain.ru/bestgood.png",
"description": "Это замечательный товар в рассрочку! <br> Лучше него ничего не бывает и мы его рекомендуем абсолютно всем!"
},
"urls": {
"callback": "http://...",
"return": "http://..."
}
}
Ответ в случае успешного создания транзакции (200 ОК
)
{
"id": "43913ddc000c4d3990fddbd3980c1725",
"userWebLink": "https://secure.mandarinpay.com/Pay?transaction=0eb51e74-e704-4c36-b5cb-8f0227621518"
}
Ответ в случае, если транзакция не создана (400 Bad request
)
{
"error": "Invalid request"
}