Документация для API-интерфейса создания счетов в системе электронных платежей ePay:

Получения токена:

URL test https://testoauth.homebank.kz/epay2
URL prod https://epay-oauth.homebank.kz

Request

Body: form-data

    grant_type:        "password"
    username:          "USERNAME"
    password:          "USERPASSWORD"
    scope:             "api"
    client_id:         "CLIENTID"
    client_secret:     "CLIENTSECRET"

Responce

{
    "access_token":"f2288c2b-1d08-4aac-a210-d62c0901f915",
    "token_type":"bearer",
    "refresh_token":"3f94522d-5a5a-4a22-bc85-f5f5a56920b4",
    "expires_in":43199
}

URL prod https://epay-api.homebank.kz/invoice
URL test https://testepay.homebank.kz/api/invoice

данные для тестирования:

shop_id prod: e16cfde-f3e9-49c6-8cf9-2d3f080f739c
shop_id test: 2e975b11-a904-4b11-af5b-ccd834df47ef

Метод: POST

Входные параметры:


{
    "shop_id": "4e16cfde-f3e9-49c6-8cf9-2d3f080f739c",
    "account_id": "0003413423",
    "invoice_id": "25458124232312321",
    "amount": 100,
    "language": "rus",
    "description": "asdasdasdas",
    "expire_period": "2d",
    "recipient_contact": "armanali@halykbank.kz",
    "recipient_contact_sms": "+777711233662",
    "notifier_contact_sms": "",
    "currency": "KZT",
    "postLink": "",
    "failurePostLink": ""
}

shop_id (строка) - ID магазина, выдается системой при регистрации магазина, обязательное account_id (строка) - номер счета магазина в системе epay, генериурется коммерсантом, обязательное invoice_id (строка) - уникальный идентификатор номера в системе магазина, генериурется коммерсантом, обазательное amount (число) - сумма счета, обязательное language (строка) - язык, на котором должна быть представлена информация о счете (допустимые значения: "rus", "kaz", "eng"), обязательное description (строка) - описание счета, допустимое количество символов 125, обязательное expire_period (строка) - период действия счета. Формат: "[число][единица времени]", где единица времени может принимать значение "d" (дни), "h" (часы), "m" (минуты). Например, "2d" - счет действителен в течение двух дней, обязательное recipient_contact (строка) - электронный адрес получателя счета, обязательное recipient_contact_sms (строка) - номер мобильного телефона получателя счета в формате "+7XXXXXXXXXX", обязательное notifier_contact_sms (строка, необязательный к заполнению) - номер мобильного телефона для отправки уведомлений об оплате в формате "+7XXXXXXXXXX". currency (строка) - валюта счета (допустимые значения: "KZT"), обязательное postLink (строка, необязательный) - URL-адрес, на который будет отправлен POST-запрос после успешной оплаты счета. failurePostLink (строка, необязательный) - URL-адрес, на который будет отправлен POST-запрос в случае неуспешной оплаты счета.

Ответ ситемы:

{
    "id": "afc1ce64-da89-41f7-afbf-2748ddaf3501",
    "shop_id": "4e16cfde-f3e9-49c6-8cf9-2d3f080f739c",
    "amount": 100,
    "invoice_id": "25458124232312321",
    "language": "rus",
    "currency": "KZT",
    "description": "asdasdasdas",
    "account_id": "0003413423",
    "recipient_contact": "armanali@halykbank.kz",
    "recipient_contact_sms": "+777711233662",
    "notifier_contact": "",
    "notifier_contact_sms": "+777711233662",
    "expire_period": "2d",
    "post_link": "",
    "failure_post_link": "",
    "created_date": "2023-03-28T10:04:10.997074088+06:00",
    "expire_date": "2023-03-30T10:04:10.997074088+06:00",
    "status": "ACTIVE",
    "updated_date": "0001-01-01T00:00:00Z",
    "invoice_url": "https://epay-api.homebank.kz/redirect/invoice-link/afc1ce64-da89-41f7-afbf-2748ddaf3501",
    "merchant_id": "65b0d0b8-9a95-45fc-ad58-725e45b093a0",
    "terminal_id": "0d4d345e-8566-43bd-b046-028b5aee6406"
}

id (строка) - уникальный идентификатор счета в системе ePay. shop_id (строка) - идентификатор магазина, зарегистрированного в системе ePay. amount (число) - сумма счета. invoice_id (строка) - уникальный идентификатор счета в системе магазина. language (строка) - язык, на котором представлена информация о счете. currency (строка) - валюта счета. description (строка) - описание счета. account_id (строка) - идентификатор счета магазина. recipient_contact (строка) - электронный адрес получателя счета. recipient_contact_sms (строка) - номер мобильного телефона