Интеграция
Четыре шага до первого платежа
Это вся интеграция с платежной страницей. Остальное — подробности к этим четырем шагам.
Базовый адрес песочницы и боевого шлюза выдается вместе с ключами. В примерах ниже он обозначен как $MP_API_BASE.
- 01Получить ключи песочницы
Присылаете заявку, мы выдаем тестовые ключи, базовый адрес и спецификацию с именами полей и кодами ошибок. В песочнице деньги не списываются.
- 02Создать платеж
Один запрос. В ответе приходит идентификатор платежа и ссылка на платежную страницу.
curl -X POST "$MP_API_BASE/payments" \ -H "Authorization: Bearer $MP_KEY" \ -H "Content-Type: application/json" \ -d '{ "amount": "40.00", "currency": "GEL", "orderId": "shop-4412", "description": "1 Day Membership, Coffee", "callbackUrl": "https://shop.example/payments/callback", "returnUrl": "https://shop.example/orders/4412" }' - 03Отправить клиента на страницу
Редирект по ссылке из ответа. Клиент платит и возвращается на ваш returnUrl. Возврат браузера не является доказательством оплаты, он означает только то, что браузер вернулся.
{ "id": "pay_8f2b41c7", "status": "created", "paymentUrl": "https://pay.multiprime.ge/i/8f2b41c7" } - 04Принять колбэк и подтвердить статус
Статус приходит на ваш callbackUrl. Проверьте подпись, затем прочитайте платеж еще раз и только после этого отдавайте товар. Колбэк может прийти дважды, поэтому обработчик обязан быть идемпотентным.
curl "$MP_API_BASE/payments/pay_8f2b41c7" \ -H "Authorization: Bearer $MP_KEY"