Создать счёт (оплата по карте)

Создание счёта с оплатой банковской картой

POST /api/v2/invoices

cURL

curl -X POST "https://loveandpay.io/api/v2/invoices" \
  -H "Content-Type: application/json" \
  -H "x-api-key: pk_live_xxx" \
  -H "x-timestamp: 1706012345678" \
  -H "x-signature: a1b2c3d4e5f6..." \
  -d '{
    "amount": 1500,
    "paymentMethod": "card",
    "description": "Оплата заказа #12345",
    "customerName": "Иван Иванов",
    "customerPhone": "[phone]"
  }'

201

{
  "success": true,
  "invoice": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "invoiceNumber": "INV-1234567890-abc123",
    "amount": 1500,
    "currency": "RUB",
    "description": "Оплата заказа #12345",
    "status": "PENDING",
    "paymentMethod": "card",
    "expiresAt": "2024-01-24T12:00:00.000Z",
    "createdAt": "2024-01-23T12:00:00.000Z",
    "externalOrderId": "550e8400-e29b-41d4-a716-446655440001",
    "kycRequired": false,
    "kycVerified": false,
    "receiptRequired": false,
    "paymentLink": "https://loveandpay.io/pay/INV-1234567890-abc123",
    "originalPaymentUrl": "https://secure-pay.example.com/order/abc123",
    "customer": null
  }
}

Для создания счёта с оплатой по банковской карте передайте поле paymentMethod: "card" в теле запроса. Клиент будет перенаправлен на защищённую страницу оплаты картой.

Если поле paymentMethod не передано — счёт создаётся с оплатой через СБП (стандартное поведение).

Заголовки

x-api-key · string · required

Ваш API ключ

x-timestamp · string · required

Unix timestamp в миллисекундах

x-signature · string · required

HMAC-SHA256 подпись

Тело запроса

amount · number · required

Сумма в рублях (не в копейках!). Пример: 1500.50

paymentMethod · string · required

Метод оплаты. Для оплаты по карте укажите "card".

description · string

Описание платежа. Пример: Оплата заказа #12345

customerEmail · string

Email клиента

customerName · string

Имя клиента

customerPhone · string

Телефон клиента в формате +7XXXXXXXXXX

expiresInHours · number · default: "1"

Срок действия счёта в часах

kycRequired · boolean · default: "false"

Требовать KYC верификацию перед оплатой

Ответ

При оплате по карте в ответе появляется дополнительное поле originalPaymentUrl:

Поле	Описание
paymentLink	Платёжная страница Love&Pay — перенаправляет клиента на оплату
originalPaymentUrl	Прямая ссылка на платёжную форму

Для перенаправления клиента используйте paymentLink — это наша обёртка со стилизацией и трекингом. originalPaymentUrl доступен на случай, если нужна прямая ссылка на платёжную форму.

201

{
  "success": true,
  "invoice": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "invoiceNumber": "INV-1234567890-abc123",
    "amount": 1500,
    "currency": "RUB",
    "description": "Оплата заказа #12345",
    "status": "PENDING",
    "paymentMethod": "card",
    "expiresAt": "2024-01-24T12:00:00.000Z",
    "createdAt": "2024-01-23T12:00:00.000Z",
    "externalOrderId": "550e8400-e29b-41d4-a716-446655440001",
    "kycRequired": false,
    "kycVerified": false,
    "receiptRequired": false,
    "paymentLink": "https://loveandpay.io/pay/INV-1234567890-abc123",
    "originalPaymentUrl": "https://secure-pay.example.com/order/abc123",
    "customer": null
  }
}

cURL

curl -X POST "https://loveandpay.io/api/v2/invoices" \
  -H "Content-Type: application/json" \
  -H "x-api-key: pk_live_xxx" \
  -H "x-timestamp: 1706012345678" \
  -H "x-signature: a1b2c3d4e5f6..." \
  -d '{
    "amount": 1500,
    "paymentMethod": "card",
    "description": "Оплата заказа #12345",
    "customerName": "Иван Иванов",
    "customerPhone": "[phone]"
  }'

---

Сравнение методов оплаты

	СБП (по умолчанию)	Карта (paymentMethod: "card")
Поле paymentMethod	Не требуется	"card"
QR-код	Да (qrCode, qrPayload)	Нет
Платёжная ссылка	paymentLink	paymentLink
Прямая ссылка на форму	—	originalPaymentUrl
Способ оплаты	Перевод через банковское приложение	Ввод данных карты