Skip to Content
docs
ПредавторизацияЗапрос предавторизации

Запрос предавторизации

Создание предавторизации на карте клиента. Сумма резервируется, но не списывается до завершения предавторизации.

POST
***

Параметры запроса

NameTypeDescription
public_keyRequired
StringИдентификатор мерчанта. Пример: `i000000001`
amountRequired
NumberСумма платежа. Пример: `100`, `20.50`
currencyRequired
StringВалюта платежа. Значения: `AZN`
languageRequired
StringЯзык отображения страницы. Значения: `az`, `en`, `ru`
order_idRequired
StringУникальный идентификатор заказа. Максимум 255 символов.
descriptionOptional
StringОписание. Максимум 1000 символов.
success_redirect_urlOptional
StringURL перенаправления при успехе.
error_redirect_urlOptional
StringURL перенаправления при неудаче.
other_attrOptional
ArrayДополнительные параметры.

Пример запроса

Отправка запроса
Payload
{
  "public_key": "i000000001",
  "amount": 100,
  "currency": "AZN",
  "language": "az",
  "order_id": "order-123"
}
1DATA=$(echo -n '{"public_key":"i000000001","amount":100,"currency":"AZN","language":"az","order_id":"order-123"}' | base64)
2SIGNATURE=$(echo -n "$PRIVATE_KEY$DATA$PRIVATE_KEY" | openssl dgst -sha1 -binary | base64)
3

4curl -X POST *** \
5-H "Content-Type: application/x-www-form-urlencoded" \
6-d "data=$DATA&signature=$SIGNATURE"

Параметры ответа

NameTypeDescription
statusRequired
StringРезультат операции: `success` или `error`
redirect_urlOptional
StringURL для перенаправления клиента на страницу оплаты банка. Присутствует при успехе.
transactionOptional
StringИдентификатор транзакции Epoint. Присутствует при успехе.
messageOptional
StringОписание ошибки. Присутствует при неудаче.
trace_idRequired
StringУникальный идентификатор запроса для отладки. Предоставьте его в службу поддержки Epoint для расследования проблемы.

Успех

Success Response
1{
2  "status": "success",
3  "redirect_url": "https://bank.gateway.url/...",
4  "transaction": "te_0000000001",
5  "trace_id": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
6}

Примечание: После обработки платежа и подтверждения блокировки банком необходимо завершить предавторизацию с помощью эндпоинта Завершение предавторизации. До завершения сумма будет отображаться как ожидающая в бизнес-панели.

ОбзорЗавершение предавторизации