Быстрый старт с Love&Pay Crypto API

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

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

   1. Войдите в свой кабинет Love&Pay.
   2. Перейдите в раздел «Доступ к API».
   3. Скопируйте ваш публичный ключ партнёра.

2. Шаг 2: Настройка авторизации

   Для всех запросов необходимо передавать заголовки авторизации: x-api-key, x-signature и x-timestamp.

   • x-api-key: Ваш API-ключ.
   • x-signature: HMAC-SHA256 подпись в hex, составленная из строки METHOD + PATH + TIMESTAMP + SHA256(BODY) + BIND.
   • x-timestamp: Время запроса в миллисекундах Unix.

3. Шаг 3: Получение поддерживаемых сетей

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

   bash Копировать

   curl -X GET https://api.prod.loveandpay.io/api/v2/crypto/networks \
   -H "x-api-key: YOUR_API_KEY" \
   -H "x-signature: YOUR_SIGNATURE" \
   -H "x-timestamp: YOUR_TIMESTAMP"
   

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

   json Копировать

   {
     "success": true,
     "networks": [
       {"name": "TRON", "currency": "USDT"},
       {"name": "Ethereum", "currency": "USDT"}
     ],
     "invoiceNetworks": ["TRON"],
     "requestId": "123e4567-e89b-12d3-a456-426614174000"
   }
   

4. Шаг 4: Проверка баланса

   Узнайте ваш текущий баланс и условия по наценкам и комиссиям.

   bash Копировать

   curl -X GET https://api.prod.loveandpay.io/api/v2/crypto/balance \
   -H "x-api-key: YOUR_API_KEY" \
   -H "x-signature: YOUR_SIGNATURE" \
   -H "x-timestamp: YOUR_TIMESTAMP"
   

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

   json Копировать

   {
     "success": true,
     "balance": {
       "available": 1000.00,
       "received": 1500.00,
       "paidOut": 500.00,
       "adjustments": 0.00
     },
     "requestId": "123e4567-e89b-12d3-a456-426614174001"
   }
   

5. Шаг 5: Выставление счёта

   Создайте новый счёт на оплату в USDT.

   bash Копировать

   curl -X POST https://api.prod.loveandpay.io/api/v2/crypto/invoices \
   -H "x-api-key: YOUR_API_KEY" \
   -H "x-signature: YOUR_SIGNATURE" \
   -H "x-timestamp: YOUR_TIMESTAMP" \
   -H "Content-Type: application/json" \
   -d '{
     "amount": 100.00,
     "network": "TRON",
     "externalId": "unique-id-123",
     "successUrl": "https://yourdomain.com/success",
     "description": "Payment for order #123",
     "customerName": "John Doe",
     "customerEmail": "john.doe@example.com",
     "expiresInMinutes": 60
   }'
   

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

   json Копировать

   {
     "success": true,
     "invoice": {
       "address": "TXYZ...",
       "expectedAmount": 100.023,
       "paymentLink": "https://pay.loveandpay.io/invoice/123",
       "feeAmount": 0.5,
       "netAmount": 99.5
     },
     "requestId": "123e4567-e89b-12d3-a456-426614174002"
   }
   

6. Шаг 6: Отправка выплаты

   Отправьте выплату с вашего баланса на внешний адрес.

   bash Копировать

   curl -X POST https://api.prod.loveandpay.io/api/v2/crypto/payouts \
   -H "x-api-key: YOUR_API_KEY" \
   -H "x-signature: YOUR_SIGNATURE" \
   -H "x-timestamp: YOUR_TIMESTAMP" \
   -H "X-Idempotency-Key: unique-key-456" \
   -H "Content-Type: application/json" \
   -d '{
     "note": "Payout for service",
     "amount": 50.00,
     "address": "TXYZ...",
     "network": "TRON"
   }'
   

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

   json Копировать

   {
     "success": true,
     "payout": {
       "id": "payout-id-789",
       "status": "PENDING",
       "amount": 50.00,
       "fee": 0.5,
       "netAmount": 49.5
     },
     "requestId": "123e4567-e89b-12d3-a456-426614174003"
   }
   

Теперь вы готовы использовать Love&Pay Crypto API для обработки платежей и выплат в USDT.