Как подключить

интернет-эквайринг через Открытый API Точки

Как подключить интеграцию

1. В интернет-банке перейдите в раздел «Сервисы» — «Интеграции и API».

2.

Нажмите «Подключить» в правом верхнем углу.

3.

Выберите способ авторизации. В большинстве случаев достаточно выбрать вариант «Сгенерировать JWT-ключ». Подробнее об альтернативных вариантах вы можете прочитать в полной версии документации.

4.

Назовите ключ, как посчитаете нужным, например «Эквайринг».

5.

Выдайте доступы для ИП или ООО, которому был подключён интернет-эквайринг. Можно оставить все галочки активными, обязательно должны быть включены

«Просмотр реквизитов» и «Создание ссылки на оплату картой и через СБП».

6.

Определите срок действия доступа. Для удобства можно оставить «Бессрочно». Дайте согласие на обработку персональных данных и оферту по использованию открытого АРІ.

7.

Подтвердите всё смс-кодом и вы увидите ваш токен на главной странице

«Интеграции и API».

Как настроить приём платежей на сайте или в онлайн-сервисе

Эта часть инструкции понадобится разработчику, который будет настраивать приём платежей на сайте или в онлайн-сервисе. Здесь мы расскажем о логике использования платёжных методов, которую нужно будет внедрить.

​

Мы рассмотрим логику работы платежных методов на примере сервиса для тестирования API — Postman.

​

1. Настройте коллекцию и окружение в Postman.

​

1.2 Настройка коллекции. Перейдите в документацию и в новом окне браузера откройте ссылку «Коллекция запросов».

1.2 В открывшемся окне скопируйте адресную строку.

1.3 Откройте Postman, нажмите на Import.

1.4 Вставьте значение из адресной строки коллекции.

1.5 После этого созданная коллекция должна появиться в пространстве «Postman» с названием «OpenAPI».

1.6 Теперь нужно настроить окружение, для этого перейдите в документацию и откройте в отдельном окне браузера вкладку «Настройка окружения».

1.7 В открывшейся вкладке снова скопируйте адресную строку.

• Снова зайдите в Postman и также импортируйте скопированное значение.

​

• Откройте в Postman вкладку «Environments» и напротив «Setting» нажмите на галочку, чтобы она стала активной.

2. Коллекция и окружение настроены, перейдём к работе с платёжными методами. Первым нужно вызвать метод Get Customer List — список компаний. Найдите метод в Postman и нажмите на него.

3. Вернитесь в интернет-банк и скопируйте JWT-токен.

4. Вернитесь в Postman, найдите и очистите поле «Token», вставьте скопированное значение.

5. Отправьте запрос.

6. Если всё пройдёт успешно, вы получите массив данных ваших ИП или ООО, у которых открыт счёт в Точке. Вам нужно найти то, к которому подключён интернет-эквайринг и из объекта «Customer» скопировать параметр «Customer

code» — девятизначное число, начинающиеся с цифры 3. Обязательно проверьте, что параметр «CustomerType» под ним имеет значение «Business», а не

«Personal».

7. Теперь в коллекции Postman откройте папку «Платёжные ссылки» и выберите метод «Создание ссылки на оплату».

8. Откройте тело запроса: Body — Raw — Json.

9. Перейдите в блок кода и заполните параметры:
• customerCode — ранее скопированное девятизначное число, начинающееся с 3, указать в двойных кавычках;
• amount — сумма, которую вам должен заплатить покупатель;
• purpose — название товара или услуги, которую оплачивает покупатель;
• paymentMode — доступные покупателю способы оплаты — через платёжную ссылку или QR-код Системы быстрых платежей — «sbp», или банковской картой — «card»;
• redirectUrl — адрес страницы на вашем сайте, куда покупатель должен попасть после оплаты.

​

В блоке «Authorization» вставьте JWT-токен, скопированный из интернет-банка, и отправьте запрос.

10. Если всё пройдёт успешно, вы получите в ответе параметр «paymentLink» — это ссылка, по которой вы должны отправить покупателя. Если откроете её в браузере, увидите страницу выбора способов оплаты, форму ввода реквизитов банковской карты, QR-код СБП. Для следующего метода понадобится параметр «operationId». Сделайте тестовый платёж любым способом.

11. После оплаты заказа нужно получить информацию о его статусе. Для этого скопируйте параметр «operationId», который вернул ответ на запрос «Создание ссылки на оплату». Вернитесь в коллекцию и в папке «Платёжные ссылки» выберите метод «Информация об операции».

12. Вставьте JWT-токен в разделе «Authorization», а в строке с адресом отправки запроса вставьте скопированный operationId без двойных кавычек. Отправьте запрос.

13. В ответе вы увидите параметр «status» = «APPROVED», это значит, что покупатель успешно оплатил товар или услугу и продавец может приступать к отправке или оказанию. Другие возможные значения параметра описаны в полной версии документации.
14. Иногда нужно сделать возврат денег покупателю. Для этого в коллекции обратитесь к методу «Возврат платежа». Вставьте ваш JWT-токен в раздел

«Authorization», скопируйте и вставьте operationId без двойных кавычек, укажите сумму возврата — она не может быть больше суммы оплаты. Отправьте запрос.

15. В параметре «isRefund» стоит значение «true», значит заявка на возврат успешно оформлена и в течение 30 календарных дней покупатель получит свои деньги. Обычно это занимает меньше времени — не более недели.

Это были основные методы Открытого API Точки, которые понадобятся вам для работы с интернет-эквайрингом. Ознакомьтесь с полной версией документации или передайте ссылку на неё и JWT-токен вашему разработчику, чтобы он вызывал их в момент оплаты покупателя.

Мы всегда на связи

Если у вас или вашего разработчика будут вопросы, пишите в чат интернет-банка или на почту поддержки Открытого API Точки: public-api@tochka.com

tochka.com