# Touch&Go {#pm_touchngo}

статья о работе с платёжным методом Touch&Go, который позволяет проводить платежи в малайзийских ринггитах с использованием электронных кошельков в Малайзии и для которого в платформе Ecommpay поддерживаются оплаты и выплаты

**На уровень выше:**[Платежи с использованием электронных кошельков](ru_pm_ewallet.md)

## Обзор {#ru_pm_touchngo_overview}

статья о работе с платёжным методом Touch&Go, который позволяет проводить платежи в малайзийских ринггитах с использованием электронных кошельков в Малайзии и для которого в платформе Ecommpay поддерживаются оплаты и выплаты

### Введение {#section_ql3_5fj_stb .section}

Touch&Go — метод, позволяющий проводить платежи в малайзийских ринггитах с использованием электронных кошельков в Малайзии. Для этого метода в платёжной платформе Ecommpay поддерживаются оплаты и выплаты.

В этой статье представлена информация о работе с методом Touch&Go: обзорный раздел с общими сведениями и последующие разделы с информацией о действиях, необходимых со стороны мерчанта для решения разных задач.

### Характеристика {#section_tbf_2zk_ggb .section}

|Тип платёжного метода|платежи с использованием электронных кошельков|
|Платёжные инструменты|электронные кошельки|
|Регионы использования|[MY](references/ru/countries/MY.md)|
|Валюты платежей|[MYR](references/ru/currencies/MYR.md)|
|Конвертация валют|на стороне Ecommpay|
|Разовые оплаты|+|
|Повторяемые оплаты|–|
|Полные возвраты|–|
|Частичные возвраты|–|
|Выплаты|+|
|Опротестования|–|
|Особенности|–|
|Организация и стоимость подключения|по согласованию с курирующим менеджером Ecommpay|

### Схема работы {#section_tsp_gzk_ggb .section}

В проведении отдельного платежа с использованием метода Touch&Go задействуются веб-сервис мерчанта, один из интерфейсов и платёжная платформа Ecommpay, а также технические средства сервиса провайдера.

![](images/pm/ru_touchngo_functional.svg)

### Основные операции {#section_rnx_4cl_ggb .section}

Для проведения платежей и выполнения операций с использованием метода Touch&Go могут применяться различные интерфейсы платёжной платформы. Так, оплаты могут проводиться через Payment Page, Gate и Dashboard \(с применением платёжных ссылок\), а выплаты — через Gate и Dashboard. При этом, независимо от используемых интерфейсов, для этого метода характерны следующие свойства и ограничения.

||Суммы, MYR|Время¹|
|минимум|максимум|базовое|предельное|
|--|----------|------|
|-------|--------|-------|----------|
|Оплаты|1,00|30 000,00|2 минуты|\*|
|Выплаты|5,00|20 000,00|2 минуты|\*|

\* Информацию о предельном времени можно уточнять у курирующего менеджера Ecommpay.

**Прим.:**

1.  Базовое и предельное время определяются следующим образом:
    -   Базовое время — среднее расчётное время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Это время определяется для условий штатной работы всех технических средств и каналов связи, а также типичных действий со стороны пользователя. Базовое время рекомендуется использовать для реагирования на отсутствие оповещений о результате платежа и выполнения опроса состояния платежа \([подробнее](ru_Gate_payment_status_request.md#)\).
    -   Предельное время — максимально допустимое время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Если платёж не был проведён или отклонён за это время, он автоматически переводится в статус `decline`. Для индивидуальной настройки предельного времени следует обращаться к специалистам технической поддержки Ecommpay.

### Сценарии использования {#section_fgt_sdl_ggb .section}

Проведение оплат с использованием метода Touch&Go осуществляется с перенаправлением пользователей к сервису провайдера.

Пользовательский сценарий оплаты через Payment Page выглядит следующим образом.

![](images/ecommpay/pm_pp_scenario/ru_pp_customer_scenario_touchngo_1.svg "Переход к оплате")

![](images/ecommpay/pm_pp_scenario/ru_pp_customer_scenario_touchngo_2.svg "Выбор метода")

![](images/ecommpay/pm_pp_scenario/ru_pp_customer_scenario_touchngo_3.svg "Аутентификация")

![](images/ecommpay/pm_pp_scenario/ru_pp_customer_scenario_touchngo_4.svg "Подтверждение платежа")

![](images/ecommpay/pm_pp_scenario/ru_pp_customer_scenario_touchngo_5.svg "Возвращение к форме")

![](images/ecommpay/pm_pp_scenario/ru_pp_customer_scenario_touchngo_6.svg "Возвращение к веб-сервису")

Общие сценарии проведения оплат и выплат можно представить следующим образом.

![](images/pm/ru_touchngo_interfaces_pp.svg "Оплата через Payment Page")

![](images/pm/ru_touchngo_interfaces_gate.svg "Оплата через Gate")

![](images/pm/ru_touchngo_interfaces_gate_payout.svg "Выплата через Gate")

Сценарии выполнения операций через основные интерфейсы платёжной платформы соответствуют представленным на схемах.При использовании дополнительных возможностей \(таких как платёжные ссылки\) сценарии выполнения операций методом Touch&Go соответствуют специфике этих возможностей.

## Оплаты через Payment Page {#ru_pm_touchngo_pp_purchase}

### Общая информация {#section_gtg_vxk_m2b .section}

Для проведения оплаты через Payment Pageс использованием метода Touch&Go со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL Ecommpay и принять оповещение о результате.Полная схема проведения оплаты выглядит следующим образом.

![](images/pm/ru_touchngo_uml_pp.svg)

1.  Пользователь на стороне веб-сервиса инициирует оплату.
2.  От веб-сервиса на заданный URL Ecommpay передаётся запрос на проведение оплаты через Payment Page.
3.  Запрос на проведение оплаты поступает в платёжную платформу.
4.  В платёжной платформе выполняется приём запроса, с проверкой наличия обязательных параметров и корректной подписи.
5.  Осуществляется подготовка Payment Page согласно параметрам проекта и вызова.
6.  Пользователю отображается платёжная форма.
7.  Пользователь выбирает для оплаты метод Touch&Go.
8.  В платёжную платформу передаётся запрос на проведение оплаты с использованием метода Touch&Go.
9.  В платёжной платформе выполняются обработка полученного запроса и формирование данных для перенаправления.
10. Данные для перенаправления пользователя передаются к Payment Page.
11. Пользователь перенаправляется к сервису провайдера.
12. Пользователь выполняет необходимые действия для оплаты.
13. В сервисе провайдера выполняется обработка платежа.
14. Пользователь перенаправляется к Payment Page.
15. От сервиса провайдера к платёжной платформе направляется информация о результате оплаты.
16. От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
17. От платёжной платформы к Payment Page направляется информация о результате оплаты.
18. Информация о результате оплаты отображается пользователю на Payment Page.

Информация о форматах запросов и оповещений, используемых для проведения оплат методом Touch&Go через Payment Page, приведена далее в этом разделе; общая информация о работе с Payment Page API — в отдельной статье [Организация взаимодействия](ru_pp_interaction_organisation.md#).

### Формат запросов {#section_p5j_fgl_ggb .section}

При формировании запросов на открытие платёжной формы с применением метода Touch&Go необходимо учитывать следующее:

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

    -   `project_id` — идентификатор проекта, полученный от Ecommpay при интеграции;
    -   `payment_id` — идентификатор платежа, уникальный в рамках проекта;
    -   `payment_currency` — код валюты платежа в формате ISO-4217 alpha-3;
    -   `payment_amount` — сумма платежа в дробных единицах валюты;
    -   `customer_id` — идентификатор пользователя в рамках проекта.
    В зависимости от платёжного провайдера может требоваться указание и других параметров.

2.  Для предварительного выбора метода Touch&Go необходимо указывать код этого метода в параметре `force_payment_method` — `touchngo\_wallet`.
3.  Дополнительно могут использоваться любые другие параметры из числа доступных для работы с Payment Page \([подробнее](ru_PP_Parameters.md)\).
4.  После указания всех целевых параметров необходимо составлять подпись \([подробнее](ru_platform_signature.md#)\).

Таким образом, корректный запрос на открытие платёжной формы с применением метода Touch&Go должен содержать идентификатор проекта, базовые сведения о платеже \(идентификатор, сумму и код валюты\), идентификатор пользователя и подпись.

```language-json
{
   "project_id": 120,
   "payment_id": "580",
   "payment_amount": 50000,
   "payment_currency": "MYR",
   "customer_id": "customer1",
   "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg=="
}
```

```language-json
{
   "project_id": 120,
   "payment_id": "580",
   "payment_amount": 50000,
   "payment_currency": "MYR",
   "customer_id": "customer1",
   "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg=="
}
```

### Формат оповещений {#section_dpx_2hl_ggb .section}

Для оповещений о результатах оплат с применением метода Touch&Go используется типовой формат, описание которого представлено в статье [Работа с оповещениями](ru_platform_callbacks.md#).

В следующем примере оповещение свидетельствует о том, что в рамках проекта `1234` для пользователя была проведена оплата в размере `500,00 MYR`.

```language-json
{
    "project_id": 1234,
    "payment": {
        "id": "payment_47",
        "type": "purchase",
        "status": "success",
        "date": "2022-03-25T11:08:45+0000",
        "method": "Touchngo Wallet",
        "sum": {
            "amount": 50000,
            "currency": "MYR"
        },
        "description": ""
    },
    "customer": {
        "id": "customer_123"
    },
    "operation": {
        "id": 28,
        "type": "sale",
        "status": "success",
        "date": "2022-03-25T11:08:45+0000",
        "created_date": "2022-03-25T11:08:05+0000",
        "request_id": "9e32835fb27907e0e336c5117242b5cf60a4e17839",
        "sum_initial": {
            "amount": 50000,
            "currency": "MYR"
        },
        "sum_converted": {
            "amount": 50000,
            "currency": "MYR"
        },
        "code": "0",
        "message": "Success",
        "provider": {
            "id": 0000,
            "payment_id": "123abc123-321",
            "auth_code": ""
        }
    },
    "signature": "U7HQO7ToISZhMPKdMaxkUKQtoYzFvoB3cs9CRd4xeYG2Q=="
}
```

В следующем примере оповещение свидетельствует об отклонённой оплате.

```language-json
{
    "project_id": 1234,
    "payment": {
        "id": "payment_47",
        "type": "purchase",
        "status": "decline",
        "date": "2022-03-25T11:20:30+0000",
        "method": "Touchngo Wallet",
        "sum": {
            "amount": 50000,
            "currency": "MYR"
        },
        "description": ""
    },
    "customer": {
        "id": "customer_123"
    },
    "operation": {
        "id": 31,
        "type": "sale",
        "status": "decline",
        "date": "2022-03-25T11:20:30+0000",
        "created_date": "2022-03-25T11:19:53+0000",
        "request_id": "fff3d5f8d5d31bc460b68b57dc63f4b482e906eb",
        "sum_initial": {
            "amount": 50000,
            "currency": "MYR"
        },
        "sum_converted": {
            "amount": 50000,
            "currency": "MYR"
        },
        "code": "20000",
        "message": "General decline",
        "provider": {
            "id": 0000,
            "payment_id": "0cf4215c-8978",
            "auth_code": ""
        }
    },
    "signature": "J7W15rkqrLzTCD4HkoMm8C4z258P4VnHANu445/jmY+g=="
}
```

### Дополнительные материалы {#section_xpz_thl_ggb .section}

Для организации работы с оплатами через Payment Page также могут быть полезны следующие материалы:

-   [Организация взаимодействия](ru_pp_interaction_organisation.md#)— о том, как организовать взаимодействие веб-сервиса с платёжной платформой через Payment Page.
-   [Работа с подписью к данным](ru_platform_signature.md#)— о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
-   [Проведение платежей](ru_platform_payment_model.md)— о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
-   [Проведение оплат](ru_pp_purchase.md)— о том, как проводить разовые оплаты через Payment Page.
-   [Работа с информацией об операциях](ru_platform_payment_info_codes.md)— о служебных кодах, которые используются в платёжной платформе, чтобы фиксировать информацию о выполнении операций.

## Оплаты через Gate {#ru_pm_touchngo_gate_purchase}

### Общая информация {#section_lsx_3jl_ggb .section}

Для проведения оплаты через Gate с использованием метода Touch&Go со стороны веб-сервиса необходимо:

1.  Отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL Ecommpay.
2.  Принять промежуточное оповещение от платёжной платформы и осуществить перенаправление пользователя к сервису провайдера.
3.  Принять итоговое оповещение от платёжной платформы.

Полная схема проведения оплаты выглядит следующим образом.

![](images/pm/ru_touchngo_uml_gate.svg)

1.  Пользователь на стороне веб-сервиса инициирует оплату с использованием метода Touch&Go.
2.  От веб-сервиса на заданный URL Ecommpay передаётся запрос на проведение оплаты через Gate.
3.  Запрос на проведение оплаты поступает в платёжную платформу Ecommpay.
4.  В платёжной платформе выполняется приём запроса с проверкой наличия обязательных параметров и корректной подписи.
5.  От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности \([подробнее](ru_gate_interaction_organisation.md#)\).
6.  В платёжной платформе выполняются дальнейшая обработка запроса \(с проверкой согласованности параметров\) и формирование данных для перенаправления.
7.  От платёжной платформы к веб-сервису направляется оповещение с данными для перенаправления пользователя к сервису провайдера.
8.  Пользователь перенаправляется к сервису провайдера.
9.  Пользователь выполняет необходимые действия для оплаты.
10. В сервисе провайдера выполняется обработка платежа.
11. Пользователь перенаправляется к веб-сервису.
12. От сервиса провайдера к платёжной платформе направляется информация о результате оплаты.
13. От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
14. На стороне веб-сервиса обеспечивается информирование пользователя о результате оплаты.

Информация о форматах запросов и оповещений, используемых для проведения оплат методом Touch&Go через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье [Организация взаимодействия](ru_gate_interaction_organisation.md#).

### Формат запросов {#section_osx_3jl_ggb .section}

При работе с запросами на оплаты с применением метода Touch&Go необходимо учитывать следующее:

1.  Для инициирования каждой оплаты должен использоваться отдельный POST-запрос к конечной точке `/v2/payment/wallet/touchngo/sale`. Эта точка относится к группе [/v2/payment/wallet/\{payment\_method\}/sale](https://api-developers.ecommpay.com/api-specification/wallet/post-v2-payment-wallet-payment-method-sale).
2.  В каждом запросе должны использоваться следующие объекты и параметры:

    -   `general` — объект, содержащий основные идентификационные сведения запроса:
        -   `project_id` — идентификатор проекта, полученный от Ecommpay при интеграции;
        -   `payment_id` — идентификатор платежа, уникальный в рамках проекта;
        -   `signature` — подпись запроса, составленная после указания всех целевых параметров \(подробнее — в разделе [Работа с подписью к данным](ru_platform_signature.md#)\);
    -   `payment` — объект, содержащий сведения о платеже:
        -   `amount` — сумма платежа в дробных единицах валюты;
        -   `currency` — код валюты платежав формате ISO-4217 alpha-3;
    -   `customer` — объект, содержащий сведения о пользователе:
        -   `id` — идентификатор пользователя, уникальный в рамках проекта;
        -   `ip_address` — IP-адрес пользователя, актуальный для инициируемого платежа.
    -   `return_url` — объект, содержащий URL для перенаправления пользователя в веб-сервис:
        -   `success` — URL для перенаправления пользователя после проведения оплаты.
    В зависимости от платёжного провайдера может требоваться указание и других параметров.

3.  Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации.

Таким образом, корректный запрос на оплату с применением метода Touch&Go должен содержать идентификатор проекта, базовые сведения о платеже \(идентификатор, сумму и код валюты\), идентификатор и IP-адрес пользователя, а также подпись.

```language-json
{
  "general": {
    "project_id": 210,
    "payment_id": "test_payment",
    "signature": "PJkV8ej\/UG0Di8hTng6JvipTv+AWoXW\/9MTO8yJA=="
  },
  "payment": {
    "amount": 50000,
    "currency": "MYR"
  },
  "customer": {
    "id": "customer123",
    "ip_address": "192.0.2.0"
  }
  "return_url": {
    "success": "http://example.com/success"
  }
}
```

```language-json
{
  "general": {
    "project_id": 210,
    "payment_id": "test_payment",
    "signature": "PJkV8ej\/UG0Di8hTng6JvipTv+AWoXW\/9MTO8yJA=="
  },
  "payment": {
    "amount": 50000,
    "currency": "MYR"
  },
  "customer": {
    "id": "customer123",
    "ip_address": "192.0.2.0"
  }
  "return_url": {
    "success": "http://example.com/success"
  }
}
```

### Формат промежуточных оповещений для перенаправления пользователей {#section_x23_cpg_vgb .section}

Для перенаправления пользователей от веб-сервиса мерчанта к сервису Touch&Go при проведении каждого платежа с использованием метода Touch&Go необходимо принять промежуточное оповещение от платёжной платформы и использовать информацию из него, включённую в объект `redirect_data`. Формат таких оповещений является типовым \([подробнее](ru_platform_callbacks.md#)\), при этом в состав объекта `redirect_data` включаются следующие объекты и параметры:

-   `body` — объект с данными для отправки в теле запроса к сервису провайдера;
-   `method` — параметр с указанием HTTP-метода отправки запроса\(`GET` или `POST`\);
-   `url` — параметр со ссылкой для перенаправления.

Дополнительно в состав объекта `redirect_data` может включаться параметр `encrypted` со служебной информацией.

```language-json
  "redirect_data": {
    "method": "POST",
    "body": {
        "MerchantCode": "M123456",
        "TransNum": "1234567887654321",
        "Currency": "MYR",
        "Amount": "5.00",
        "PaymentDesc": "payment",
        "FirstName": "John Doe",
        "Country": "MYS",
        "TransProvider": "123",
        "Signature": "5dd1b37842380d37ac87d37dea0bf112b3d0c3ac4078d2fbaa692d073a"
    },
    "encrypted": [],
    "url": "https://www.example.com/pay"
}
```

### Формат итоговых оповещений {#section_wsx_3jl_ggb .section}

Для итоговых оповещений об оплатах с применением метода Touch&Go используется типовой формат, описание которого представлено в статье [Работа с оповещениями](ru_platform_callbacks.md#).

В следующем примере оповещение свидетельствует о том, что в рамках проекта `1234` для пользователя была проведена оплата в размере `500,00 MYR`.

```language-json
{
    "project_id": 1234,
    "payment": {
        "id": "payment_47",
        "type": "purchase",
        "status": "success",
        "date": "2022-03-25T11:08:45+0000",
        "method": "Touchngo Wallet",
        "sum": {
            "amount": 50000,
            "currency": "MYR"
        },
        "description": ""
    },
    "customer": {
        "id": "customer_123"
    },
    "operation": {
        "id": 28,
        "type": "sale",
        "status": "success",
        "date": "2022-03-25T11:08:45+0000",
        "created_date": "2022-03-25T11:08:05+0000",
        "request_id": "9e32835fb27907e0e36c5117242b5cf60a4e17839",
        "sum_initial": {
            "amount": 50000,
            "currency": "MYR"
        },
        "sum_converted": {
            "amount": 50000,
            "currency": "MYR"
        },
        "code": "0",
        "message": "Success",
        "provider": {
            "id": 0000,
            "payment_id": "123abc123-321",
            "auth_code": ""
        }
    },
    "signature": "U7HQO7ToISZhMPKdMuHp99rHrtaxFvoB3cs9CRd4xeYG2Q=="
}
```

В следующем примере оповещение свидетельствует об отклонённой оплате.

```language-json
{
    "project_id": 1234,
    "payment": {
        "id": "payment_47",
        "type": "purchase",
        "status": "decline",
        "date": "2022-03-25T11:20:30+0000",
        "method": "Touchngo Wallet",
        "sum": {
            "amount": 50000,
            "currency": "MYR"
        },
        "description": ""
    },
    "customer": {
        "id": "customer_123"
    },
    "operation": {
        "id": 31,
        "type": "sale",
        "status": "decline",
        "date": "2022-03-25T11:20:30+0000",
        "created_date": "2022-03-25T11:19:53+0000",
        "request_id": "fff3d5f8d5d31bc460b68b57dc63f4b482e906eb",
        "sum_initial": {
            "amount": 50000,
            "currency": "MYR"
        },
        "sum_converted": {
            "amount": 50000,
            "currency": "MYR"
        },
        "code": "20000",
        "message": "General decline",
        "provider": {
            "id": 0000,
            "payment_id": "0cf4215c-8978",
            "auth_code": ""
        }
    },
    "signature": "J7W15rkqrLzTCD4Hko55iFYv58P4VnHANu445/jmY+g=="
}
```

### Дополнительные материалы {#section_xsx_3jl_ggb .section}

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

-   [Организация взаимодействия](ru_gate_interaction_organisation.md#)— о том, как взаимодействовать с платёжной платформой через Gate.
-   [Работа с подписью к данным](ru_platform_signature.md#)— о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
-   [Проведение платежей](ru_platform_payment_model.md)— о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
-   [Разовая оплата в одну стадию](ru_platform_sms_model.md)— о том, как проводить разовые оплаты через Gate.
-   [Работа с информацией об операциях](ru_platform_payment_info_codes.md)— о служебных кодах, используемых в платёжной платформе для фиксации информации о выполнении операций.

## Выплаты через Gate {#ru_pm_touchngo_gate_payout}

### Общая информация {#section_lsx_3jl_ggb .section}

Для проведения выплаты через Gate с использованием метода Touch&Go со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL Ecommpay и принять оповещение о результате.Полная схема проведения выплаты выглядит следующим образом.

![](images/pm/ru_touchngo_uml_gate_payout.svg)

1.  Пользователь на стороне веб-сервиса инициирует выплату через Touch&Go.
2.  От веб-сервиса на заданный URL Ecommpay передаётся запрос на проведение выплаты через Gate.
3.  Запрос на проведение выплаты поступает в платёжную платформу.
4.  В платёжной платформе выполняется приём запроса с проверкой наличия обязательных параметров и корректной подписи.
5.  От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности. Подробнее — в разделе [Формат ответа](ru_gate_interaction_organisation.md#).
6.  В платёжной платформе обеспечиваются дальнейшая обработка запроса \(с проверкой согласованности параметров\) и его отправка в сервис провайдера.
7.  В сервисе провайдера выполняется обработка выплаты.
8.  От сервиса провайдера к платёжной платформе направляется информация о результате выплаты.
9.  От платёжной платформы к веб-сервису направляется оповещение о результате выплаты.
10. На стороне веб-сервиса обеспечивается информирование пользователя о результате выплаты.

Информация о форматах запросов и оповещений, используемых для проведения выплат методом Touch&Go через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье [Организация взаимодействия](ru_gate_interaction_organisation.md#).

### Формат запросов {#section_osx_3jl_ggb .section}

При работе с запросами на выплаты с применением метода Touch&Go необходимо учитывать следующее:

1.  Для инициирования каждой выплаты должен использоваться отдельный POST-запрос к конечной точке `/v2/payment/wallet/touchngo/payout`. Эта точка относится к группе [/v2/payment/wallet/\{payment\_method\}/payout](https://api-developers.ecommpay.com/api-specification/wallet/post-v2-payment-wallet-payment-method-payout).
2.  В каждом запросе должны использоваться следующие объекты и параметры:

    -   `general` — объект, содержащий основные идентификационные сведения запроса:
        -   `project_id` — идентификатор проекта, полученный от Ecommpay при интеграции;
        -   `payment_id` — идентификатор платежа, уникальный в рамках проекта;
        -   `signature` — подпись запроса, составленная после указания всех целевых параметров \(подробнее — в разделе [Работа с подписью к данным](ru_platform_signature.md#)\);
    -   `payment` — объект, содержащий сведения о платеже:
        -   `amount` — сумма выплаты в дробных единицах валюты;
        -   `currency` — код валюты платежав формате ISO-4217 alpha-3;
    -   `customer` — объект, содержащий сведения о пользователе:
        -   `id` — идентификатор пользователя, уникальный в рамках проекта;
        -   `ip_address` — IP-адрес пользователя, актуальный для инициируемой выплаты;
    -   `account` — объект, содержащий сведения о счёте пользователя:
        -   `number` — номер счёта.
    В зависимости от платёжного провайдера может требоваться указание и других параметров.

3.  Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации.

Таким образом, корректный запрос на выплату с применением метода Touch&Go должен содержать идентификатор проекта, базовые сведения о платеже \(его идентификатор, сумму и код валюты\), идентификатор и IP-адрес пользователя, номер счёта и подпись.

```language-json
{
  "general": {
    "project_id": 210,
    "payment_id": "test_payment",
    "signature": "PJkV8ej\/UG0Di8hTng6JvipTv+AWoXW\/9MTO8yJA=="
  },
  "payment": {
    "amount": 50000,
    "currency": "MYR"
  },
  "customer": {
    "id": "customer123",
    "ip_address": "192.0.2.0"
  },
  "account": {
    "number": "00004598"
  }
}
```

```language-json
{
  "general": {
    "project_id": 210,
    "payment_id": "test_payment",
    "signature": "PJkV8ej\/UG0Di8hTng6JvipTv+AWoXW\/9MTO8yJA=="
  },
  "payment": {
    "amount": 50000,
    "currency": "MYR"
  },
  "customer": {
    "id": "customer123",
    "ip_address": "192.0.2.0"
  },
  "account": {
    "number": "00004598"
  }
}
```

### Формат оповещений {#section_wsx_3jl_ggb .section}

Для оповещений о результатах выплат с применением метода Touch&Go используется типовой формат, описание которого представлено в разделе [Работа с оповещениями](ru_platform_callbacks.md#).

В следующем примере оповещение свидетельствует о том, что в рамках проекта `1234` для пользователя была проведена выплата в размере `500,00 MYR`.

```language-json
{
    "project_id": 1234,
    "payment": {
        "id": "payment_48",
        "type": "payout",
        "status": "success",
        "date": "2022-03-25T11:08:45+0000",
        "method": "Touchngo Wallet",
        "sum": {
            "amount": 50000,
            "currency": "MYR"
        },
        "description": ""
    },
    "customer": {
        "id": "customer_123"
    },
    "account": {
        "number": "123456"
    },
    "operation": {
        "id": 29,
        "type": "payout",
        "status": "success",
        "date": "2022-03-25T11:08:45+0000",
        "created_date": "2022-03-25T11:08:05+0000",
        "request_id": "9e32835fb27900e336c5117242b5cf60a4e17839",
        "sum_initial": {
            "amount": 50000,
            "currency": "MYR"
        },
        "sum_converted": {
            "amount": 50000,
            "currency": "MYR"
        },
        "code": "0",
        "message": "Success",
        "provider": {
            "id": 0000,
            "payment_id": "123abc123-123",
            "auth_code": ""
        }
    },
    "signature": "U7HQO7ToISZhMPKdMaxkUKQtoYzFvoB3cs9CRd4xeYG2Q=="
}
```

В следующем примере оповещение свидетельствует об отклонённой выплате.

```language-json
{
    "project_id": 1234,
    "payment": {
        "id": "payment_48",
        "type": "payout",
        "status": "decline",
        "date": "2022-03-25T11:20:30+0000",
        "method": "Touchngo Wallet",
        "sum": {
            "amount": 50000,
            "currency": "MYR"
        },
        "description": ""
    },
    "customer": {
        "id": "customer_123"
    },
    "account": {
        "number": "123456"
    },
    "operation": {
        "id": 29,
        "type": "payout",
        "status": "decline",
        "date": "2022-03-25T11:20:30+0000",
        "created_date": "2022-03-25T11:19:53+0000",
        "request_id": "fff3d5f8d5d31bc460b68b57dc63f4b482e906eb",
        "sum_initial": {
            "amount": 50000,
            "currency": "MYR"
        },
        "sum_converted": {
            "amount": 50000,
            "currency": "MYR"
        },
        "code": "20000",
        "message": "General decline",
        "provider": {
            "id": 0000,
            "payment_id": "123abc123-123",
            "auth_code": ""
        }
    },
    "signature": "J7W15rkqrLzTC4m8C4z2iFYv58P4VnHANu445/jmY+g=="
}
```

### Дополнительные материалы {#section_xsx_3jl_ggb .section}

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

-   [Организация взаимодействия](ru_gate_interaction_organisation.md#)— о том, как взаимодействовать с платёжной платформой через Gate.
-   [Работа с подписью к данным](ru_platform_signature.md#)— о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
-   [Проведение платежей](ru_platform_payment_model.md)— о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
-   [Выплаты](ru_Gate_payout.md)— о том, как проводить выплаты через Gate.
-   [Работа с информацией об операциях](ru_platform_payment_info_codes.md)— о служебных кодах, используемых в платёжной платформе для фиксации информации о выполнении операций.

## Выплаты через Dashboard {#ru_pm_dash_payout}

При использовании интерфейса Dashboard можно проводить *одиночные* и *массовые*выплатыметодом Touch&Go с единичной и пакетной отправкой запросов, называемые соответственно *одиночными* и *массовыми*.

-   Для проведения одиночной выплаты необходимо открыть форму выплаты, задать все необходимые параметры \(включая метод\), отправить запрос и убедиться в проведении выплаты.
-   Для проведения массовой выплаты необходимо подготовить и загрузить файл с информацией обо всех целевых выплатах, отправить пакет запросов и убедиться в проведении выплат.

    При этомдолжен использоваться файл формата CSV, структура которого соответствует требованиям, представленным в разделе [Сведения о массовых платежах](ru_dbl_payments.md#), а параметры выплат— требованиям, представленным в разделе [Выплаты через Gate](pm_touchngo.md#) этой статьи \(за исключением пункта о подписи\).


Более подробная информация о проведении выплат через Dashboard представлена в [отдельной статье](ru_dbl_payments.md#).

## Анализ результатов проведения платежей {#ru_pm_touchngo_dash_analysis}

Для анализа информации о платежах и операциях, как в отдельности по методу Touch&Go, так и в совокупности с другими методами, можно использовать:

-   инструментарийинтерфейса Dashboard, с различными реестрами и аналитическими панелями;
-   отчёты в формате CSV, выгружаемые\(как разово, так и периодически\) черезраздел **Отчёты** интерфейса Dashboard;
-   данные в формате JSON, получаемыепо программным запросам черезинтерфейс Data API.

С вопросами по анализу информации можно обращаться к разделам документации \([Dashboard](ru_dbl_about.md) и [Использование Data API](ru_dbl_api_protocol.md)\) и специалистам Ecommpay.