payment/init
Запрос создания платежной сессии. При успешном запросе в ответе будет присуствовать payment_url - адрес платежной формы на который следует перенаправить пользователя для последующей оплаты.
После успешной оплаты или отказе от оплаты пользователь будет перенаправлен на адрес указанный продавцом в callback_url - в параметрах URL будут присутвовать payment_id
по которому продавец может получить расширенный статус платежной сессии при помощи метода State.
- Метод:
POST - Адрес ресурса:
/api/v1/payment/init
Параметры запроса
| Наменование | Тип | Обязательно | Описание |
|---|---|---|---|
| order_id | Строка | Да | Идентификатор заказа в системе продавца. Уникальное значение |
| amount | Число | Да | Сумма к списанию в минимальных единицах валют |
| customer_id | Строка | Нет | Идентификатор пользователя в системе продавца - используется для сохранения данных платежной карты и последующих платежей без участия пользователя |
| lang | Строка | Нет | Код языка в ISO 639-1 для локализации платежной формы |
| callback_url | Строка | Да | Адрес перенаправления. После осуществления платежа либо отказа от оплаты пользователь будет перенаправлен на этот адрес |
| description | Строка | Нет | Описание заказа |
| Строка | Нет | Email пользователя | |
| ip | Строка | Нет | IP-адрес пользователя |
Параметры ответа
| Наменование | Тип | Обязательно | Описание |
|---|---|---|---|
| status | Строка | Да | Статус запроса - success, error |
| payment_id | Строка | Да(при успешном запросе) | Идентификатор платежа в системе эквайринга |
| payment_url | Строка | Да(при успешном запросе) | Адрес платежной формы |
| error | Строка | Нет | Тип ошибки |
| errors | Строка[] | Нет | Описание ошибки(ошибок) |
Пример запроса и ответа
Запрос
curl \
-H "Authorization: Bearer hEjM719pNaX6Xp-rF_bCoT564vKQH7GzGL2CZ1iv9mI" \
-H "Signature: 6vWcMfbZEk54Ql2D3fKV1R0SRepUPgwMacFPwfz2H7MEK+h...M9dFWPXkLu4hHb4c64KsyTBp82L2Pm9ggHTjf+A==" \
-H "Content-Type: application/json" \
-d '{ "order_id": "1", "amount": 100, "lang": "ru", "callback_url": "http://localhost:3000/callback", "description": "оплата заказа", "email": "example@gmail.com", "ip": "68.41.96.112" }' \
-X POST https://pay.primorsky.online/api/v1/payment/init
Ответ
{
"status": "success",
"payment_id": "1",
"payment_url": "https://3dsec.sberbank.ru/payment/merchants/sbersafe_sberid/payment_ru.html?mdOrder=0f5b32e5-7c21-70ec-aed8-d292284861b8"
}
Ответ(ошибка)
{
"status": "error",
"error": "VALIDATION_ERROR",
"error_messages": ["order_id уже существует"]
}