MultiИнтеграция
Четыре операции
Платежная интеграция меньше, чем кажется. Этих четырех операций хватает, все остальное — детали одной из них.
Операции
| POST /payments | Создать платеж и получить ссылку на платежную страницу |
| GET /payments/{id} | Прочитать платеж: статус, сумма, метод, метки времени |
| POST /payments/{id}/refund | Возврат, полный или частичный |
| POST ваш callbackUrl | Мы сообщаем о смене статуса, запрос подписан |
Базовый адрес песочницы и боевого шлюза выдается вместе с ключами. В примерах ниже он обозначен как $MP_API_BASE.
Создание платежа
| amount | Строка, два знака после точки. С клиента спишется ровно эта сумма. |
|---|---|
| currency | GEL, USD или EUR, по договору |
| orderId | Ваш номер заказа. Уникален на вашей стороне, мы возвращаем его в каждом ответе. |
| description | То, что клиент видит на странице |
| callbackUrl | Куда мы отправим статус. HTTPS, доступен из интернета. |
| returnUrl | Куда клиент попадет после страницы |
Статусы
| created | Страница создана, никто еще не платил |
|---|---|
| pending | Платеж у банка, ответа пока нет |
| paid | Деньги списаны. Только теперь отдавайте товар. |
| failed | Отказ. Причина приходит вместе со статусом. |
| expired | Страница истекла, ничего не списано |
| refunded | Возвращено полностью или частично |
Два правила, которые экономят больше всего времени
- Возврат клиента на ваш returnUrl не является доказательством оплаты. Он означает только то, что браузер вернулся. Доказательство — статус, который вы прочитали у нас.
- Никогда не доверяйте сумме, пришедшей из браузера. Создавайте платеж на своем сервере из своего заказа.
Полная спецификация
Точные имена полей, все коды ошибок, схема подписи колбэка и тестовые карты выдаются вместе с доступом в песочницу, чтобы прочитанное всегда совпадало с тем, что реально отвечает шлюз.