版本號

描述

生效時間

v1.4

反掃交易變更顯示備註於用户交易詳情頁

2024.11.01

v1.3

商户不能在老門户查看RSA2秘鑰

2024.10.14

v1.2

1. 預下單域名變更
2. SFTP賬單針對二級商戶名稱處理邏輯

2024.03.11

v1.1

1. 舊門戶交易結算數據存在不準確的情況，需要機構/商戶留意。強烈建議升級至新門戶做日常操作及信息查詢
2. 增加FAQ章節

2024.01.22

v1.0

初始版本

2023.12.12

類別

切流入網

A+錢包在香港的線下場景實現基本的支付

PID維度切流後即可入網A+

HK&CN錢包

A+錢包

A. 商戶門戶

A.1. 商戶賬號管理

A.1.1. 門戶登錄

不變機構/商戶仍然可以使用現有賬密登錄老門戶。 老門戶現有功能維持不變。但考慮到老門戶數據僅限HK&CN錢包的交易， A+錢包交易不可見，故建議機構/商戶後續使用新門戶。

升級新門戶已於2024年1月底正式上線，機構/商戶入網A+之後，可使用全新的門戶。

機構/商戶可以使用現有帳戶登錄新門戶，無需重新註冊。

*首次登陸新門戶需要重置密碼，並通過郵箱接收驗證碼。 請確保登錄郵箱可用且能夠接收驗證碼資訊

A.1.2. 合約確認

不變如有新合約簽署或變更，機構/商戶仍然可以在老門戶對合約確認

不適用由於本次A+錢包入網不需要額外簽約合約，故無需通過門戶確認合約

A.1.3. 帳號資訊更改，包括登入密碼，郵箱及付款密碼

不變機構/商戶仍然可以使用現有老門戶對賬號進行維護

*新老門戶的賬密不會自動同步，在老門戶上對帳戶資訊的更改不會影響新門戶的賬號資訊

不支持登錄新門戶的帳號信息暫時不支援機構/商戶自助更改。 如有更改需要，請聯繫 HKMerchant@alipay.com

*新老門戶的賬密不會自動同步，對新門戶上帳戶資訊的更改不會影響老門戶

不支持登錄新門戶的帳號信息暫時不支持設置安全郵箱

*門戶系統功能將陸續更新，升級后將支援該能力。

A.1.4. 查看/更改密鑰資訊

變更機構/商戶不能在老門戶進行查看或更改RSA2秘鑰資訊。

*如需查看/更改請聯繫 AlipayHMTtechsupport@service.alipay.com

不支持新門戶暫時不支援對秘鑰進行查看或更改。 如需更改請聯繫 AlipayHMTtechsupport@service.alipay.com

*A+錢包使用的秘鑰和現有的HK&CN錢包秘鑰需要保持一致

A.1.5. 查看PID資訊

不變機構/商戶仍然可以使用現有老門戶查看PID資訊

不適用由於本次A+錢包入網不會更改現有PID信息，故無需通過門戶確認PID信息

A.2. 交易資訊

A.2.1. 查看交易記錄，包括交易類別、狀態、金額

不變機構/商戶仍然可以使用現有老門戶查看交易資訊，但僅限HK&CN錢包的交易。 A+錢包交易不可見，故建議機構/商戶後續如有需要，請使用新門戶查看交易信息。

升級機構/商戶可以使用新門戶查看交易資訊，包括HK&CN錢包，以及A+錢包的交易

*對於HK&CN錢包交易，可查看2023年01月01日以後的交易

*A+錢包交易顯示真實的A+錢包名稱

A.2.2. 查看結算資訊

不適用入網A+后，HK&CN交易將和A+統一結算。 結算資訊將統一至新門戶上可查

升級機構/商戶可以使用新門戶查看結算資訊，包括HK&CN錢包，以及A+錢包的交易，但暫時不包括匯總資訊

*A+錢包交易顯示真實的A+錢包名稱

A.2.3. 操作退款

不變機構/商戶仍然可以使用現有老門戶執行退款操作，但僅限HK&CN錢包的交易。 A+錢包交易不可見，故建議機構/商戶後續如有需要，請使用新門戶查看交易信息。

升級機構/商戶可以使用新門戶執行退款操作，包括HK&CN錢包，以及A+錢包的交易

*A+錢包交易顯示真實的A+錢包名稱

A.3. 文件下載

A.3.1. 結算及交易

變更由於系統升級後，舊門戶的數據或存在不準確的情況，且不包括A+錢包交易，故建議機構/商戶後續如有需要，請使用新門戶下載賬單

升級機構/商戶可以使用新門戶下載結算及交易文件，包括HK&CN錢包，以及A+錢包的交易 （該功能將於24年1月底可用）

*A+錢包交易將標註為ALIPAY_HK交易

A.3.2. 交易詳情

變更由於系統升級後，舊門戶的數據或存在不準確的情況，且不包括A+錢包交易，故建議機構/商戶後續如有需要，請使用新門戶查詢交易詳情

不支持機構/商戶暫時無法通過新門戶下載交易詳情文件。 但可以查看所有交易的詳情

*門戶系統功能將陸續更新，升級后將支援該能力。

A.4. 店鋪碼申請

升級機構/商戶仍然可以使用現有老門戶申請靜態店鋪碼。 申請到的店鋪碼可支援HK&CN錢包，以及A+錢包的交易

不適用A+ 錢包無單獨店鋪碼，和HK&CN錢包共用。 機構/商戶亦無法通過新門戶申請店鋪碼。 如有需要，請登錄老門戶處理

B. 財務運營

B.1. 帳單

B.1.1 結算交易帳單

升級SFTP內的交易結算帳單維持現有格式、發放渠道。 SFTP的登錄帳密不變.

HK&CN錢包以及A+錢包將合併在同一份帳單中

A+交易將以ALIPAY_HK交易的形式增加在賬單文件中

（登錄SFTP請使用新域名 https://isftp-sea.alipayplus.com）

針對SFTP帳單上二級商户資訊的呈現，我們在支援A+的過程中做了以下系統能力升級:
當交易請求的時候，傳送參數secondary_merchant_industry/secondary_merchant_id/secondary_merchant_name/store_id/store_name 最終在SFTP帳單上的呈現邏輯如下

1. 發起交易請求的時候，如果上傳所有相關字段，則帳單內顯示上傳的內容
2. 發起交易請求的時候，如果僅上傳id信息，未上傳名稱信息或mcc，則後台會根據報備信息，自動補充缺失的名稱或mcc，並最終展示在賬單上。 若未查到相關的報備資訊，則帳單上僅顯示上傳的id
3. 發起交易請求的時候，如果僅上傳名稱信息或mcc，未上傳id信息，則後台不會自動補充缺失信息，賬單上相關信息顯示為空

因此，有感點集中在#2的情況下，即如果商户報備時候的名稱資訊和實際上傳的名稱資訊不一致的話，帳單顯示就會和商户現在帳單呈現有差異。 若商戶不消費二級商戶名稱或MCC訊息，則不受影響

B.1.2 ISV返傭帳單

不變現有接收返傭帳單的渠道保持不變 （ A+交易將以ALIPAY_HK交易的形式增加在帳單中）

升級可以通過新門戶下載返傭帳單

*需要使用ISV角色的主PID賬號登錄

B.2. 結算

B.2.1 結算限額

臨時內部切流需要，在切流期間將臨時調整結算限額。 切流完成後將恢復正常額度。 （ 預期受影響時間為切流前後2-3日）

不適用因A+錢包的交易類比AlipayHK錢包處理，並且HK&CN錢包以及A+錢包的結算將統一處理，故不會針對A+錢包單獨提供結算額限

C. 技術

C.1. 秘鑰更新

（ 參考上文 A.1.4. ）

變更機構/商戶不能通過門戶對RSA2秘鑰進行更改。 如需更改請聯繫 AlipayHMTtechsupport@service.alipay.com

*A+錢包使用的秘鑰和現有的HK&CN錢包秘鑰需要保持一致

C.2. 下單/支付接口

C.2.1 接口類別

不變現有接口均可用

*仍然不支援CNY幣種下單

升級線下場景可直接支援A+錢包進行支付，無需額外接入。 （亦不支援CNY幣種下單）

反掃（動態）：alipay.acquire.overseas.spot.pay

店鋪碼（靜態）：alipay.commerce.qrcode.create

訂單碼（動態）：alipay.acquire.precreate

C.2.2 預下單

變更 預下單接口返回的域名變更為 https://qr-acquire.alipay.hk （原域名https://qr.alipay.com/或https://qr.alipay.hk/）

二維碼的碼值變更為CGCP格式，如28100404049490oR1kpN70dFoW7RL1K49kAJ

不變 預下單接口返回字段定義保持不變

C.2.3 反掃

不變CN錢包交易接口不變

變更HK錢包反掃交易變更顯示備註於用户交易詳情頁(先顯示memo，無值取trans_name)

不適用A+錢包不會顯示備註字段

C.3. 異步通知返回

C.3.1. 錢包用戶資訊

不變保持不變

不適用A+錢包的交易將返回以下固定值

buyer_email: alipaygnbuyer@email.com

buyer_id: 2088000000000000

實際返回將顯示脫敏後的值：

buyer_email: alip***@email.com

buyer_id: 2088000000000000

C.3.2. 錢包類別

（payment_inst字段）

不變保持不變

臨時由於A+錢包將類比AlipayHK錢包進行處理，故payment_inst欄位將返回ALIPAY_HK

*後台系統升級后將支援返回真實錢包類別，e.g. GCASH。 請機構/商戶側確認下游系統對該欄位的處理是否有特殊要求，避免後續因為引入新A+錢包名稱而導致系統處理異常。 如貴司系統確實無法接收A+錢包名稱，請提前聯繫SA做特殊配置處理

C.3.3. 匯率

（forex_rate字段）

不變保持不變

不適用由於A+錢包將類比AlipayHK錢包進行處理，forex_rate欄位將返回固定值1

C.3.4. 支付工具

（paytools_pay_amount字段）

不變保持不變

臨時A+錢包paytools_pay_amount字段將將類比AlipayHK錢包進行處理稱，e.g. [{“ALIPAYACCOUNT”：“12494.99”}]。 金額為訂單金額

*後台系統升級後將支援返回真實錢包類別，e.g. [{“GCASH”：“123.9”}]。 請機構/商戶側確認下游系統對該字段的處理是否有特殊要求，避免因為引入新A+錢包名稱而導致系統處理異常。 如貴司系統確實無法接收A+錢包名稱，請提前聯繫SA做特殊配置處理

C.4. 反掃響應字段

C.4.1. 錢包用戶資訊

不變保持不變

不適用A+錢包的交易將返回以下固定值

alipay_buyer_login_id: alipaygnbuyer@email.com

alipay_buyer_user_id: 2088000000000000

alipay_buyer_mobile_no: 852-10000000

實際傳回將顯示脫敏後的值：

alipay_buyer_login_id: alip***@email.com

alipay_buyer_user_id: 2088000000000000

alipay_buyer_mobile_no: 852-****0000

C.4.2. 錢包類別

（payment_inst字段）

不變保持不變

臨時由於A+錢包將類比AlipayHK錢包進行處理，故payment_inst欄位將返回ALIPAY_HK

*後台系統升級后將支援返回真實錢包類別，e.g. GCASH。 請機構/商戶側確認下游系統對該欄位的處理是否有特殊要求，避免後續因為引入新A+錢包名稱而導致系統處理異常。 如貴司系統確實無法接收A+錢包名稱，請提前聯繫SA做特殊配置處理

C.5. 查詢響應字段

C.5.1. 錢包用戶資訊

不變保持不變

不適用A+錢包的交易將返回以下固定值

alipay_buyer_login_id: alipaygnbuyer@email.com

alipay_buyer_user_id: 2088000000000000

實際返回將顯示脫敏後的值：

alipay_buyer_login_id: alip***@email.com

alipay_buyer_user_id: 2088000000000000

C.5.2. 錢包類別

（payment_inst字段）

不變保持不變

臨時由於A+錢包將類比AlipayHK錢包進行處理，故payment_inst欄位將返回ALIPAYHK

*後台系統升級後將支援返回真實錢包類別，e.g. GCASH。 請機構/商戶側確認下游系統對該欄位的處理是否有特殊要求，避免後續因為引入新A+錢包名稱而導致系統處理異常。 如貴司系統確實無法接收A+錢包名稱，請提前聯繫SA做特殊配置處理

C.6. 通知消息

C.6.1 支付結果

不變通知渠道保持不變

升級支持以notify_url和短信形式通知A+錢包的支付結果

C.7. 沙箱環境

不變保持不變

臨時A+錢包暫無沙箱環境可以驗證。 可聯繫SA獲取共用PID做A+錢包測試驗證。 如機構/商戶自有UAT PID，可聯繫SA確認對應PID是否支援A+錢包