Создание инвойса

POST

/payment/invoice

Метод создает инвойс и возвращает ссылку на его оплату (в поле checkout_url). Система мерчанта должна перенаправить клиента на указанный URL.

В случае, если система Партнера формирует QR-код для оплаты, то можно использовать короткую ссылку из поля short_link (возвращается только в продакшн-среде).

Система партнера должна сохранить идентификатор транзакции из поля uuid.

Если передано поле callback_url, при успешной оплате в систему Партнера будет отправлен коллбэк-запрос.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢200Создание инвойса

application/json

Body

🟠400Ошибочная валидация

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/payment/invoice' \
--header 'X-Access-Token: {{multicard_token}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "store_id": 6,
    "amount": 500000,
    "invoice_id": "123",
    "lang": "ru",
    "return_url": "https://..",
    "callback_url": "https://..",
    "ofd": [
        {
            "qty": 1,
            "price": 2500000,
            "mxik": "06401004002000000",
            "total": 25000000,
            "package_code": "1506113",
            "name": "кроссовки men'\''s low shoes"
        },
        {
            "qty": 1,
            "price": 2500000,
            "mxik": "06401002004000000",
            "total": 2500000,
            "package_code": "1519041",
            "name": "кроссовки t.ace 2332 white black"
        }
    ]
}'

Response Example

200 - Создание инвойса

{
    "success": true,
    "data": {
        "store_id": 6,
        "amount": 100000,
        "invoice_id": "123",
        "return_url": "https://..",
        "callback_url": "https://..",
        "ofd": [
            {
                "qty": 1,
                "price": 60000000,
                "mxik": "06401004002000000",
                "total": 60000000,
                "package_code": "1506113",
                "name": "кроссовки men's low shoes"
            },
            {
                "qty": 1,
                "price": 55700000,
                "mxik": "06401002004000000",
                "total": 55700000,
                "package_code": "1519041",
                "name": "кроссовки t.ace 2332 white black"
            }
        ],
        "uuid": "f6339f31-6a09-11f0-9a1b-00505680eaf6",
        "products": null,
        "split": null,
        "return_error_url": null,
        "short_link": "https://l.multicard.uz/1m1e12",
        "sms": null,
        "added_on": "2025-07-26 15:19:06",
        "updated_on": "2025-07-26 15:19:06",
        "payment": "{PaymentModel}",
        "checkout_url": "https://app.rhmt.uz/invoice/f6339f31-6a09-11f0-9a1b-00505680eaf6",
        "deeplink": "https://multicard.app/payments/checkout/6?params=%7B%22fixed_amount%22%3A100000%2C%22details%22%3A%7B%22invoice_id%22%3A%22123%22%2C%22invoice_uuid%22%3A%22f6339f31-6a09-11f0-9a1b-00505680eaf6%22%7D%7D"
    }
}

Modified at 2025-10-30 11:36:10

Оплата на платежной странице Multicard

Получение информации о созданном инвойсе