AirbaPay Docs

Appearance

Тестирование ​

Вы можете протестировать интеграцию в тестовой среде, прежде чем начать принимать реальные платежи.

Для получения тестового доступа необходимо: ​

  1. Оставьте заявку на подключение https://ecom.airbapay.kz/#application или обратиться к менеджеру.
  2. Используйте тестовые креды или попросите менеджера выдать индивидуальные тестовые данные.
  3. Base URL в запросах к API: ps.airbapay.kz/acquiring-api

Тестовые креды ​

json
{
   "user": "test-merchant",
   "password": "123456",
   "terminal_id": "64216e7ccc4a48db060dd689" 
}

Авторизация ​

Адрес для запроса - https://sps.airbapay.kz/acquiring-api/api/v1/auth/sign-in

В ответ сервис вернет access_token , который необходимо вставлять в заголовок запросов.

Пример:  authorization: Bearer 12345

Создание платежа ​

Адрес запроса - https://sps.airbapay.kz/acquiring-api/api/v2/payments

В ответ сервис вернет

id - id платежа в платежной системе

invoice_id - id платежа в системе мерчанта. invoice_id уникальный в рамках одного терминала. В случае чего, вы получите ошибку:

json
{
   "error": {
      "status": "Internal Server Error",
      "code": 500,
      "message": "Internal Server Error"
   }
}

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 - срок действия карты

Удаление сохраненной карты клиента ​

  1. Для удаления карты, необходимо вызвать сервис /cards/{id}

id - id карты

Тестовые карты ​

МПСPANCVCExpiration
Visa411111111111111112312/2028
Visa444433332222111145612/2028
Visa411111111111161633312/2028
American Express34111111111111177712/2028
MasterCard543111111111111111112/2028
MasterCard555555555555444478912/2028

Webhook тестового платежа ​

Подпись сгенерирована с помощью закрытого ключа и хэш-функции SHA256, используя алгоритм PKCS1v15.

Для верификации подписи используйте публичный ключ и оригинальное сообщение для генерации подписи.

Публичный ключ доступен по следующему адресу:

https://sps.airbapay.kz/acquiring/sign/public.pem

Сообщение собирается следующим образом:

id+invoice_id+amount+currency+status+description

Посмотреть тестовый проект ​

Вы можете скачать проект для тестирования API интеграции в удобном для вас приложении: