Тестирование
Вы можете протестировать интеграцию в тестовой среде, прежде чем начать принимать реальные платежи.
Для получения тестового доступа необходимо:
- Оставьте заявку на подключение https://ecom.airbapay.kz/#application или обратиться к менеджеру.
- Получить креды для подключения к API на тесте.
- Использовать следующий Base URL в запросах к API:
sps.airbapay.kz/acquiring-api
Авторизация
Для получения доступа к сервисам, необходимо вызвать сервис /auth/sign-in/
В ответ сервис вернет access_token Который необходимо вставлять в заголовок запросов.
Пример authorization: Bearer 12345
Создание платежа
Для создания платежа, необходимо вызвать сервис /payments/
В ответ сервис вернет
id - id платежа в платежной системе
invoice_id - id платежа в системе мерчанта
redirect_url - url платежной формы, куда отправлять клиента для ввода карточных данных
Создание платежа по сохраненной карте
Для создания платежа, необходимо вызвать сервис /payments/{cardId} ****cardId - Id карты. В ответ сервис вернет:
id - id платежа в платежной системе
invoice_id - id платежа в системе мерчанта
redirect_url - url платежной формы, куда отправлять клиента для ввода CVV
Сохранение данных карты
Для сохранения данных карты, необходимо вызвать сервис /cards/
В ответ сервис вернет
redirect_url - url платежной формы, куда отправлять клиента для ввода карточных данных
Получение списка сохраненных карт клиента
Для сохранения данных карты, необходимо вызвать сервис /cards/{accountId}
accountId - id клиента в системе мерчанта
В ответ сервис вернет
id - id карты
account_id - id клиента в системе мерчанта
masked_pan - маскированный номер карты
name - имя держателя карты
expire - срок действия карты
Удаление сохраненной карты клиента
- Для удаления карты, необходимо вызвать сервис
/cards/{id}
id - id карты
Тестовые карты
| МПС | PAN | CVC | Expiration |
|---|---|---|---|
| Visa | 4111111111111111 | 123 | 12/2028 |
| Visa | 4444333322221111 | 456 | 12/2028 |
| Visa | 4111111111111616 | 333 | 12/2028 |
| American Express | 341111111111111 | 777 | 12/2028 |
| MasterCard | 5431111111111111 | 111 | 12/2028 |
| MasterCard | 5555555555554444 | 789 | 12/2028 |
Webhook тестового платежа
Подпись сгенерирована с помощью закрытого ключа и хэш-функции SHA256, используя алгоритм PKCS1v15.
Для верификации подписи используйте публичный ключ и оригинальное сообщение для генерации подписи.
Публичный ключ доступен по следующему адресу:
https://sps.airbapay.kz/acquiring/sign/public.pem
Сообщение собирается следующим образом:
id+invoice_id+amount+currency+status+description
Посмотреть тестовый проект
Вы можете скачать проект для тестирования API интеграции в удобном для вас приложении: