Разовая покупка (пример: смартфон)

Бизнес-история

Покупатель один раз оплачивает смартфон. Рекуррентная подписка не нужна.

Настройка в админке

Создайте продукт «Смартфоны» (через API или в контексте планов).
Вариант A: создайте план типа 3 (разовый) с полной ценой устройства и сроком интервала формально «1 месяц» или минимальным — если продуктовая логика BillBill для разовых планов у вас завязана на подписку на один период с немедленным закрытием (уточните у поддержки для вашего облака).
Вариант B (универсальнее для «чистой» разовой продажи): оформляйте счёт (BizTypeInvoice / разовый поток счёта) и платёж через Merchant API без долгоживущей подписки.

Пример вызовов (Merchant API, JS)

Используйте @wilix/billbill-client-js, класс MerchantApi:


import { ApiClient, MerchantApi } from '@wilix/billbill-client-js'
 
const api = new MerchantApi(
  new ApiClient({
    apiKey: process.env.BILLBILL_MERCHANT_KEY!,
    userAgent: 'MyShop/1.0 OpenAPI'
  })
)
 
// 1) Пользователь (если ещё нет)
// await api.userNew({ ... })
 
// 2) Счёт на разовую продажу + платёж — конкретные методы и тела см. OpenAPI (invoiceNew, paymentNew)

Точные имена полей (invoiceNew, productNew, привязка к userId) возьмите из актуального Swagger и типов InvoiceNewReq, PaymentNewReq в клиенте.

Ожидаемый результат

В админке появляется счёт и платёж в статусе успеха после оплаты.
Подписка либо отсутствует, либо краткоживущая техническая — в зависимости от выбранного варианта A/B.

Когда выбирать другой рецепт

Если к смартфону добавляются чехол и наушники за раз — см. Покупка с аддонами.