Вступ

MSB Finance - це багатоканальна платіжна платформа, яка об'єднує покупців, онлайн-продавців, постачальників послуг, еквайрів, банки та платіжні системи.

Можливості

MSB Finance надає широкий спектр способів приймання платежів, виплат клієнтам, а також інші послуги:

• Приймання платежів на нашій платіжній сторінці для мерчантів, які не мають сертифіката відповідності PCI DSS або просто не хочуть обробляти конфіденційні дані платіжних карток на своїй стороні. Даний метод приймання платежу дозволяє приймати оплату карткою, здійснювати платежі по токену картки, так і використовувати Apple Pay, Google Pay, Masterpass та інші способи оплати
• Приймання платежів по host-2-host протоколу для мерчантів, які мають сертифікат PCI DSS, та працюють з даними платіжних карток на своїй стороні. У цьому випадку доступна оплата карткою, або з використанням токена раніше збереженої картки
• Токенізація картки, можливий як окремий метод верифікації картки з токенізацією, так і отримання токена картки після успішного платежу
• Виплати на картку з використанням повного номера картки
• Виплати на картку з використанням токена картки
• Інші види платежів

З чого почати?

Насамперед потрібно зрозуміти, які послуги платіжного шлюзу будуть вами використовуватися. Опис видів доступних сервісів ви можете знайти в розділі Послуги цієї документації, в якому послідовно та з прикладами описано процес проведення транзакції для кожного типу послуги.

Детальний опис кожного ендпоінту API, що згадується в документації послуг, можна знайти у відповідному розділі ендпоінти API.

У ході інтеграції знадобиться також розділ Довідники, в якому ви зможете знайти перелік статусів транзакцій, коди помилок API, коди причин відмови та списки тестових номерів карток.

Коли ви будете готові приступити до інтеграції, ми видамо вам необхідні облікові дані та інструкції для роботи з API у тестовому режимі. В цьому режимі не проводиться жодних реальних фінансових операцій і можуть бути використані лише тестові картки.

увага

На даний момент тестовий режим доступний не для всіх методів. Тому, якщо для метода немає тестового режиму, мерчанту видаються облікові дані для роботи в продакшн-режимі

Отримання облікових даних для роботи з API

Для роботи з API вам будуть видані облікові дані для роботи в тестовому оточенні, які включають:

Ім'я	Опис	Приклад
api_url	Базовий URL для запитів до API	https://api.pay.msb.ua/
account_id	Ідентифікатор акаунта мерчанта у платіжному шлюзі MSB Finance	1234
wallet_id	Ідентифікатор гаманця мерчанта у платіжному шлюзі MSB Finance. Кожен гаманець зберігає баланс у певній валюті. Ви можете мати один або більше wallet_id, якщо це необхідно	1234
point_id	Ідентифікатор точки прийому платежів. У деяких випадках може бути кілька точок. Налаштування вашої платіжної сторінки, набір доступних послуг, комісії, налаштування захисту від шахрайства можуть бути різними для різних point_id	1234
service_id	Ідентифікатор послуги. Зазвичай для вашої точки доступно кілька послуг (наприклад, інтернет-еквайринг і виплати на картку – це окремі послуги, що мають унікальний service_id)	1234
api_token	Секретний рядок, який використовується для автентифікації в API	aiGha$et0ainah4%*eu9Vish8oo

Перехід у продакшн

Після завершення тестування для вас буде створено новий обліковий запис для роботи в продакшн-режимі. Ви отримаєте нові account_id, wallet_id, point_id, api_token та інші service_id для кожного типу послуги. Тестовий обліковий запис при цьому також залишиться активним і ви зможете продовжувати його використовувати для тестування будь-яких доробок.

Підтримка

Під час інтеграції, у вас буде онлайн доступ до нашої техпідтримки, де ви зможете ставити всі питання, пов'язані з API, що цікавлять, якщо раптом не знайшли відповіді в даній документації, яка регулярно доповнюється на підставі питань, що часто надходять від мерчантів.

Вдалої вам інтеграції та якнайшвидшого запуску в продакшн!