iOS

• 初始化收银台实例，包含以下参数：
  • configuration：必传，AMSCashierPaymentConfiguration 类型的一个对象，包含所有配置参数。
• 创建 AMSCashierPaymentConfiguration 类，包含以下参数：
  • ​​locale: 选传，NSString 类型。商户客户端识别用户浏览器使用的语言种类，并传入浏览器语言信息，SDK 根据此信息提供对应语言的页面。目前 SDK 支持以下 3 种多语言，如果传入的值不是以下 3 种，将提供英语页面：
    • en_US：英语
    • in_ID：印尼语
    • th_TH：泰语
  • options: 选传，NSDictionary 类型，用于设置是否采用默认loading样式以及是否使用沙箱环境，支持的值包括：
    • "sandbox", "true"：沙箱环境
    • "sandbox", "false"：生产环境
    • "showLoading", "true"：使用默认 loading 样式
    • "showLoading", "false"：不使用默认 loading 样式
• 实现 AMSPaymentProtocol 的协议，用于后续流程中对应事件发生时的处理，包含以下方法：
  • onEventCallback：收银台支付事件回调函数，返回事件码（eventCode）和事件具体信息（eventResult）。
• 实现 AMSLoggerProtocol 的协议，用于管理日志输出，包含以下方法：
  • logWithName：默认输出日志的回调函数。

商户客户端自行监听支付按钮的点击事件。当买家选择支付方式并点击支付按钮后，商户服务端向 Alipay 服务器发起 支付会话创建 请求。一旦接收到 支付会话创建 请求的响应，将响应中的 paymentSessionData 值用于步骤五。您需要在请求中传入以下参数：

• paymentRequestId：商户侧支付宝的交易号。

• productCode：产品码，传入固定值  CASHIER_PAYMENT。

• paymentNotifyUrl：支付结果通知地址。

• paymentRedirectUrl：支付完成后回跳的商家结果页地址
• paymentAmount：需要向买家收取的支付金额
• order.orderAmount: 商家侧的订单金额。若出现促销打折，orderAmount金额可能不等于 paymentAmount。
• order.orderDescription: 订单描述
• order.referenceOrderId: 商户侧自己的订单号。若商家侧一笔订单存在多次请求支付宝支付的情况下，referenceOrderId和paymentRequestId建议是一对多的关系。
• paymentMethod.paymentMethodType:指定为 BANK。
• paymentMethod.paymentMethodMetaData：
  • 若集成单一银行模式，则指定 bankName 为银行名称。
  • 若集成银行类型聚合模式，则指定 paymentMethodCaregory 为支付方式类型。有效值为  BANK_TRANSFER、MOBILE_BANKING_APP和ONLINE_BANKING。
  • 若集成国家聚合模式，则指定 paymentMethodRegion 为国家。有效值为 TH 和 ID。

使用实例对象中的 createComponent:

• 使用 sessionData 参数创建配置对象: 将步骤 4 获取的  paymentSessionData 字段的完整数据传入 createComponent 的 sessionData 参数。
• 调用 createComponent() 函数初始化 SDK。

调用实例对象中的 onDestroy() 函数进行 SDK 组件的资源回收，请在以下两种场景中调用：

• 用户退出支付页面时，需要回收 支付会话创建 中的组件资源。
• 用户发起多笔支付时，需要回收上一次 支付会话创建 中的组件资源。