Интеграция iBonus с eCommerce платформами

1. Введение

Интеграция iBonus с интернет-магазинами позволяет автоматически начислять бонусы клиентам при покупках, использовать бонусные баллы для скидок и отправлять уведомления о специальных предложениях. Поддерживаются платформы: **Shopify, WooCommerce, OpenCart, Magento, PrestaShop и другие**.

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

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

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

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

Чтобы начислить бонусы или предоставить скидку, необходимо привязать клиента к заказу.

POST https://api.ibonus.app/v1/ecommerce/customers/find
Headers:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Body:
{
  "email": "[email protected]",
  "phone": "+996700600600"
}

4. Начисление бонусов за покупку

Бонусы могут быть автоматически начислены после оформления заказа.

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

5. Использование бонусов при оплате

Клиенты могут использовать бонусные баллы для оплаты части заказа.

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

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

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

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

7. Уведомления клиентам

Можно автоматически отправлять клиентам уведомления о начисленных бонусах и акциях.

POST https://api.ibonus.app/v1/ecommerce/notifications/send
Headers:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Body:
{
  "customer_id": "123456",
  "message": "Вам начислено 50 бонусов! Спасибо за покупку."
}

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

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