Android

创建 SDK 实例的过程包含以下步骤：

1. 创建configuration对象：必传，Object类型。包含所有配置参数：
   • ​setLocale: 选传，String类型。商户客户端识别用户浏览器使用的语言种类，并传入浏览器语言信息，SDK 根据此信息提供对应语言的页面。目前 SDK 支持以下 3 种多语言，如果传入的值不是以下 3 种，将提供英语页面：
     • locale("en", "US")：英语
     • locale("in", "ID")：印尼语
     • locale("th", "TH")：泰语
   • setOption: 选传，用于设置是否采用默认loading样式以及是否使用沙箱环境，支持的值包括：
     • "sandbox", "true"：沙箱环境
     • "sandbox", "false"：生产环境
     • "showLoading", "true"：使用默认 loading 样式
     • "showLoading", "false"：不使用默认 loading 样式
2. 创建 onCheckoutListener 接口的实例，用于后续流程中对应事件发生时的处理，包含以下方法：
   • onEventCallback: 必传。收银台支付事件回调函数，返回事件码（eventCode）和事件具体信息（eventResult）。
3. 将 onCheckoutListener 接口的实例设置到 configuration 实例中，用于执行事件回调。
4. 实例化AMSCashierPayment。

商户客户端自行监听支付按钮的点击事件。当买家选择支付方式并点击支付按钮后，商户服务端向 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() 并传入以下参数:

• activity: 必传。Activity 类型的一个对象，用于包含当前页面的上下文参数信息。
• sessionData：必传。String类型。将步骤 4 获取的的 paymentSessionData 字段的完整数据传入 createComponent 的 sessionData 参数。

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

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