AcquiredHppSDK
Acquired iOS库
需求
- IOS 9.0+
- Xcode 10.0+
HPP库安装
安装
AcquiredHppSDK通过CocoaPods提供。要安装它,只需在Podfile中添加以下行:
target 'AcquiredSample' do
pod 'AcquiredHppSDK', :git => 'https://github.com/AcquiredSupport/AcquiredHppSDK.git', :branch =>'master'
end
//AcquiredSample is your original xcode peoject name
或者
pod 'AcquiredHppSDK','1.1.2'
如果使用Swift,请确保在Podfile中添加此行。
use_frameworks!
使用 HPP 库
启动
要初始化 HPPManager 实例,请执行以下操作
let hppManager = HppManager()
与您的服务器集成
HPPManager 需要一些 HPP 设置,您可以在获取仪表板(服务器端)上获取这些设置。
-
公司 ID:利用获得的 HPP 服务器 SDK,公司 ID 是创建 HppSetting 实例的必要条件,而 HppSetting 是 HPPManager 所必需的。
-
公司 MID ID:使用此值,SDK 将选择通过获取仪表板(Acquired Dashboard)上传的默认模板。
-
哈希码:此参数用于编码 HPP 的请求,将生成一个新的哈希码,服务器端将检查哈希码的有效性并解码响应。
let hppSetting = HppSetting(companyId:211, companyMidId:1229, companyHash:""hashcode")
显示支付表单
插入以下代码以显示支付表单
hppManager.loadHppView(viewController: self, hppSetting: hppSetting)
执行此代码后,HPPManager 将处理给定的参数(HppSetting),从服务器获取请求,将编码请求发送到 HPP 并显示接收到的表单。
HPP 响应
在服务器端,您可以设置自己的返回 URL 或回调 URL,HPP 会自动处理响应,因此您不需要在您的应用中进行任何响应处理。您也可以在您的应用中调用 HPPManager 时设置另一个返回 URL 或回调 URL。
hppSetting.error_url = "xxx"
hppSetting.return_url = "xxx"
hppSetting.merchant_customer_id = "xxx"
FAQ
设置 HPP 属性
HppSetting 用于提供服务器所需的所有参数:卡详情、收货地址、账单地址等。您还可以在组件中设置所需的任何 HPP 属性,例如;
hppSetting.is_debug = true
hppSetting.transaction_type = "AUTH_ONLY"
hppSetting.currency_code_iso3 = "GBP"
hppSetting.amount = 100.1
hppSetting.billing_email = "xxx"
hppSetting.customer_company = "xxx"
...
这些将被发送到 请求生产者 URL,您必须确保服务器端代码配置正确,接收这些值并将它们传递给 HPP 服务器端 SDK,以便在请求中包含这些值。
测试
Acquired 为实时和测试交易维护独立的端点。使用以下代码
hppSetting.is_debug = true
许可证
AcquiredHppSDK 在 MIT 许可下可用。有关更多信息,请参阅 LICENSE 文件。