Интеграция iBonus с POS-системами

1. Введение

Интеграция iBonus с POS-системами позволяет автоматически начислять и списывать бонусы при оплате на кассе. Поддерживаются популярные POS-системы, включая 1С, R-Keeper, Poster и другие.

2. Аутентификация

Для взаимодействия с API iBonus необходимо использовать **API-ключ**, который можно получить в личном кабинете.

GET https://api.ibonus.app/v1/auth
Headers:
Authorization: Bearer YOUR_API_KEY

3. Привязка клиента к чеку

Перед оплатой можно определить клиента в системе iBonus, чтобы начислить или списать бонусы.

POST https://api.ibonus.app/v1/pos/customers/find
Headers:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Body:
{
  "phone": "+996700600600"
}

4. Начисление бонусов при оплате

После успешной оплаты можно начислить бонусы клиенту:

POST https://api.ibonus.app/v1/pos/bonuses/add
Headers:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Body:
{
  "customer_id": "123456",
  "amount": 150
}

5. Списание бонусов

Клиент может оплатить часть покупки бонусами, и это можно сделать через POS-систему.

POST https://api.ibonus.app/v1/pos/bonuses/redeem
Headers:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Body:
{
  "customer_id": "123456",
  "amount": 50
}

6. Проверка баланса клиента

Перед списанием бонусов можно проверить текущий баланс клиента.

GET https://api.ibonus.app/v1/pos/customers/123456/balance
Headers:
Authorization: Bearer YOUR_API_KEY

7. Полная документация

Более подробную информацию можно найти в официальной документации API.