線上遷移機構/商家側有感點
版本信息
版本號 | 描述 | 生效時間 |
v1.1 | 初始版本 | 2025.08.04 |
背景介紹
為配合監管要求AlipayHK後台系統需要進行遷移,香港站的商家(線上場景)需於最早 2025年9月15日開始遵循以下變更點使用相應的服務。
下文将詳細描述遷移後的體驗變動。整體而言,有以下事項需要注意:
- AlipayHK提供新門戶入口。
- 新門戶:https://merchant.alipay.hk/merchant/login/link?tntInstId=ALIPW3HK
- 系統升級後舊門戶结算/待结算/交易數據或存在不準確的情況,老門戶數據僅限查詢遷移前的數據,機構/商戶需使用新門戶查詢最新交易。
- AlipayHK將統一進行結算打款、提供結算文件。
- 機構/商家目前使用的大部分線上接口可繼續使用,不可用接口詳見下文。
- 由於系統升級後舊門戶结算/待结算/交易數據或存在不準確的情況,相關信息請使用新門戶查詢
- 沙箱環境維持現在集成接入方式
*機構/商戶側如對AlipayHK接口回傳值有特殊處理,例如驗證回傳參數數目、限制回傳值字節長度、僅處理現有枚舉值等,請參考下列變列表做詳細分析,以免切流或遷移後影響機構/商戶下游系統的處理
可感知點列表
類別 | 線上系統遷移 PID維度切流後即使用新系統 | ||
HK&CN錢包 | |||
A. 商戶門戶 | A.1. 商戶賬號管理 | A.1.1. 門戶登錄 | 機構/商戶仍然可以使用現有賬密登錄老門戶。 老門戶現有功能維持不變。但考慮到舊門戶结算/待结算/交易數據或存在不準確的情況,相關信息請使用新門戶查詢。 新門戶已上線,機構/商戶可以使用現有帳戶登錄新門戶,無需重新註冊。 *首次登陸新門戶需要重置密碼,並通過郵箱接收驗證碼。 請確保登錄郵箱可用且能夠接收驗證碼資訊 |
A.1.2. 合約確認 | 如有合約簽署或變更,機構/商戶仍然可以在老門戶對合約確認 | ||
A.1.3. 帳號資訊更改,包括登入密碼,郵箱及付款密碼 | 機構/商戶仍然可以使用現有老門戶對賬號進行維護 *新老門戶的賬密不會自動同步,在老門戶上對帳戶資訊的更改不會影響新門戶的賬號資訊 登錄新門戶的帳號信息暫時不支援機構/商戶自助更改。 如有更改需要,請聯繫 HKMerchant@alipay.com *新老門戶的賬密不會自動同步,對新門戶上帳戶資訊的更改不會影響老門戶 *門戶系統功能將陸續更新,升級后將支援該能力。 | ||
A.1.4. 查看/更改密鑰資訊 | 機構/商戶不能在新老門戶進行查看或更改RSA,RSA2密鑰資訊,不支持查看及修改MD5。 *如需查看/更改RSA/RSA2密鑰請聯繫 AlipayHMTtechsupport@service.alipay.com | ||
A.1.5. 查看PID資訊 | 機構/商戶仍然可以使用現有老門戶查看PID資訊 | ||
A.2. 交易資訊 | A.2.1. 查看交易記錄,包括交易類別、狀態、金額 | 機構/商戶仍然可以使用現有老門戶查看切流前的交易資訊。切流後的交易請使用新門戶查看。 | |
A.2.2. 查看結算資訊 | 結算資訊將統一至新門戶上可查。 | ||
A.2.3. 操作退款 | 機構/商戶仍然可以使用現有老門戶執行退款操作。切流後的交易請使用新門戶執行退款操作。 | ||
A.3. 文件下載 | A.3.1. 結算及交易 | 由於系統升級後,老門戶的數據或存在不準確的情況,故建議機構/商戶後續如有需要,請使用新門戶下載賬單 | |
A.3.2. 交易詳情 | 機構/商戶暫時無法通過新門戶下載交易詳情文件。 但可以查看所有交易的詳情 | ||
B. 財務運營 | B.1. 帳單 | B.1.1 結算交易帳單 | SFTP內的交易結算帳單維持現有格式、發放渠道。 SFTP的登錄帳密不變. (登錄SFTP請使用新域名 https://isftp-sea.alipayplus.com) |
B.1.2 ISV返傭帳單 | 現有接收返傭帳單的渠道保持不變 可以通過新門戶下載返傭帳單 *需要使用ISV角色的主PID賬號登錄 | ||
B.2. 結算 | B.2.1 結算限額 | 內部切流需要,在切流期間將臨時調整結算限額。 切流完成後將恢復正常額度。 ( 預期受影響時間為切流前後2-3日) | |
C. 技術 | C.1. 秘鑰更新 ( 參考上文 A.1.4. ) | 機構/商戶不能通過門戶對RSA2秘鑰進行更改。 如需更改請聯繫 AlipayHMTtechsupport@service.alipay.com | |
C.2. 支付/查詢/退款接口 | C.2.1 接口類別 | 現有接口均可用 *仍然不支援CNY等非HKD幣種下單 | |
C.3. 文件下載接口 | C.3.1. 交易賬單下載接口 forex_compare_file | 僅支持查詢T-1日的數據(T為交易日) T日凌晨02:00產出T-1日的交易文件,建議02:00之後調用接口獲取文件,否則調用時會報錯。 結算時間(column5)將不再返回,結算狀態(column8)將恆常返回 "P" (已付款)(2025/09/15 生效) | |
C.3.2. 結算賬單下載接口 forex_liquidation_file | 調用錯誤(2025/07/20 生效) | ||
C.3.3. 匯率文件下載接口 forex_rate_file | 調用錯誤(2025/07/20 生效) | ||
C.7. 沙箱環境 | 保持不變 |
常見問題
遷移期間,商戶交易是否有影響?
沒有影響。本次升級為AlipayHK 後台升級,對機構/商戶側是幾乎無感的,升級期間無服務中斷。有感點請參照上文。有感點集中在商戶門戶及部分接口的返回字段上。
存量商戶需要重新報備?
不需要。
我如何知道我的PID已經完成遷移?
現階段AlipayHK將以PID為維度逐步完成遷移。請注意,遷移的前提是您的PID請求的域名已經不再是舊域名。舊域名包括:http://mapi.alipay.com/ http://www.alipay.com http://mapi-hk.alipay.com。如仍在使用舊域名,請盡快升級至新域名:https://api-sea-global.alipayplus.com
預期的升級時間為2025年Q3。如有任何疑問,請聯繫我們的集成團隊查詢及處理hk_integration_support_case@service.alipay.com