# Эмуляторы банков для платежей и переводов

Участник может протестировать реализацию API по платежам и переводам используя эмуляторы банков. Эмуляторы банков позволяют: 

* моделировать поведение отправляющей стороны при переводе/платеже;
* моделировать поведение стороны, получающей деньги при переводе/платеже;
* моделировать возвраты переводов/платежей.

{% hint style="warning" %}
Для работы с сервисами по платежам необходимо передать в АО НПК URL для QR-платежей (будет 2 URL для тестового сервиса и промышленного сервиса соответственно) по примерному шаблону:

[https://links.bankname.kz/](https://links.bvuname.kz/).
{% endhint %}

{% hint style="success" %}
Доступно два эмулятора банков: 

* <https://mock-bank-1.stage.npck.kz&#x20>;
* <https://mock-bank-2.stage.npck.kz>

Функциональность у них идентична (каждый может как отправлять платежи/переводы, так и получать)
{% endhint %}

## Моделирование действий Клиента (физического лица)

Для входа в качестве Клиента (физического лица) необходимо на форме входа во вкладке <**Пользователь**> указать любой номер телефона (кроме указанных в [#dannye-dlya-modelirovaniya-oshibok](#dannye-dlya-modelirovaniya-oshibok "mention")) и нажать кнопку <*Вход*>.

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FQxmHbyfIlB51G38qxziu%2Fimage.png?alt=media&#x26;token=eaddabc1-108f-4354-af91-e9a3c82f424f" alt=""><figcaption></figcaption></figure>

ФИО клиента генерируется автоматически. Есть возможность отправить перевод, произвести платежи, выполнить возвраты, просмотреть список транзакций по данному клиенту.

В списке транзакции отображается подробная информация по каждой проведенной транзакции (исходящей и входящей).

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2F7Im4Uf7J9SqbJ3V78c84%2Fimage.png?alt=media&#x26;token=1a169db7-9887-4a12-9f2c-7439252ec857" alt=""><figcaption><p>Список транзакций клиента</p></figcaption></figure>

<details>

<summary>Отправка перевода</summary>

Для отправки перевода необходимо выполнить следующие действия:

1. Нажать на кнопку ![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FmtyFDUvNBvJ46ZgeB5Jy%2Fimage.png?alt=media\&token=d1d70a8a-eb63-4f44-ad8e-d2c9cc601d7c)
2. Ввести номер телефона получателя, выбрать банк и нажать <*Проверить счет*>.&#x20;
3. Ввести сумму и нажать <*Перевести*>. Будет эмулирован поток сообщений в указанный банк-получатель (подробнее поток сообщений описан в [inicializaciya-perevodov-denezhnykh-sredstv](https://docs.npck.kz/mezhbankovskaya-sistema-perevodov-i-platezhei/inicializaciya-perevodov-denezhnykh-sredstv "mention")).

![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FhIA9HfvDs1TOTamE5PiE%2Fimage.png?alt=media\&token=96f0ca32-d574-488f-86fa-003d4e78b89a)

</details>

<details>

<summary>Возврат полученного перевода</summary>

Для возврата полученного перевода необходимо выполнить следующие действия:

1. В списке транзакции выбрать полученный перевод и нажать кнопку <*Возврат*>.

![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FpO5c51xQ9yqjU2dz4z4h%2Fimage.png?alt=media\&token=adb3ccf6-5048-4f65-a98d-39bbe5ede84e)

2. Нажать кнопку <*Выполнить возврат*>. Будет смоделирован поток сообщений по возврату перевода его отправителю (подробнее поток сообщений описан в [vozvrat-poluchennogo-perevoda-c2cr](https://docs.npck.kz/mezhbankovskaya-sistema-perevodov-i-platezhei/inicializaciya-perevodov-denezhnykh-sredstv/vozvrat-poluchennogo-perevoda-c2cr "mention")).

![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FcbsAVqO1BqNUWHklJtg4%2Fimage.png?alt=media\&token=593873c7-36eb-4a16-a680-2aaa56d5645d)

*Примечание: Выполняется возврат всей суммы полученного перевода*

</details>

<details>

<summary>Оплатить платеж</summary>

Для оплаты платежа необходимо выполнить следующие действия:

1. Нажать на кнопку ![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2Fc4kDeJ3M6M4nbaikAIoe%2Fimage.png?alt=media\&token=ba9ffcc7-eaf0-4482-b9ea-9700cbae662f)
2. Ввести данные платежа и нажать <*Получить информацию*>.

![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FDjEpJAs1Ycyxxw8rxfJx%2Fimage.png?alt=media\&token=4b1801de-2406-493d-a13a-ef907ef3136f)

3. Нажать <*Оплатить*>.

Если введены данные для платежа по статическому QR-коду, то дополнительно необходимо указать сумму платежа. Будет эмулирован поток сообщений в банк-получателя (подробнее поток сообщений описан в [inicializaciya-provedeniya-platezhei-po-qr-kodu-v-ramkakh-adaptacionnoi-modeli](https://docs.npck.kz/mezhbankovskaya-sistema-perevodov-i-platezhei/inicializaciya-provedeniya-platezhei-po-qr-kodu-v-ramkakh-adaptacionnoi-modeli "mention")).

![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FpTO8PPv2s05ur5WY8RaM%2Fimage.png?alt=media\&token=d0473fab-4277-4de2-8b9d-41e320b48bb9)

</details>

<details>

<summary>Инициализация возврата платежа</summary>

Для инициализации возврата платежа необходимо выполнить следующие действия:

1. Нажать на кнопку ![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FX50sdFNPpABNCO22fzrC%2Fimage.png?alt=media\&token=48199998-c137-45b3-9be8-6719ebd72955)
2. Ввести данные из QR-кода для возврата и нажать кнопку <*Получить информацию*>. Будет смоделирован поток сообщений по возврату денег отправителю (подробнее в [vozvrat-deneg-po-provedennoi-ranee-oplate-za-tovar-uslugu-c2br](https://docs.npck.kz/mezhbankovskaya-sistema-perevodov-i-platezhei/inicializaciya-provedeniya-platezhei-po-qr-kodu-v-ramkakh-adaptacionnoi-modeli/vozvrat-deneg-po-provedennoi-ranee-oplate-za-tovar-uslugu-c2br "mention"))

![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FYkRHtpnYbpdXvovKNczS%2Fimage.png?alt=media\&token=5b672347-f28e-4bed-92c8-c006e3ac3447)

</details>

## Моделирование действий Поставщика товаров/ работ/ услуг (мерчанта)

Для входа в качестве Поставщика товаров/ работ/ услуг (мерчанта) необходимо на форме входа во вкладке <**Организация**>   указать любой БИН (кроме указанных в [#dannye-dlya-modelirovaniya-oshibok](#dannye-dlya-modelirovaniya-oshibok "mention")) и нажать кнопку <*Вход*>.

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FxB32tOlaeV6gYbF5MKU6%2Fimage.png?alt=media&#x26;token=7f625f4e-e0c0-41af-9f59-6bae22f1d685" alt=""><figcaption></figcaption></figure>

Наименование мерчанта генерируется автоматически. Есть возможность сгенерировать данные для проведения платежа,  выполнить возвраты, просмотреть список транзакций по данному мерчанту.

В списке транзакции отображается подробная информация по каждой проведенной транзакции (исходящей и входящей).

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FQHwtjCOQY9nIQGaXDoyj%2Fimage.png?alt=media&#x26;token=c4286518-42f4-474f-89a1-4eaef1a6bef4" alt=""><figcaption><p>Список транзакций мерчанта</p></figcaption></figure>

<details>

<summary>Генерация данных для проведения платежа</summary>

Для генерации данных для проведения платежа необходимо выполнить следующие действия:

1. Нажать кнопку ![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2F7WC2etEpKhpnLuAxlvvU%2Fimage.png?alt=media\&token=aca426a2-c50e-4569-87ef-cc0722e6be32)
2. Ввести данные для формирования данных для проведения платежа.&#x20;

Для динамического QR-кода указывается сумма платежа при его генерации.&#x20;

Для статического QR-кода сумма платежа указывается клиентом при его оплате.

![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FBdtA9Nev6KUmSTYJz2uI%2Fimage.png?alt=media\&token=9a95b7b7-3c5b-42e2-8387-df38fd9af07a)

3. Нажать кнопку <*Сформировать*>  (вы получите QR в виде ссылке) и скопировать полученные данные, которые должны быть использованы для последующего моделирования оплаты данного платежа клиентом (см. [inicializaciya-provedeniya-platezhei-po-qr-kodu-v-ramkakh-adaptacionnoi-modeli](https://docs.npck.kz/mezhbankovskaya-sistema-perevodov-i-platezhei/inicializaciya-provedeniya-platezhei-po-qr-kodu-v-ramkakh-adaptacionnoi-modeli "mention")).

Для генерации QR-кода в виде изображения перейдите во вкладку "QR"

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FrEBCI4OZ7fksI0aEoanO%2Fimage.png?alt=media&#x26;token=35874afe-796d-41f3-8ffe-6c7705e597ba" alt=""><figcaption></figcaption></figure>

1\) Введите любой БИН.

2\) Нажмите на кнопку <Войти>.

3\) Укажите сумму оплаты в тенге.

4\) Нажмите кнопку <Сформировать QR>.

</details>

<details>

<summary>Возврат денег по полученному платежу</summary>

Для возврата денег по полученному платежу необходимо выполнить следующие действия:

1. В списке транзакции выбрать платеж и нажать кнопку <*Возврат*>.

![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FOWiUMQPQ4YvNHLrZvxcH%2Fimage.png?alt=media\&token=bc2078aa-2e83-4015-97c5-fa28fd9786e9)

2. Скопировать полученные данные для инициирования возврата платежа, используя которые необходимо направить сообщение admi.009 с данными клиента для возврата (подробнее в [vozvrat-deneg-po-provedennoi-ranee-oplate-za-tovar-uslugu-c2br](https://docs.npck.kz/mezhbankovskaya-sistema-perevodov-i-platezhei/inicializaciya-provedeniya-platezhei-po-qr-kodu-v-ramkakh-adaptacionnoi-modeli/vozvrat-deneg-po-provedennoi-ranee-oplate-za-tovar-uslugu-c2br "mention"))

![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FPqCgnwhiTcVVbElQwcWL%2Fimage.png?alt=media\&token=5a281d59-76a1-43b4-85f8-fb73f472dedd)

3. Ввести сумму возврата и нажать кнопку <*Выполнить возврат*>. Будет смоделирован поток сообщений по возврату денег отправителю (подробнее в [vozvrat-deneg-po-provedennoi-ranee-oplate-za-tovar-uslugu-c2br](https://docs.npck.kz/mezhbankovskaya-sistema-perevodov-i-platezhei/inicializaciya-provedeniya-platezhei-po-qr-kodu-v-ramkakh-adaptacionnoi-modeli/vozvrat-deneg-po-provedennoi-ranee-oplate-za-tovar-uslugu-c2br "mention")).

![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FSf3eCR2xmBjKYpXjOXj0%2Fimage.png?alt=media\&token=f94a4856-f098-42f5-a3f5-9672d7f40c76)

</details>

## Данные тестового банка

На форме входа во вкладке <**Банк**> можно посмотреть данные тестового банка. Используя эти данные можно отправлять сообщения тестовому банку для отладки исходящих платежей / переводов.

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2Fo964Z544MhTYGxMH979V%2Fimage.png?alt=media&#x26;token=5c2a33f3-33ca-46ff-8ca1-62662b634de6" alt=""><figcaption></figcaption></figure>

При нажатии на кнопку <*Получить выписку*> отображается выписка по тестовому банку.

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FgireMJWSAHSewXpm0pqo%2Fimage.png?alt=media&#x26;token=d5d1c594-c1f6-4d07-ad31-45121d505c29" alt=""><figcaption><p>Просмотр  выписки</p></figcaption></figure>

### Данные для моделирования ошибок

Во вкладке <**Банк**>  при нажатии на кнопку <*Список ошибок*> доступен список номеров телефонов и БИН, используя которые можно моделировать ошибки.&#x20;

При вводе данных из "Списка ошибок" эмулятор будет генерировать ответ с соответствующей ошибкой, тем самым участник сможет отладить их корректную обработку.

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2F3cNAd6YIaSFUHHzAEx6w%2Fimage.png?alt=media&#x26;token=d14f1f2b-ee15-40ca-bd0f-92d95948e8a2" alt=""><figcaption><p>Данные для моделирования ошибок</p></figcaption></figure>

> *В "Списке ошибок" по каждой ошибки приводится:*&#x20;
>
> * *код ошибки*
> * *номер телефона / БИН, который нужно указать в качестве получателя платежа/перевода*
> * *краткое описание*