Платежный шлюз Multicard
  1. Оплата на платежной странице Multicard
Платежный шлюз Multicard
  • Introduction
  • Авторизация
    • Получение токена
      POST
  • Оплата на платежной странице Multicard
    • Создание инвойса
      POST
    • Получение информации о созданном инвойсе
      GET
    • Удаление (аннулирование) инвойса
      DELETE
    • Быстрая оплата (PaymeGo, ClickPass и др.)
      PUT
    • Callback (success)
      POST
    • Callback (webhooks)
      POST
  • Привязка карт (форма)
    • Получение ссылки на страницу привязки карты
      POST
    • Callback-запрос
      POST
    • Проверка состояния привязки карты
      GET
    • Получение информации о карте по токену
      GET
    • Проверка принадлежности карты к ПИНФЛ
      POST
    • Аннулирование токена карты
      DELETE
  • Привязка карт (API)
    • Добавление карты с помощью карточных данных
      POST
    • Подтверждение привязки
      PUT
    • Проверка карты по ее номеру
      GET
  • Оплата на странице Партнера
    • Создание платежа по токену карты
      POST
    • Создание платежа с передачей карточных данных
      POST
    • Создание расщепленного платежа
      POST
    • Создание платежа payme/click/uzum и прочие
      POST
    • Подтверждение платежа
      PUT
    • Отправка фискальной ссылки
      PATCH
    • Отмена платежа (возврат средств)
      DELETE
    • Частичный возврат
      DELETE
    • Получение информации о платеже
      GET
  • Холдирование
    • Создать заявку на холдирование
    • Подтвердить холдирование (блокировка средств на карте)
    • Списать захолдированные средства
    • Получение информации о холдировании
    • Отмена захолдированных средств (до списания)
  • Выплаты на карту (payouts)
    • Создание платежа на выплату c передачей номера карты
    • Подтвердить выплату
    • Получение информации о выплате
  • Дополнительные методы
    • Информация о приложении
    • Реквизиты получателя
    • Реестр проведенных платежей
    • История проведенных выплат на карты (пополнений)
  • Schemas
    • ITEMS
    • applicationModel
    • paymentModel
    • cardModel
    • splitRequest
    • ofdRequest
    • PaymentStatusEnum
    • PaymentServiceEnum
    • storeModel
    • merchantModel
    • billingFieldsModel
    • merchantAccount
    • taxReceiptModel
    • clearingModel
  1. Оплата на платежной странице Multicard

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

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 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 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
Previous
Оплата на платежной странице Multicard
Next
Получение информации о созданном инвойсе
Built with