Выплата

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

Регионы использования Казахстан
Валюты выплаты KZT
Суммы платежей Информацию уточняйте у курирующего менеджера Rocketpay. Также вы можете уточнить в Dashboard минимальную и максимальную сумму платежа, доступную в вашем проекте.
Конвертация валют На стороне Rocketpay
Возврат
Организация и стоимость подключения По согласованию с курирующим менеджером Rocketpay

Основные операции

  Интерфейсы Время проведения платежа
Payment Page Gate Dashboard базовое предельное
Выплата * *

* Информацию уточняйте у курирующего менеджера Rocketpay.

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

Далее подробно рассказывается, что вам нужно делать для проведения платежа, а также о возможностях анализа уже проведенных платежей.

Поддержка со стороны операторов связи

Выплата в методе «Мобильная коммерция в Казахстане» осуществляется через сервисы операторов связи, перечисленных в таблице ниже:

Табл. 1. Поддерживаемые операторы связи
Оператор связи Идентификатор
«Билайн» BEELINE
Activ ACTIV
Altel ALTEL
Kcell KCELL
Tele2 TELE2

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

HTTP-метод запроса POST
Формат тела запроса JSON
Конечная точка /v2/info/mobile/payout/list
Полная спецификация конечной точки /v2/info/mobile/{operation_type}/list
Табл. 2. Базовые параметры запроса доступных операторов связи
Объект Параметр Описание
general

project_id
integer strictly required

 Идентификатор проекта, полученный от Rocketpay при интеграции.

signature
string strictly required

 Подпись запроса, составленная после определения всех параметров запроса. Подробнее о составлении подписи см. Использование подписи к данным.

Вот пример данных из запроса списка операторов связи, поддерживающих работу с методом «Мобильная коммерция в Казахстане».

Рис.: Пример данных из запроса доступных операторов связи

{
	"general": {
	    "project_id": 1234,
	    "signature": "K6jllym+PtObocZtr345st...=="
	}
}

Выплата через Gate

Общая информация

Чтобы выполнить выплату через Gate с использованием метода «Мобильная коммерция в Казахстане»:

  1. Отправьте запрос с нужными параметрами и подписью на рабочий URL-адрес платежной платформы Rocketpay.
  2. Примите от платежной платформы Rocketpay оповещение (callback) с результатом выплаты.

Полная схема выплаты с использованием метода «Мобильная коммерция в Казахстане» выглядит следующим образом.



Рис.: Здесь описаны шаги выплаты через Gate

  1. Пользователь инициирует выплату с использованием метода «Мобильная коммерция в Казахстане» в вашей системе.
  2. Ваша система передает запрос на выплату в Gate.
  3. Платежная платформа получает запрос.
  4. Платежная платформа проверяет наличие обязательных параметров и корректной подписи в запросе.
  5. Платежная платформа отправляет вам ответ с информацией о получении запроса и о результате проверки его корректности. (Подробнее о формате ответа см. Ответ.)
  6. Платежная платформа обрабатывает запрос и отправляет его в сервис провайдера.
  7. Сервис провайдера обрабатывает запрос на выплату.
  8. Сервис провайдера оповещает платежную платформу о результате выплаты.
  9. Платежная платформа отправляет вам оповещение (callback) с результатом выплаты.
  10. Ваша система направляет пользователю информацию о результате выплаты.

Запрос

Далее представлена информация, необходимая для создания и отправки запроса на выплату с использованием метода «Мобильная коммерция в Казахстане».

HTTP-метод запроса POST
Формат тела запроса JSON
Конечная точка /v2/payment/mobile/payout
Табл. 3. Базовые параметры запроса на выплату

strictly required — параметр обязательно должен присутствовать в начальном запросе.
Объект Параметр Описание

general
object
strictly required

project_id
integer
strictly required

 Идентификатор проекта, полученный от Rocketpay при интеграции.

Пример: 1234

payment_id
string
strictly required

 Идентификатор платежа, уникальный в рамках проекта.

Пример: payment_47

signature
string
strictly required

 Подпись запроса, составленная после определения всех параметров запроса. Подробнее о составлении подписи см. Использование подписи к данным.

customer
object
strictly required

id
string
strictly required

 Идентификатор пользователя, уникальный в рамках проекта.

Пример: customer_123

ip_address
string
strictly required

 IP-адрес устройства пользователя.

Пример: 198.51.100.47

first_name
string
strictly required

 Имя пользователя.

Пример: John

last_name
string
strictly required

 Фамилия пользователя.

Пример: Doe

email
string
strictly required

 Адрес электронной почты пользователя.

Пример: johndoe@example.com

account
object
strictly required

number
string
strictly required

 Номер телефона пользователя, на счет мобильной связи которого совершается выплата. Указывается с кодом страны, без знаков пунктуации и специальных символов.

Пример: 71234567890

payment
object
strictly required

currency
string
strictly required

 Код валюты платежа в формате ISO-4217 alpha-3.

Пример: KZT

amount
integer
strictly required

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

Если у валюты нет дробных единиц (то есть количество разрядов дробных единиц равно нулю), то в этом параметре нужно указывать сумму в основных единицах валюты. Подробнее о разрядах дробных единиц у валют см. Коды валют.

Пример: 1000,00 KZT передается как 100000
При необходимости добавьте в запрос необязательные параметры, указанные в спецификации Gate: API Reference.

Вот пример тела запроса на выплату с использованием метода «Мобильная коммерция в Казахстане»:

Рис.: Пример тела запроса на выплату

{
    "general": {
        "project_id": 1234,
        "payment_id": "payment_47",
        "signature": "kUi2x9dKHAVNU0FYldJrxh4yo+52Kt8KU+Y19vySO/RLUkDJrOcZzUCwX6R/ekpZhkIQg=="
    },
    "customer": {
        "id": "customer_123",
        "ip_address": "198.51.100.47",
        "first_name": "John",
        "last_name": "Doe",
        "email": "johndoe@example.com"
    },
    "account": {
        "number": "71234567890"
    },
    "payment": {
        "currency": "KZT",
        "amount": 100000
    }
}

Оповещение (callback)

В методе «Мобильная коммерция в Казахстане» результат выплаты платежная платформа возвращает в оповещении. Подробнее о структуре оповещений см. Оповещения (callbacks) в Gate.

В платежном методе «Мобильная коммерция в Казахстане» в оповещении дополнительно передается объект account с параметрами number и type, в которых содержится информация о номере телефона и операторе связи пользователя.

Вот пример тела оповещения с информацией об успешно выполненной выплате:

Рис.: Пример тела оповещения об успешной выплате

{
    "project_id": 1234,
    "payment": {
        "id": "payment_47",
        "type": "payout",
        "status": "success",
        "date": "2024-12-07T19:08:45+0000",
        "method": "mobile",
        "sum": {
            "amount": 100000,
            "currency": "KZT"
        },
        "description": ""
    },
    "customer": {
        "id": "customer_123"
    },
    "operation": {
        "id": 47,
        "type": "payout",
        "status": "success",
        "date": "2024-12-07T19:08:45+0000",
        "created_date": "2024-12-07T19:08:05+0000",
        "request_id": "1a23456bc7890de",
        "sum_initial": {
            "amount": 100000,
            "currency": "KZT"
        },
        "sum_converted": {
            "amount": 100000,
            "currency": "KZT"
        },
        "code": "0",
        "message": "Success",
        "provider": {
            "id": 12345,
            "payment_id": "123abc123-123",
            "auth_code": ""
        }
    },
    "account": {
        "number": "71234567890",
        "type": "TELE2"
    },
    "signature": "U7HQO7ToISZhMPKdM4XrUKQtoYzFvoB3cs9CRd4xeYG2Q=="
}

Вот пример тела оповещения с информацией об отклоненной выплате.

Рис.: Пример тела оповещения об отклоненной выплате

{
    "project_id": 1234,
    "payment": {
        "id": "payment_47",
        "type": "payout",
        "status": "decline",
        "date": "2024-12-07T19:08:45+0000",
        "method": "mobile",
        "sum": {
            "amount": 100000,
            "currency": "KZT"
        },
        "description": ""
    },
    "customer": {
        "id": "customer_123"
    },
    "operation": {
        "id": 47,
        "type": "payout",
        "status": "decline",
        "date": "2024-12-07T19:08:45+0000",
        "created_date": "2024-12-07T19:08:05+0000",
        "request_id": "1a23456bc7890de",
        "sum_initial": {
            "amount": 100000,
            "currency": "KZT"
        },
        "sum_converted": {
            "amount": 100000,
            "currency": "KZT"
        },
        "code": "20000",
        "message": "General decline",
        "provider": {
            "id": 12345,
            "payment_id": "123abc123-123",
            "auth_code": ""
        }
    },
    "account": {
        "number": "71234567890",
        "type": "TELE2"
    },
    "signature": "U7HQO7ToISZhMPKdM4XrUKQtoYzFvoB3cs9CRd4xeYG2Q=="
}

Дополнительные материалы

Выплата через Dashboard

Для проведения выплат через Dashboard со стороны мерчанта необходимо инициировать запросы на выплаты и принять уведомления об их успешной обработке. Инициировать такие выплаты можно двумя способами:
  • как единичную выплату — в этом случае для каждой выплаты необходимо указать доступные для данного метода валюту и сумму, выбрать метод и заполнить все поля, отображаемые в интерфейсе с учетом выбранного метода;
  • в рамках массового платежа — в этом случае все параметры выплат необходимо задать в файле формата CSV с учетом требований, представленных в разделе Выплаты через Gate (кроме пункта о подписи).

Информация о проведении выплат отображается в разделах Платежи и Мануальные платежи интерфейса Dashboard.

Более подробная информация о проведении выплат через Dashboard представлена в разделе Проведение выплат.