Быстрый старт

В этом руководстве вы узнаете, как за 5 минут начать работу с Love&Pay API, от получения ключей до выполнения первых успешных запросов. Мы рассмотрим основные операции с транзитными кошельками и вебхуками.

Предварительные требования#

Аккаунт партнёра в Love&Pay.
Доступ к кабинету для получения API-ключей.
Установленный cURL для выполнения HTTP-запросов.

Шаги#

Шаг 1: Получение API-ключей#

Войдите в кабинет партнёра Love&Pay.
Перейдите в раздел API-доступ.
Скопируйте ваши X-API-Key и X-API-Secret.

Информация

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

Шаг 2: Получение доступных сетей#

Выполните запрос для получения списка доступных сетей и монет для транзитных операций.

bash

curl -X GET https://api.bill.loveandpay.io/v1/transit/networks \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"

Пример ответа:

json

{
  "networks": [
    {
      "name": "USDT-TRC20",
      "coins": ["USDT"]
    },
    {
      "name": "PromptPay",
      "coins": ["THB"]
    }
  ]
}

Шаг 3: Создание транзитного кошелька#

Создайте новый транзитный кошелёк, указав метку и сеть.

bash

curl -X POST https://api.bill.loveandpay.io/v1/transit/wallets \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"label": "My Wallet", "network": "USDT-TRC20"}'

Пример ответа:

json

{
  "wallet": {
    "id": "wallet_123456",
    "label": "My Wallet",
    "network": "USDT-TRC20",
    "balance": 0.0
  }
}

Шаг 4: Настройка вебхука#

Установите URL и события для вебхука.

bash

curl -X PUT https://api.bill.loveandpay.io/v1/webhook \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://yourdomain.com/webhook", "events": [], "enabled": true}'

Пример ответа:

json

{
  "webhook": {
    "url": "https://yourdomain.com/webhook",
    "events": [],
    "enabled": true
  }
}

Шаг 5: Отправка тестового вебхука#

Отправьте тестовое событие на указанный URL вебхука для проверки интеграции.

bash

curl -X POST https://api.bill.loveandpay.io/v1/webhook/test \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"event": "payment_received"}'

Пример ответа:

json

{
  "success": true,
  "message": "Test webhook sent successfully."
}

Совет

После успешного выполнения этих шагов вы готовы к интеграции с Love&Pay API и можете начать обработку реальных транзакций. Теперь вы знаете, как быстро начать работу с Love&Pay API, от получения ключей до выполнения первых успешных запросов. Для более подробной информации о каждой операции обратитесь к соответствующим разделам документации.