Создание инвойса
XML: CreateInvoice · JSON: POST /invoices
Создаёт инвойс для абонента. Тип покупателя определяет способ оплаты: MobilePhoneCustomer (мобильный биллинг) или BankCardCustomer (карта / СБП) — см. сценарии.
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
ProjectID | int | Да | ID проекта |
ClientIP | string(39) | Нет | IP абонента |
MSISDN | string(20) | Да* | Номер телефона (для мобильного биллинга) |
Email | string(1000) | Нет | E-mail пользователя |
MerchantOrderID | string(38) | Да | ID заказа в системе Продавца |
CustomerPrice. | money | Нет | Сумма с комиссией |
CustomerPrice. | string(3) | Нет | Валюта (по умолчанию RUB) |
CustomerPrice. | bool | Нет | Сумма включает НДС |
CreateIfNotExists | bool | Нет | Создать контракт автоматически (обычно false) |
MerchantContractID | string(64) | Нет | ID контракта в системе Продавца |
AppName | string(256) | Нет | Название приложения |
ProductName | string(256) | Нет | Название продукта |
ExpectedBillingResult | enum | Нет | Sandbox: Success / Failed / SuccessSequencePayment / FailedSequencePayment |
Ответ
| Поле | Тип | Описание |
|---|---|---|
InvoiceID | guid | Уникальный ID инвойса — сохранить! |
MerchantOrderID | string(38) | ID заказа |
InvoiceStatus | enum | Created / Billing / Processed / Cancelled / Refund |
PaymentStatus | enum | PAID / NOT_PAID / PARTLY_PAID |
AuthorizationType | enum | SMS_PIN / BY_CONTRACT / SKIP / AUTH_PAGE — см. справочник |
IsAuthorized | bool | Прошёл ли авторизацию |
BillingChannel | enum | CPA / MT / MC / BankRtp и др. — см. справочник |
ContractID | guid | ID контракта (если применимо) |
JSON API v3
Ответ (JSON)
// 201 Created — полные примеры запроса в «Сценариях»
{
"success": true,
"data": {
"invoice_id": "1624505c-0031-00cf-7d54-4cf1ce08cb30",
"status": "Created",
"payment_status": "NOT_PAID",
"authorization": { "type": "BY_CONTRACT", "is_authorized": true },
"price": { "amount": "99.00", "currency": "RUB", "vat_included": true },
"merchant_order_id": "ORDER-001",
"billing_channel": "CPA"
}
}