Методы оплаты
| Метод | Адрес | Кто вызывает | Начинает сессию |
|---|---|---|---|
| Ссылка и форма оплаты заказа | POST /api/sale/order/payment | вошедший | нет |
| Сменить способ оплаты заказа | POST /api/sale/order/changePayment | вошедший | нет |
Гость получает 401: {"success": false, "error": "Требуется авторизация"}.
Оплата на витрине по шагам
- Сразу после оформления: ответ
POST /api/sale/order/saveуже содержитpayment(HTML формы оплаты) иpaymentUrl(ссылка). Витрина перенаправляет покупателя наpaymentUrlили вставляет форму. - Позже, кнопка «Оплатить» у неоплаченного заказа в личном кабинете:
POST /api/sale/order/paymentсorder_id. - Покупатель хочет другой способ:
paysystemsиз ответа шага 2 — выбор;POST /api/sale/order/changePaymentсorderIDиpaymentIDменяет платёжную систему; затем снова шаг 2 — новая форма и ссылка.
Получить данные оплаты
curl -X POST "https://example.ru/api/sale/order/payment" \
-H "X-Session-Id: JLfAjGOFZ3qb2elyU2VIxlhvt1kYjQMZ" \
-H "Content-Type: application/json" \
-d '{"order_id": 56}' {
"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), без внутреннего счёта; пустой массив, если у заказа нет неоплаченного платежа не внутренним счётом.
Сменить способ оплаты
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 нет или он принадлежит другому пользователю |
| 400 | changePayment: заказ уже оплачен |
| 404 | changePayment: платёжной системы нет, она не активна или это внутренний счёт (бонусы не являются способом оплаты на выбор) |
Где настраивается оплата
Платёжные системы, их ограничения и логотипы — штатные настройки магазина Битрикса (модуль sale); обработчики платёжных систем — код Битрикса или стороннего модуля. Настройки модуля BIK.REST-API оплату не меняют. Состав товаров заказа — набор «Корзина и заказ» (Состав ответа).
Ограничения оплаты
- Модуль не пишет в сессию при оплате, но обработчики платёжных систем — сторонний код и могут писать в
$_SESSIONсами. - Ошибки приходят в форме
{errors: [текст]}; у остальных методов группы встречается и{success: false, error: текст}.
Что почитать после оплаты
- Заказ: оформление, история, отмена
- Профили покупателя: внутренний счёт и история операций
- Сессия и авторизация