Плагин Lantu Union Pay для Cordova

A. Введение

Интеграция с платёжными инструментами UnionPay:

• Android-версия платёжного инструмента (3.4.5);
• iOS-версия платёжного инструмента (3.3.11).

F. Установка

cordova plugin add https://gitee.com/lantutech/lantu-union-pay.git

J. API

— cordova.plugins.LantuUnionPay.pay; — cordova.plugins.LantuUnionPay.isUnionAppInstalled.

L. Использование

L.1 Платёжный API

cordova.plugins.LantuUnionPay.pay(options, success, error);

L.2 Параметры платёжного API

- {Object} options:

• {String} tn — номер транзакции UnionPay (используется в платёжном пространстве);
• {String} [mode] — режим оплаты, «00» представляет собой подключение к рабочей среде (требуется официальная версия), «01» представляет собой подключение к среде разработки и тестирования (требуется тестовая версия);
• {String} [scheme] — схема ios для хост-приложения, обычно не передаётся.

- {Function} success: обратный вызов при успешной оплате:

function success(payResult){ 
/**
 * Результат оплаты
 * @type { Object } payResult
 * @property { String } code результат оплаты, возможные значения: «success», «fail», «cancel»
 * @property { successPaySignData } [successExtraData] возвращается только при успешном выполнении
 */
payResult;

/**
 * Дополнительные данные миграции (рекомендуется не обрабатывать на стороне клиента, просто игнорировать)
 * @typedef { Object } successPaySignData
 * @property { String } sign данные после подписи в формате Base64
 * @property { String } data данные, используемые для подписи, структура: pay_result=success&tn=899394085660622736701&cert_id=68759585097
 */
}

- {Function} error: обратный вызов в случае сбоя оплаты:

function error(payResult){ 

/**
 * Результат оплаты
 * @type { Object } payResult
 * @property { String } code результат оплаты, возможные значения: «fail», «cancel»
 */
payResult;
}

Пример:

cordova.plugins.LantuUnionPay.pay({
// Можно использовать поддельные номера UnionPay для тестирования: http://101.231.204.84:8091/sim/getacptn
tn: "539872438627557871701"
}, (payResult) => {
const { code, successPaySignData } = payResult;
alert(`Оплата прошла успешно ${ code } !`);
console.log("Возвращается только при успешном выполнении: ", successPaySignData);
}, (payResult) => {
const { code } = payResult;
alert(`Ошибка оплаты ${ code }`);
});

L.2 Проверка наличия облачного приложения UnionPay

cordova.plugins.LantuUnionPay.isUnionAppInstalled(callback);

L.3 Параметры

- {Function} callback: успешный обратный вызов:

function callback(isInstalled){ 

/**
 * Установлено ли приложение
 * @type { Boolean } isInstalled
 */
isInstalled;
}

N. Примечания

Механизм возврата результатов оплаты в приложении на iOS

Платёжные инструменты используют протокол обратного вызова URL Types для взаимодействия с приложением. Поэтому необходимо настроить параметры info.plist для URL TYPES в Xcode. Плагин lantu-union-pay автоматически выполняет эту настройку при установке. По умолчанию используется значение lantumcampusunionpay.

Если требуется изменить этот параметр, можно указать пользовательское значение при установке плагина, например:

cordova plugin add https://gitee.com/lantutech/lantu-union-pay.git --variable UNION_PAY_URL=YourCustomizedUrl

X. Список задач

• Объяснить результаты установки плагина cordova-android@7.x и cordova-android@8.x в проект.
• Предоставить параметр scheme variable при установке на iOS.
• Обеспечить совместимость с cordova-android@7 и cordova-android@8.
• Дополнить недостающие зависимости в файле pkg.json.

Y. Журнал релизов

• v0.2.4:

  • Исправлена проблема сбоя после успешной оплаты на iOS при установленном облачном приложении UnionPay.

• v0.2.3:

  • Добавлена возможность указывать пользовательский параметр UNION_PAY_URL при установке плагина.
  • Исправлено некорректное получение результатов обратного вызова оплаты.

• v0.2.2:

  • Реализованы основные методы оплаты для Android и iOS, а также проведено тестирование на платформах cordova@8, cordova-android@6.4.1 и cordova-ios@4.5.4.