Интеграция

Четыре шага до первого платежа

Это вся интеграция с платежной страницей. Остальное — подробности к этим четырем шагам.

Базовый адрес песочницы и боевого шлюза выдается вместе с ключами. В примерах ниже он обозначен как $MP_API_BASE.

  1. 01
    Получить ключи песочницы

    Присылаете заявку, мы выдаем тестовые ключи, базовый адрес и спецификацию с именами полей и кодами ошибок. В песочнице деньги не списываются.

  2. 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"
      }'
  3. 03
    Отправить клиента на страницу

    Редирект по ссылке из ответа. Клиент платит и возвращается на ваш returnUrl. Возврат браузера не является доказательством оплаты, он означает только то, что браузер вернулся.

    {
      "id": "pay_8f2b41c7",
      "status": "created",
      "paymentUrl": "https://pay.multiprime.ge/i/8f2b41c7"
    }
  4. 04
    Принять колбэк и подтвердить статус

    Статус приходит на ваш callbackUrl. Проверьте подпись, затем прочитайте платеж еще раз и только после этого отдавайте товар. Колбэк может прийти дважды, поэтому обработчик обязан быть идемпотентным.

    curl "$MP_API_BASE/payments/pay_8f2b41c7" \
      -H "Authorization: Bearer $MP_KEY"

Запросить ключи песочницы

Запросить ключи песочницы