Skip to Content
docs
B2B-платёжСоздать платёж

Создать платёж

Инициируйте B2B банковский перевод на IBAN получателя.

POST
***

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

NameTypeDescription
public_keyRequired
StringПубличный ключ мерчанта.
order_idRequired
StringУникальный идентификатор заказа, сгенерированный мерчантом. Возвращается в ответе и используется для отслеживания статуса.
amountRequired
NumberСумма перевода. Мин: `0.01`, Макс: `40000`.
descriptionRequired
StringОписание платежа. Макс 255 символов.
ibanRequired
StringIBAN получателя. Должен начинаться с `AZ`. Пример: `AZ29ABCD38053AZN00A7100186514`.
nameRequired
StringИмя получателя. Макс 255 символов.
tinRequired
StringИНН получателя. 10 цифр, последняя `1` (физлицо) или `2` (юрлицо). Пример: `1234567891`.
bank_codeRequired
StringКод банка получателя. Пример: `505141`.
bank_nameOptional
StringНазвание банка получателя.
emailOptional
StringEmail получателя.
addressOptional
StringАдрес получателя.
additional_infoOptional
StringДополнительная информация.
bulk_descriptionOptional
StringОписание bulk-платежа.
webhook_urlOptional
StringURL для уведомления при финальном статусе.

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

Отправить запрос
Payload
{
  "public_key": "YOUR_PUBLIC_KEY",
  "order_id": "order-20240430-001",
  "amount": "1000.00",
  "description": "Авансовый платёж",
  "iban": "AZ29ABCD000000000000000000000",
  "name": "Технологии ООО",
  "tin": "1234567891",
  "bank_code": "505141",
  "bank_name": "Example Bank",
  "webhook_url": "https://yoursite.ru/webhooks/epoint-b2b-payment"
}
1DATA=$(echo -n '{"public_key":"YOUR_PUBLIC_KEY","order_id":"order-20240430-001","amount":"1000.00","description":"Авансовый платёж","iban":"AZ29ABCD000000000000000000000","name":"Технологии ООО","tin":"1234567891","bank_code":"505141"}' | base64)
2SIGNATURE=$(echo -n "$PRIVATE_KEY$DATA$PRIVATE_KEY" | openssl dgst -sha1 -binary | base64)
3

4curl -X POST *** \
5-H "Content-Type: application/json" \
6-d "{\"data\":\"$DATA\",\"signature\":\"$SIGNATURE\"}"

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

NameTypeDescription
statusRequired
StringРезультат операции: `success` или `error`.
order_idOptional
StringИдентификатор заказа, предоставленный мерчантом — возвращается из запроса без изменений.
bulkIdOptional
StringИдентификатор bulk-операции Bank.
Response
1{
2  "status": "success",
3  "order_id": "order-20240430-001",
4  "bulkId": "11523"
5}

Коды ошибок

HTTP-кодПричина
422Ошибка валидации или некорректные данные data
403Мерчант не найден или не активен
500Несоответствие подписи или внутренняя ошибка

Webhook-уведомление

При достижении финального статуса (SUCCESS или FAILED) на webhook_url отправляется POST-запрос.

{
  "order_id":      "order-20240430-001",
  "status":        "success",
  "amount":        "1000.00",
  "payee_iban":    "AZ29ABCD000000000000000000000",
  "payee_name":    "Технологии ООО",
  "error_message": null
}
statusЗначение
successBANK_SUCCESS — платёж выполнен
failedЛюбой финальный статус ошибки

Ваш webhook-endpoint должен возвращать 200 OK. При неудаче повторные попытки выполняются 4 раза с экспоненциальной задержкой (60с → 120с → 180с → 240с).

ОбзорСтатус платежа