Привязка карты

Карта привязывается для:

• проверки принадлежности ее клиенту;
• осуществления переводов без указания реквизитов карты по внутреннему идентификатору карты в системе платёжного шлюза;
• осуществления рекуррентных операций (операций безакцептного списания средств с карты(счёта) клиента)

Автоматическая генерация идентификатора карты происходит при проведении первой успешной оплаты или выплаты по банковской карте, а также при успешном холдировании средств.

Схема регистрации карты:

1. Пользователь заходит на сайт продавца и выбирает услугу.
2. Пользователь нажимает на кнопку "оплатить" и инициирует вызов платежного виджета.
3. На стороне платёжной платформы выполняются подготовка виджета с учётом параметров вызова и передача к пользовательскому устройству данных для отображения.
4. Платёжный виджет отображается в пользовательском интерфейсе. Пользователь вводит реквизиты карты для первой тестовой оплаты.
5. Данные передаются в платёжную платформу через серверную часть веб-сервиса.
6. На стороне платёжной платформы обрабатываются данные карты и данные платежа. Результат передается в платёжную среду.
7. В платёжной среде открывается страница банка-эмитента. Пользователь подтверждает платёж с помощью кода из SMS. Нажимает "оплатить". Выполняются проверка карты и обработка платежа. После успешной проверки для карты формируется идентификатор. В платёжную платформу поступает информация о результате
8. В платёжной платформе обрабатывается итоговая информация, после чего на заданный URL контрагента (если указан колбэк) отправляется программное оповещение о платеже.
9. Происходит перенаправление пользователя на страницу клиента в соответствии с результатом оплаты.

Пример API запроса привязки карты

Домен для запросов - https://api.vepay.online

1. Привязка карты - отправляется запрос по API:

/card/reg

    {
    "type": 1,
    "extid": "УФ-906/2187534.5e045b788e3c3",
    "timeout": 10,
    "successurl": "https://exemple.com/successurl",
    "failurl": "https://exemple.com/failurl",
    "cancelurl": "https://exemple.com/cancelurl",
    "postbackurl": "https://exemple.com/postbackurl",
    "postbackurl_v2": "https://exemple.com/postbackurl_v2"
}

  

Ответ:

    {
    "status": 1,
    "message": "string",
    "id": 101464,
    "url": "https://test.vepay.online/pay/form/101464"
}

  

2. Клиент переходит на страницу тестового платежа (параметр url в ответе), где вводит данные карты, которая будет сохранена в системе.

3. После завершения оплаты отправляется запрос по API на получение идентификатора карты:

/card/get

    {
    "id": 101464,
    "type": 1
}

  

Ответ:

    {
    "status": 1,
    "message": "string",
    "card": {
        "id": 356,
        "num": "540436******3366",
        "exp": "10/23",
        "holder": "Visa"
    }
}

  

Данные карты необходимо сохранить, чтобы использовать их для следующих выплат.

Параметры запроса для регистрации карты (/card/reg):

Параметры ответа для Регистрации карты (/card/reg):

Параметры запроса для получения идентификатора карты (/card/get)

Параметры ответа для получения идентификатора карты (/card/get)