Магазин тема 12 из 27

Оплата

Оплата оформленного заказа. Методы — в группе /api/sale, оба только для вошедших и только по своему заказу. Оформление заказа — тема Заказ.

в этой теме 6
  1. Методы оплаты
  2. Оплата на витрине по шагам
  3. Ошибки оплаты
  4. Где настраивается оплата
  5. Ограничения оплаты
  6. Что почитать после оплаты

Методы оплаты

МетодАдресКто вызываетНачинает сессию
Ссылка и форма оплаты заказаPOST /api/sale/order/paymentвошедшийнет
Сменить способ оплаты заказаPOST /api/sale/order/changePaymentвошедшийнет

Гость получает 401: {"success": false, "error": "Требуется авторизация"}.

Оплата на витрине по шагам

  1. Сразу после оформления: ответ POST /api/sale/order/save уже содержит payment (HTML формы оплаты) и paymentUrl (ссылка). Витрина перенаправляет покупателя на paymentUrl или вставляет форму.
  2. Позже, кнопка «Оплатить» у неоплаченного заказа в личном кабинете: POST /api/sale/order/payment с order_id.
  3. Покупатель хочет другой способ: paysystems из ответа шага 2 — выбор; POST /api/sale/order/changePayment с orderID и paymentID меняет платёжную систему; затем снова шаг 2 — новая форма и ссылка.

Получить данные оплаты

bash
curl -X POST "https://example.ru/api/sale/order/payment" \
  -H "X-Session-Id: JLfAjGOFZ3qb2elyU2VIxlhvt1kYjQMZ" \
  -H "Content-Type: application/json" \
  -d '{"order_id": 56}'
json
{
    "data": {
        "payment": "<a href=\"https://pay.example.ru/p/56\">Оплатить</a>",
        "paymentUrl": "https://pay.example.ru/p/56",
        "order": {
            "id": 56,
            "accountNumber": "56",
            "payed": "N",
            "canceled": "N",
            "statusId": "N",
            "price": 4300,
            "currency": "RUB",
            "paySystemId": 3
        },
        "paysystem": { "id": 3, "name": "Оплата картой" },
        "paysystems": [
            { "id": 3, "name": "Оплата картой", "description": "", "isCash": "N", "psaLogotipSrc": "/upload/sale/paysystem/logo/card.png" }
        ]
    }
}
  • payment — HTML формы оплаты платёжной системы; у оплаченного заказа — сообщение «Заказ оплачен».
  • paymentUrl — ссылка на оплату; null, если у платёжной системы её нет или заказ оплачен.
  • paysystem — платёжная система первого неоплаченного платежа.
  • paysystems — способы оплаты на выбор (id, name, description, isCash — "Y" или "N", psaLogotipSrc), без внутреннего счёта; пустой массив, если у заказа нет неоплаченного платежа не внутренним счётом.

Сменить способ оплаты

bash
curl -X POST "https://example.ru/api/sale/order/changePayment" \
  -H "X-Session-Id: JLfAjGOFZ3qb2elyU2VIxlhvt1kYjQMZ" \
  -H "Content-Type: application/json" \
  -d '{"orderID": 56, "paymentID": 3}'

Ответ при успехе — {"errors": null}. Метод меняет платёжную систему во всех неоплаченных платежах заказа. paymentID — id из paysystems.

Ошибки оплаты

Ошибки приходят телом {"errors": [текст]}:

СтатусКогда
404заказа с таким ID нет или он принадлежит другому пользователю
400changePayment: заказ уже оплачен
404changePayment: платёжной системы нет, она не активна или это внутренний счёт (бонусы не являются способом оплаты на выбор)

Где настраивается оплата

Платёжные системы, их ограничения и логотипы — штатные настройки магазина Битрикса (модуль sale); обработчики платёжных систем — код Битрикса или стороннего модуля. Настройки модуля BIK.REST-API оплату не меняют. Состав товаров заказа — набор «Корзина и заказ» (Состав ответа).

Ограничения оплаты

  • Модуль не пишет в сессию при оплате, но обработчики платёжных систем — сторонний код и могут писать в $_SESSION сами.
  • Ошибки приходят в форме {errors: [текст]}; у остальных методов группы встречается и {success: false, error: текст}.

Что почитать после оплаты

Подключим BIK.REST-API к вашему сайту

Оставьте заявку — установим и настроим модуль, ответим на вопросы по API.

c заботой о вас, мы используем cookie на своем сайте, чтобы интернет был чистым и прекрасным