«Мобильная коммерция в Казахстане» - Оплата

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

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

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

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

Запрос

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

Вот пример параметров из запроса на открытие страницы оплаты с использованием виджета EPayWidget:

EPayWidget.run(
	{
		project_id: 1234,
		payment_id: 'payment_47',
		customer_id: 'customer_123',
		customer_first_name: 'John',
		customer_last_name: 'Doe',
		customer_email: 'johndoe@example.com',
		payment_currency: 'KZT',
		payment_amount: 100000,
		force_payment_method: 'mobile',
		signature: 'kUi2x9dKHAVNU0FYldJrxh4yo+52Kt8KU+Y19vySO/RLUkDJrOcZzUCwX6R/ekpZhkIQg=='
	}
)

Вы можете предварительно выбрать для пользователя оператора связи на странице оплаты. Для этого добавьте в запрос на открытие страницы оплаты параметры:

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

EPayWidget.run(
	{
		project_id: 1234,
		payment_id: 'payment_47',
		customer_id: 'customer_123',
		customer_first_name: 'John',
		customer_last_name: 'Doe',
		customer_email: 'johndoe@example.com',
		payment_currency: 'KZT',
		payment_amount: 100000,
		force_payment_method: 'mobile',
		payment_methods_options: {"enable_mobile_service": 1, "selected_operator": "TELE2"},  
		signature: 'kUi2x9dKHAVNU0FYldJrxh4yo+52Kt8KU+Y19vySO/RLUkDJrOcZzUCwX6R/ekpZhkIQg=='
	}
)

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

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

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

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

{
    "project_id": 1234,
    "payment": {
        "id": "payment_47",
        "type": "purchase",
        "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": "sale",
        "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": "purchase",
        "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": "sale",
        "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=="
}

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

• Общий порядок интеграции
• Типы платежей, операции и платежи
• Подписывание и проверка подписи
• Статусы операций и коды ответов

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

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

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

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

Запрос

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

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

{
    "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
    }
}

Отправка OTP-кода в платежную платформу

Введенный пользователем OTP-код вы должны отправить в платежную платформу в новом запросе. Далее приведены основные характеристики и параметры такого запроса.

Вот пример данных из запроса для передачи в платежную платформу OTP-кода:

{
    "general": {
        "project_id": 1234,
        "payment_id": "payment_47",
        "signature": "kUi2x9dKHAVNU0FYldJrxh4yo+52Kt8KU+Y19vySO/RLUkDJrOcZzUCwX6R/ekpZhkIQg=="
    },
    "additional_data": {
        "additional_data": {
            "approval_code": "123456"
        }
    }
}

Чтобы оператор связи своевременно подтвердил платеж, отправляйте платежной платформе запрос с OTP-кодом в течение 80 или 90 секунд с момента получения от платежной платформы оповещения о необходимости передачи OTP-кода (точный срок действия OTP-кода для вас уточняйте у своего курирующего менеджера в Rocketpay).

При отправке этого запроса проведение платежа может продолжаться следующим образом:

• Если OTP-код правильный и отправлен своевременно, то проведение платежа продолжается на стороне платежной платформы, сервиса провайдера и сервиса оператора связи, после чего платежная платформа отправляет вашей системе итоговое оповещение.
• Если OTP-код отправлен своевременно, но не является правильным, то платежная платформа повторно отправляет вашей системе оповещение о необходимости передачи OTP-кода. В этом случае предоставьте пользователю возможность повторно ввести правильный OTP-код, после чего отправьте платежной платформе запрос с этим OTP-кодом (также до истечения исходных 80 или 90 секунд).

Если OTP-код отправлен после истечения 80 или 90 секунд, то возможны следующие варианты:

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

Запрос на повторную отправку OTP-кода пользователю

Вы можете запросить повторную отправку OTP-кода пользователю спустя 80 или 90 секунд с момента формирования OTP-кода на стороне оператора связи (точный срок действия OTP-кода для вас уточняйте у своего курирующего менеджера в Rocketpay).

Чтобы запросить повторную отправку OTP-кода пользователю, отправьте платежной платформе запрос. Далее приведены основные характеристики и параметры такого запроса.

Вот пример данных из запроса на повторную отправку OTP-кода пользователю:

{ 
     "general": { 
	    "project_id": 1234,
	    "payment_id": "payment_47",
	    "signature": "PJkV8ej/UG0Di8hTng6JvC7vQsaC6tajQVVfBaNIipTv+AWoXW/9MTO8yJA=="
	},
	"customer": {
	    "ip_address": "198.51.100.47"
	} 
}

Вы можете запросить повторную отправку OTP-кода пользователю не более трех раз в рамках одного платежа. При этом срок действия каждого нового OTP-кода, как и в случае с первым OTP-кодом, составляет 80 или 90 секунд с момента формирования OTP-кода на стороне оператора связи (точный срок действия OTP-кода для вас уточняйте у своего курирующего менеджера в Rocketpay).

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

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

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

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

{
    "project_id": 1234,
    "payment": {
        "id": "payment_47",
        "type": "purchase",
        "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": "sale",
        "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": "purchase",
        "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": "sale",
        "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=="
}

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

• Общий порядок интеграции
• Типы платежей, операции и платежи
• Подписывание и проверка подписи
• Статусы операций и коды ответов

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

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

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

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

Запрос

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

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

{
    "general": {
        "project_id": 1234,
        "payment_id": "payment_47",
        "signature": "kUi2x9dKHAVNU0FYldJrxh4yo+52Kt8KU+Y19vySO/RLUkDJrOcZzUCwX6R/ekpZhkIQg=="
    },
    "payment": {
        "currency": "KZT",
        "amount": 100000,
        "description": "Возврат."
    }
}

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

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

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

{
    "project_id": 1234,
    "payment": {
        "id": "payment_47",
        "type": "purchase",
        "status": "refunded",
        "date": "2024-12-07T19:08:45+0000",
        "method": "mobile",
        "sum": {
            "amount": 0,
            "currency": "KZT"
        },
        "description": ""
    },
    "customer": {
        "id": "customer_123"
    },
    "operation": {
        "id": 47,
        "type": "refund",
        "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": "purchase",
        "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": "refund",
        "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=="
}

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

• Синхронная и асинхронная обработка запросов
• Типы платежей, операции и платежи
• Подписывание и проверка подписи
• Статусы операций и коды ответов