Главная / Документация / API / Платежи/ Создание платежа

Создание платежа

Чтобы принять оплату, необходимо создать Payment. Он содержит всю необходимую информацию для проведения оплаты (сумму, валюту и статус). У платежа линейный жизненный цикл, он последовательно переходит

Создание платежа

POST https://api.monopay.ru/v1/payments

Headers

Name Type Description
Authorization* String Bearer токен Секретный ключ проекта
Content-Type* String application/json
Accept* String application/json

Request Body

Name Type Description
shop_id* Number ID проекта
amount* Float Сумма платежа
currency* String Код валюты в формате ISO-4217
description* String Описание транзакции (не более 128 символов), которое вы увидите в личном кабинете, а пользователь — при оплате. Например: «Оплата заказа № 72 для user@monopay.ru».
shop_customer_id* String Идентификатор покупателя в вашей системе. Не более 200 символов
signature* String Цифровая подпись запроса. Генерация цифровой подписи
payment_method String Данные для оплаты конкретным способом (payment_method). Вы можете не передавать этот объект в запросе. В этом случае пользователь будет выбирать способ оплаты на стороне MonoPay. Способы оплаты
shop_order_id* String Идентификатор платежа в вашей системе
email String Email пользователя, если пустое, то пользователь должен будет заполнить на платёжной форме
phone String Телефон пользователя, если пустое, то пользователю будет предложено заполнить на платёжной форме. Формат: 79001008020
pay_type Number

Тип оплаты: 1 - одностадийная, 2 - двухстадийная. По-умолчанию: 1 - одностадийная

expired_at DateTime Время просрочки платежа, если не указывать то будет просрочен через час после создания платежа

200: OK Платёж создан

{
    "id": "6083758c-4894-4829-8093-8f2693d4a6cf",
    "status": "pending",
    "paid": false,
    "amount": {
        "value": "3",
        "currency": "RUB"
    },
    "description": "Test description",
    "created_at": "2022-04-23T08:20:07.000000Z",
    "expired_at": "2022-04-23T10:20:07.000000Z",
    "confirmation": {
        "type": "redirect",
        "confirmation_url": "https://monopay.ru/payments/external/confirmation?payment_id=6083758c-4894-4829-8093-8f2693d4a6cf"
    }
}