Подать заявку

С вами кто-то свяжется в ближайшее время

Оставьте заявку на подключение

Ваша заявка принята в обработку. Вам ответят на электронную почту в рабочем порядке.

Спасибо за обращение

Создать сайт

Соберите сайт из готовых блоков, используйте готовые дизайн - шаблоны

Создайте сайт на <a>Tilda</a>

Видеоинструкция

Мы провели интеграцию.Теперь вы можете подключить наш модуль в пару кликов

Подключите модуль EPAY

<span>Быстрый старт</span> вашего интернет - магазина, без навыков программирования

Мы подготовили для вас подробную инструкцию

Подробнее

Возможность самостоятельно в кратчайшие сроки подключить интернет - магазин

# Oauth

> > URL https://testoauth.homebank.kz/epay2

[Receive token](https://epayment.kz/ru/docs/poluchenie-tokena)  
[Update token](https://epayment.kz/ru/docs/obnovlenie-tokena)  
[Cancel token](https://epayment.kz/ru/docs/otzyv-tokena)

# API

> > URL https://epay-api.homebank.kz

- [Cancel payment](https://developer.homebank.kz/epay/api/cancel)
- [Confirm/Partially confirm payment](https://developer.homebank.kz/epay/api/podtverzhdenie-chastichnoe-podtverzhdenie-operacii)
- [Return/ Partially return payment](https://developer.homebank.kz/epay/api/vozvrat-chastichnyi-vozvrat)


P2P API

P2P BY API

> URL: POST /operation/:id/refund  
> Should you want to partially refund the transaction, optional ```amount``` field must be provided

ssss

```
Headers
    Authorization: Bearer dGVzdGNsaWVudDpzZWNyZXQ=
```

```
Responce

Http status 200
```

### Error

```
Http status 400
{
    "code": 100,
    "message": ""
}
```

Refund/partial refund

Refund/Partial refund

> URL POST /oauth2/token

```

Request

Request Header
    device_id:         "69f3db46-8092-4094-8910-bb6e3d6ba969"
    ip:                "10.3.23.42"
    fingerprint:       "asdasdfr90a7889a7sdasd9"

Request Body:
    grant_type:        "refresh_token"
    scope:             "api"
    client_id:         "CLIENTID"
    client_secret:     "CLIENTSECRET"
    refresh_token:     "OYKAYN6HXLUOG520FDPJCW"
Response

{
    "access_token": "T0KO0PKDPG6WSUZNQMZR6W",
    "expires_in": 7200,
    "scope": "api",
    "token_type": "Bearer"
}
```

Refreshing token

> URL /operation

TEST URL https://testepay.homebank.kz/api/operations

PROD URL https://epay-api.homebank.kz/operations

[Authorization](https://epayment.kz/ru/docs/poluchenie-tokena) is required

Incoming parameters are sent in a form of JSON:
The model is as followed:

```
{
    "paging":{
            "page": "",
            "size": ""
            },
    "searchParameters":[
    {
            "name":"",
            "method":"",
            "searchParameter":["","",...]
    }
    ],
    "orderParameters":[
    {
        "field":"",
        "typeOrder":"ASC/DESC"
    }
    ]
}

```

"Paging" takes 2 parameters:
"page" controls the number of entries that must be skipped;
"size" controls the number of entries that are received.

"searchParameters" takes 3 parameters. It is also possible to perform a search by multiple fields (example shows how it is done)
"name" is a filter parameter of a field that controls what is searched in a DB.
"method" controls how to search the DB (possible options: between, in, like, =, <, >, <=, >=);
"searchParameter" controls search parameters. When used in conjunction with "between" must specify 2 parameters. When used with "like" must use one parameter that contains %. When used with "in" must specify at least 1 parameter.
In an event of wrong parameters, an error is returned.
You must specify a transaction period in a request (it is required).

"orderParameters" can take 2 parameters.
"Field" name of the field that is used for sorting.
"typeOrder" controls order ASC/DESC.
This field can be left blank if there is no need for sorting.

Фильтры:

| Description            | Name                |
| ---------------------- | ------------------- |
| Transaction Date       | created_date        |
| Store                  | shop_id             |
| Order number           | invoice_id          |
| Client Id in the store | account_id          |
| Phone                  | payer_phone         |
| Email                  | payer_email         |
| РРН                    | reference           |
| PostLink               | post_link(bool)     |
| Amount                 | amount              |
| Card                   | card_mask           |
| Payer                  | client              |
| Installments           | installment_id      |
| Transaction type       | transaction_type_id |
| Refund Date           | payout_date         |
| Refund Amount         | payout_amount       |

Request example, JSON:

```
{
    "paging":{
            "page": 1,
            "size": 2
            },
    "searchParameters":[
    {
            "name":"created_date",
            "method":"between",
            "searchParameter":["2017-11-19T00:00:00Z", "2018-11-20T00:00:00Z"]
    },
    {
            "name":"description",
            "method":"in",
            "searchParameter":["description"]
    },
    {
            "name":"payer_email",
            "method":"like",
            "searchParameter":["danatugumbayeva%"]
    }
    ],
    "orderParameters":[
    {
        "field":"payer_email",
        "typeOrder":"ASC"
    },
    {
        "field":"description",
        "typeOrder":"DESC"
    }
    ]
}
```

Response in a form of JSON:

```
{
    "totalCount": 8,
    "records": [
        {
            "id": "b9d46313-264e-41ec-814c-728dd51eb97f",
            "amount": 1000,
            "currencyID": "8d565e73-1f67-4169-99d9-6cbfc12c2e55",
            "amountBonus": 80,
            "invoiceId": "",
            "accountId": "",
            "payerIp": "10.6.50.57",
            "payerName": "Dana Tugumbayeva",
            "payerPhone": "77029085001",
            "payerEmail": "danatugumbayeva@gmail.com",
            "description": "description",
            "data": "",
            "createdDate": "2018-10-27T15:08:14+06:00",
            "authDate": "2018-10-27T15:08:14+06:00",
            "confirmDate": "2018-10-27T15:08:14+06:00",
            "payoutDate": "2018-12-29T00:01:01.374084+06:00",
            "payoutAmount": 1000,
            "ipCountry": "",
            "ipCity": "",
            "ipRegion": "",
            "ipDistrict": "",
            "ipLatitude": 0,
            "ipLongitude": 0,
            "cardNumber": "4003....9282",
            "cardExpDate": "05.22",
            "cardCVC": "000",
            "cardType": {
                "ID": "",
                "Name": ""
            },
            "cardTypeID": "ec1e3a6a-5687-4c50-95aa-80723d9b940c",
            "issuer": "",
            "issuerBankCountry": "",
            "statusID": "22eb5a3e-0737-455c-ab42-ea98f80f7963",
            "reference": "730681443792",
            "client": "test",
            "template": "",
            "language": "RUS",
            "transactionTypeID": "4303bed9-243c-48d8-94de-8102f53e2803",
            "backLink": "",
            "failureLink": "",
            "postLink": "false",
            "postLinkStatus": false,
            "merchantID": "a5bc9d98-38ea-4b9c-ba7f-65a4add02ed6",
            "shopID": "a5bc9d98-38ea-4b9c-ba7f-65a4add02ed6",
            "secure3D": false,
            "cardID": "000000",
            "cardHash": "",
            "cardMask": "4003...9282",
            "installmentID": "c44602ca-357d-4dbb-8c94-3c36f48defd8",
            "terminal": "",
            "initReference": ""
        },
        {
            "id": "ac63c3b5-b369-42de-9ed3-d503a0840ee6",
            "amount": 100,
            "currencyID": "8d565e73-1f67-4169-99d9-6cbfc12c2e55",
            "amountBonus": 99,
            "invoiceId": "",
            "accountId": "",
            "payerIp": "10.6.50.57",
            "payerName": "Dana Tugumbayeva",
            "payerPhone": "77029085001",
            "payerEmail": "danatugumbayeva@gmail.com",
            "description": "description",
            "data": "",
            "createdDate": "2018-10-01T15:08:14+06:00",
            "authDate": "2018-10-01T15:08:14+06:00",
            "confirmDate": "2018-10-01T15:08:14+06:00",
            "payoutDate": "2018-12-28T21:57:18.314319+06:00",
            "payoutAmount": 100,
            "ipCountry": "",
            "ipCity": "",
            "ipRegion": "",
            "ipDistrict": "",
            "ipLatitude": 0,
            "ipLongitude": 0,
            "cardNumber": "4003....9282",
            "cardExpDate": "05.22",
            "cardCVC": "000",
            "cardType": {
                "ID": "",
                "Name": ""
            },
            "cardTypeID": "ec1e3a6a-5687-4c50-95aa-80723d9b940c",
            "issuer": "",
            "issuerBankCountry": "",
            "statusID": "22eb5a3e-0737-455c-ab42-ea98f80f7963",
            "reference": "",
            "client": "test",
            "template": "",
            "language": "RUS",
            "transactionTypeID": "4303bed9-243c-48d8-94de-8102f53e2803",
            "backLink": "",
            "failureLink": "",
            "postLink": "false",
            "postLinkStatus": false,
            "merchantID": "a5bc9d98-38ea-4b9c-ba7f-65a4add02ed6",
            "shopID": "a5bc9d98-38ea-4b9c-ba7f-65a4add02ed6",
            "secure3D": false,
            "cardID": "000000",
            "cardHash": "",
            "cardMask": "4003...9282",
            "installmentID": "c44602ca-357d-4dbb-8c94-3c36f48defd8",
            "terminal": "",
            "initReference": ""
        }
    ]
}
```

Response with an error in a form of JSON:

```
{
    "code": 232,
    "message": "Search Method Unavailable"
}
```


Operations

> URL DELETE /connect/token

```

Request

Headers
    Authorization: Bearer dGVzdGNsaWVudDpzZWNyZXQ=
Responce

HTTP CODE 200
```

Revoking token

# Cancellation

> URL: POST /operation/:id/cancel  
__Полная отмена__

URL TEST POST https://testepay.homebank.kz/api/operation/:id/cancel 
URL PROD POST https://epay-api.homebank.kz//operation/:id/cancel

__Частичная отмена__

TEST URL: POST  https://testepay.homebank.kz/api/operation/:id/cancel?amount=300
PROD URL: POST  https://epay-api.homebank.kz/operation/:id/cancel?amount=300

?amount=300 – параметр указывающий на значение суммы разблокировки

*Id указанный в URL это id транзакции который вы получаете после успешного заполнения клиентом платёжной формы, приходящий в postlink. Либо узнать id транзакции можно запросив статус.
Разблокировку средств на карте можно произвести только в том случае если транзакция находится в статусе Auth*

```
Headers
    Authorization: Bearer dGVzdGNsaWVudDpzZWNyZXQ=
```

```
Response

Http status 200
```

### Error
```
{
    "code": 100,
    "message": ""
}
```

Cancelling payment

/public.rsa

Incoming parameters on payment page

| Field Name      | Description                                                                           | Required |
| --------------- | ------------------------------------------------------------------------------------- | -------- |
| invoiceId       | Order id in store                                                                     | Yes      |
| backLink        | Link to redirect a customer back to the store after a successful transaction          | Yes      |
| failureBackLink | Link to redirect a customer back to the store after an unsuccessful transaction       | No       |
| postLink        | Link to send authorization status back to the store                                   | Yes      |
| failurePostLink | Link to send authorization status back to the store after an unsuccessful transaction | No       |
| language        | Server's language information is sent in this field "rus, kaz, eng"                   | No       |
| description     | Information about the goods or services that are being paid for                       | Yes      |
| accountId       | Personal client id in merchant's system                                               | No       |
| terminalId      | Terminal id for payments                                                              | Yes      |
| amount          | Transaction Amount                                                                    | Yes      |
| currency        | Transaction currency                                                                  | Yes      |
| cardSave        | Parameter to determine if the card needs to be saved. True for yes, False for no.     | Yes      |
| token           | Authorization Token                                                                   | Yes      |

Cryptogram structure is sent in a form of JSON.

```
{
	hpan       string
	expDate    string
	cvc        string
	terminalId string
}
```

> POST URL /payment/cryptopay

```
Request
{
	"amount":100,
	"currency":"KZT",
	"name":"ALEXANDR PARKHOMCHIK",
	"сryptogram": "UhYXAhYGeFA6srEVJ2V8Jtnnz6NzRwy8QDkCvEmJOcC6KyBP/Ce4SUM0A0My1zS1Iiur6AF0ajJwdi31EvrkRDBvzl2iLVKzvuAyusc5KuGpgxRhc6WXDhKkHV7J5Oew8uPMOfVbmXZ+Ypihos5ynSX7TnqQg1ImAmEISBxT+YU7jY68uxGhlehYMJ0lgS1Req4Z0BwCExBL2lwo05lmSMed69bEdBX552ue13zXjvTKIMrVj70hXIppXnxAE7haJfObuQzx2Ox+wM087kFPXfDX8Udlc6iRP2TxnRj7R1GnCTLvf3xlVU9ELzK+j91SPBQTvyEeyEvGMunjRch8lGXlogQreFSZmC5FUpfdfw6jYhl6lizUZYZzroN6/i5MILtV0US8zPFZTfozrCj8cvqw+J2W7yBywDiFoZG1teLDMIKIqTvkrmRL++Ji0psdHXl0z0ng/d0yTxzcBpPZ5V8VfNOexJJRZQUXBQqygAqqYninku/ls1NuTRMPeveyrgSMjQUVKU2W1izXdSreSdvaOio+1HJHNCZDwNn9yheTzbmuUsl5lhnsUGNT5gzMuYje8VfRYpsvG3Syz6nOijprG1wL3L/p5B/SZGrtaMMg/OdbD3mUWCSmat/V2v9RKHaeo5OHMnaVMTY5Tsqwa5JKBRP4ztRcjkjMRCBvS8c=",
	"invoiceId":"10101112",
	"description":"test",
	"accountId":"uuid000001",
	"email":"parkhomchik@gmail.com",
	"phone":"77472261170",
    "backLink": "https://testmerchant/order/1123",
    "failureBackLink": "https://testmerchant/order/1123/fail",
    "postLink": "https://testmerchant/order/1123",
    "failurePostLink":"https://testmerchant/order/1123/fail",
    "language": "rus",
    "cardSave": "false"
}
```

Non 3D

```
Response
Http code 200

Body
{
    "id": "7943816b-58a8-47f6-a11e-67b63c4228c7",
	"amount": 100,
	"currency": "KZT",
	"invoiceID": "938290483290",
	"accountID": "merchant_user",
	"phone": "77777777777",
	"email": "user@test.kz",
	"description":"",
	"reference":"894537489",
	"language":"rus"
}
```

3D

```
Response
Http code 200

Body
{
    "id": "7943816b-58a8-47f6-a11e-67b63c4228c7",
    "3D": {
        "PaReq": "eJxVUttu4jAQ/ZUo742DgULQ4CotpdByEwF6eQvOAFEggSRUtE+rfsh+A9pV1Uq7VX/B/aPaKfTyYOucmfHx8YzhaLOYa7cYJ34UVvWcYeoahjzy/HBa1YeD+kFZP2IwmMWINQf5OkYGbUwSd4qa71X1nt3HVeXqPK1PHHpCg1l+dHs84rlyszPVGWRpBrsLmNQ3KJA9lUoxn7lhysDlq+NmhxUKZvGwCGRHYYFxs8acRrd32rctWrQKZl4KfIQhdBfIGt32qSowLm6AZBHg0TpM4zuWt8pA9gTW8ZzN0nRZIQSX7p0RBGMjuAei4kC+rPTWCiVSZ+N7DEm/1LpqrobjktO6HNdaw/GNV+f2ZNCuAlEV4LkpMmrmLOmtpJlWpUArNAcki4O7UAZk3pTP+sCwVFfY3xLfAyC7HMsh7P3vGeBmGYWojgD5xOBhwpn4LV7FP7F9exBbTfzRxLN4kfjx7Zd4kfuDJv6Lrfgr15NKiUfpTp0D8vXak4YaA09lZ+3Lnj09871waEX3tU5wPUKPu5PuxJlTNZysSPnxZWNp3ixlhhQBomTIbu5k91Uk+vGF3gFtmOJF",
        "MD": "80348733-575C255E5C23BD5B",
        "TermURL": "http://10.0.20.25:10080/cgi-bin/cgi_link",
        "Action": "https://cardsecure.kkb.kz/CommerSafeACS/pa?id=XJtFfS2C2kh3VvBVc18INg"
    },
    "accountID": "uuid000001",
    "amount": 2,
    "currency": "KZT",
    "description": "Оплата в интернет магазине",
    "email": "parkhomchik@gmail.com",
    "invoiceID": "1553679706289",
    "language": "RU",
    "phone": "77472261170",
    "reference": ""
}
```

# Payment confirmation

URL POST /payments/cards/confirmPayment

```
Body
{
    "ID": "7943816b-58a8-47f6-a11e-67b63c4228c7",
    "PaRes": "/ZUo742DgULQ4CotpdByEwF6eQvOAFEggSRUtE+rfsh+A9pV1Uq7VX/B/aPaKfTyYOucmfHx8YzhaLOYa7cYJ34UVvWcYeoahjzy/HBa1YeD+kFZP2IwmMWINQf5OkYGbUwSd4qa71X1nt3HVeXqPK1PHHpCg1l+dHs84rlyszPVGWRpBrsLmNQ3KJA9lUoxn7lhysDlq+NmhxUKZvGwCGRHYYFxs8acRrd32rctWrQKZl4KfIQhdBfIGt32qSowLm6AZBHg0TpM4zuWt8pA9gTW8ZzN0nRZIQSX7p0RBGMjuAei4kC+rPTWCiVSZ+N7DEm/1LpqrobjktO6HNdaw/GNV+f2ZNCuAlEV4LkpMmrmLOmtpJlWpUArNAcki4O7UAZk3pTP+sCwVFfY3xLfAyC7HMsh7P3vGeBmGYWojgD5xOBhwpn4LV7FP7F9exBbTfzRxLN4kfjx7Zd4kfuDJv6Lrfgr15NKiUfpTp0D8vXak4YaA09lZ+3Lnj09871waEX3tU5wPUKPu5PuxJlTNZ",
	"MD": "KHKLKSDJLKSJDLKSJDLKJL",
}
```

Response

Redirect
Http code 200

Success
https://epay.homebank.kz/payform/success.html
Params
amount
currency
invoiceID
accountID
description
reference
language
cardid

Error
https://epay.homebank.kz/payform/
invoiceID
code
message

# RSA PUBLIC KEY

```
-----BEGIN RSA PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAqoATnGMtByQojuoYFKEx
vEqszShV2vk6chCJFx0/vmSHBqcCTazhJqBmYU9gyM/TjVWLsjFAbd4nvCxIGpqF
g3J7UJccfODKibyfSUSqGsAJE1MJh3EaJivkd85/FkZkv3zBeT/193NmakNs0+T+
PUMmSdAPSnfUWi2KSIp48mSA38CbMvOwndkKNEeqCoIQn/fApfZ8MWIEFVd3gpfs
Ve0zYhSjvTOHPD0/7TOdcQyArxLZY0yS7m32rUOibuO7EhGNQL/bC73ZbuS5nXhr
a03nNIW3FfSJUTJBjVWDZRoNk9gm4pOimAeb0IiqnmlTPOvkqHYsOEjQ8KJAFlGO
1igelk1+dA5ZiY6r0YExc1KnW7UsnGk6nr7cgOR2po/sa4kctiKLqlGA35ILmUBQ
Yb6iReCQkggXMOvmP6p+4wEt1B7V8UJxzFZcQZ5QSRIk3o3pVrfY0gksidl0Xt5m
ft+E6a77ZQKG4TOQS9Ly1mIJ2qqaWqCWglVMWFiFCx9dXTN0RMli1T0rs1gA2jsP
z2/HiyY8EUp6t4Ufc8VbJYG9vt24UTwYgu+qDEBjggm5YKVCxjCvhJWwh9LaL9Uu
K46Apgr5wgEyMIJZRO7RxkjKkJI29FAP3wEs9y+/3qsjH3chFzdX0/+6lA+9lePK
PX0Z5SPexWRiQp9bND4iZRcCAwEAAQ==
-----END RSA PUBLIC KEY-----
```


Cryptogram based payments

> URL: POST /operation/:id/charge  
> Amount field is optional. If Amount is not given full transaction amount is refunded.

```
Headers
    Authorization: Bearer dGVzdGNsaWVudDpzZWNyZXQ=
```

```
Response

Http status 200
```

### Error 
```
Http status 400.x

{
    "code": 100,
    "message": ""
}
```

Payment confirmation/partial confirmation

```
URL TEST GET https://testepay.homebank.kz/api/cards/:accountId
URL PROD GET https://epay-api.homebank.kz/cards/:accountId
```

```
Headers
    Authorization: Bearer dGVzdGNsaWVudDpzZWNyZXQ=
```

```
Response

Http status 200

Responce Body:

[
    {
        "ID": "6845e5d5-35cc-428e-bd95-e85f78cb59d1",
        "TransactionId": "a4b8c500-ddbf-4475-b512-60cd5a9189f7",
        "MerchantID": "1a8ca610-73eb-4996-a2ef-5ec1d57bf573",
        "CardHash": "ac2d26319b1910692db0e357e88a3d02cd9e7867d72e6d2c6f4f48e61a46201e",
        "CardMask": "4405...2283",
        "PayerName": "TEST",
        "Reference": "034680043232",
        "IntReference": "005224F86969006E",
        "Token": "A5011A20B136418774169BC24030C63B",
        "Terminal": "98458031",
        "CreatedDate": "2020-12-11T15:47:58.828909+06:00",
        "PaymentAvailable": false,
        "AccountID": "testuser1"
    },
    {
        "ID": "a436211c-ede4-479f-a9db-2db2d392e34b",
        "TransactionId": "97bac35c-8bf3-496a-be77-8e9eb449783d",
        "MerchantID": "1a8ca610-73eb-4996-a2ef-5ec1d57bf573",
        "CardHash": "1b2aea5eb284955c4e18c8d6289e5eb59c091199fd5f9861d09dbd26b1862119",
        "CardMask": "4405...3681",
        "PayerName": "TEST",
        "Reference": "101478049099",
        "IntReference": "C5006F368549CC7C",
        "Token": "FBDA466B628544D294750DA9B211D3CC",
        "Terminal": "98458031",
        "CreatedDate": "2021-01-14T10:28:22.418199+06:00",
        "PaymentAvailable": false,
        "AccountID": "testuser1"
    },
    {
        "ID": "73cfea54-984d-48a5-b7d4-5af5473b2361",
        "TransactionId": "73f13bf6-1d3c-4234-9d57-94a0cb64784f",
        "MerchantID": "1a8ca610-73eb-4996-a2ef-5ec1d57bf573",
        "CardHash": "8894abac4bd183781b580a4e814295773a497822eeefdfb130f7c8414842ed32",
        "CardMask": "4405...2817",
        "PayerName": "TEST",
        "Reference": "101481049101",
        "IntReference": "DF9641E3F0AED452",
        "Token": "79DEF615A266413C68F9710315B082AF",
        "Terminal": "98458031",
        "CreatedDate": "2021-01-14T10:51:22.491067+06:00",
        "PaymentAvailable": false,
        "AccountID": "testuser1"
    },
    {
        "ID": "89fe31cb-4e64-4171-ad80-a364108e61e5",
        "TransactionId": "2df0160b-607c-4227-ab70-2f6a93ab828b",
        "MerchantID": "1a8ca610-73eb-4996-a2ef-5ec1d57bf573",
        "CardHash": "6257ce459bc48fa5205c025181da7cf2e7568cb07428b127544e0d4043d92296",
        "CardMask": "4405...1206",
        "PayerName": "TEST",
        "Reference": "101481049104",
        "IntReference": "6A50F85C03040E83",
        "Token": "62D54B1F3B22498FBBBB31CC4A7BAA81",
        "Terminal": "98458031",
        "CreatedDate": "2021-01-14T11:36:20.721898+06:00",
        "PaymentAvailable": false,
        "AccountID": "testuser1"
    },
    {
        "ID": "60bf3ecc-58af-4b1d-b081-b7f3485b1f5c",
        "TransactionId": "5ee29078-e17e-49f0-aba5-3c6ad7953113",
        "MerchantID": "1a8ca610-73eb-4996-a2ef-5ec1d57bf573",
        "CardHash": "f934e44abc31e19441f80ebed5c8e2c2fe3215185919bc50273cbff60d928499",
        "CardMask": "4405...2206",
        "PayerName": "TEST",
        "Reference": "101481049105",
        "IntReference": "3154F37D704BD9F0",
        "Token": "F0BD5BAEC2174BD24E8773975E2EC648",
        "Terminal": "98458031",
        "CreatedDate": "2021-01-14T11:45:29.235698+06:00",
        "PaymentAvailable": false,
        "AccountID": "testuser1"
    }
]
```
If no saved cards are available with associated accountId:

```
Response

Http status 200

Responce Body:
{
    "code": 1373,
    "message": "Запись не найдена!"
} 
```

### Error
```
{
    "code": 100,
    "message": ""
}
```

Receiving a list of saved cards

> URL POST /oauth2/token
```
TEST URL POST https://testoauth.homebank.kz/epay2/oauth2/token
PROD  URL POST https://epay-oauth.homebank.kz/oauth2/token
```

## Client credentials

```
Request

Request Body:
    grant_type:         "client_credentials"
    scope:              "webapi"
    client_id:          "CLIENTID"
    client_secret:      "CLIENTSECRET"

Responce

{
    "access_token": "DCEB8O_ZM5U7SO_T_U5EJQ",
    "expires_in": 7200,
    "scope": "webapi",
    "token_type": "Bearer"
}
```

## Error

```
HTTP code 4XX.X 
```

## Password credentials
```
Request

Request Header
    deviceid:          "69f3db46-8092-4094-8910-bb6e3d6ba969"	//не обязательное
    ip:                "10.3.23.42"								//не обязательное
    fingerprint:       "asdasdfr90a7889a7sdasd9"				//не обязательное

Request Body:
    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
}
```

## Error

```
HTTP code 4XX.X 
```

Receiving token

## Transaction Status

```
TEST URL: GET https://testepay.homebank.kz/api/check-status/payment/transaction/:invoiceid

PROD URL: GET https://epay-api.homebank.kz/check-status/payment/transaction/:invoiceid
```

**Authorization required: client credentials**
### Request
**Body**: form-data

```
grant_type:"client_credentials"
scope:"webapi usermanagement email_send verification statement statistics payment"
client_id:"test"
client_secret:"yF587AV9Ms94qN2QShFzVR3vFnWkhjbAK3sG"
terminal:"67e34d63-102f-4bd1-898e-370781d0074d"
```

Field|Description
-------------|-------------|
**grant_type**|authorization type, client_credentials type is used for making a payment |
**scope** | resource |
**client_id** | ID from system ePay can be  issued during after registration and conclusion of the contract |
**client_secret** | Merchant's access key, can be obtained in the account issued upon registration |
**terminal** |  ID from system ePay can be obtained in the account, issued during registration |

### Ответ
```json
{
  "access_token":"DCEB8O_ZM5U7SO_T_U5EJQ",
  "expires_in": 7200,
  "refresh_token":"",
  "scope":" webapi usermanagement email_send verification statement statistics payment",
  "token_type":"Bearer"
}
```

Field  |Description
------------- | -------------
**access_token** | Operation token
**expires_in** | Token expiration time
**refresh_token** | Not used for this type of authorization
**scope** | Resource
**token_type** | Authorization type

```
Headers
    Authorization: Bearer dGVzdGNsaWVudDpzZWNyZXQ=
```

```
HTTP CODE 200

Responce Body JSON:

{
    "resultCode": "100",
    "resultMessage": "SUCCESS",
    "transaction": {
        "id": "ef1505b2-b136-4e64-a8b5-e547b6440d6f",
        "createdDate": "2022-09-27T15:08:35.071828+06:00",
        "invoiceID": "10338026186011",
        "amount": 0,
        "amountBonus": 0,
        "payoutAmount": 0,
        "currency": "",
        "terminal": "98458031",
        "accountID": "",
        "description": "payment for order 123456",
        "language": "RU",
        "cardMask": "400303...9821",
        "cardType": "",
        "issuer": "Казкоммерцбанк",
        "reference": "227078813195",
        "intReference": "",
        "secure": false,
        "statusID": "5bbb7dd5-4691-41ee-a6a5-755a3d23a218",
        "statusName": "CHARGE",
        "name": "TEST",
        "email": "",
        "phone": "",
        "cardID": "e8a09f98-04b4-71a6-e053-1d1a000aa0d2"
    }
}

```

### Error
```
{
    "resultCode": "101",
    "resultMessage": "reject",
    "transaction": null
}
```

__> ### resultCode __

Field|Description
-------------|-------------|
| **100** |	success  |   успех выполнения запроса, в каком состоянии находиться платеж необходимо смотреть по statusName|
| **101** |	reject   | транзакция неуспешная |
| **102** |	invoice not found, try again later or check transaction type (payment/p2p)        | номер invoiceId не найден в системе, возможно ваша трназакция проходила по сервису p2p |
| **103** |	error, try again or contact support | необходимо повторить запрос либо обратиться в службу поддержки | 
| **103** |	field terminal absent in token | отстусвует параметр TerminalID при запросе токена|
