AcquiredHppSDK 1.2.1

AcquiredHppSDK 1.2.1

Acquired维护。



  • Acquired

AcquiredHppSDK

CI Status >Version License Platform

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 设置,您可以在获取仪表板(服务器端)上获取这些设置。

  1. 公司 ID:利用获得的 HPP 服务器 SDK,公司 ID 是创建 HppSetting 实例的必要条件,而 HppSetting 是 HPPManager 所必需的。

  2. 公司 MID ID:使用此值,SDK 将选择通过获取仪表板(Acquired Dashboard)上传的默认模板。

  3. 哈希码:此参数用于编码 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 文件。