支付寶資金賬戶資產(chǎn)查詢接口 和 支付寶商家賬戶當前余額查詢 區(qū)別
這篇文章是給做支付寶接口開發(fā)的開發(fā)者提供幫助的,也是本人遇到的疑惑和問題的記錄。
支付寶接口文檔內,關于查詢商家自己的余額接口有兩個:
1.支付寶資金賬戶資產(chǎn)查詢接口?alipay.fund.account.query
2.支付寶商家賬戶當前余額查詢 alipay.data.bill.balance.query
這倆接口查詢的結果差不多,但是使用上大有區(qū)別
1.的文檔地址:https://opendoc.alipay.com/open/02tesp?pathHash=c20c3918
2.的文檔地址:https://opendocs.alipay.com/open/02awe3
1. 的使用場景:可查詢請求方的支付寶賬戶余額信息。
2. 的使用場景:為支付寶商家提供支付寶賬戶當前余額信息,包括凍結金額,可用余額和總額,供對賬使用。
------------------------------------------------------------------------
1. 的文檔描述中,alipay_user_id 為?支付寶會員 id。概覽里描述的是:商戶調用該接口查詢商戶支付寶賬戶的可用余額,被查詢支付寶賬戶對應的ID必須等于請求發(fā)起方商戶支付寶ID。這個 id 在此處并未說明是什么 id,如何獲取。
通過搜索,查到另一篇文章:https://opensupport.alipay.com/support/knowledge/01/201602480928
得知,這個 id 為?對應的商戶 id 賬號(2088開頭的值)。
這個 id 位于:https://b.alipay.com/page/store-management/infomanage 支付寶商家平臺 - 賬號中心 -?商戶號(收單賬號)?
文檔描述不清楚的地方是:alipay_user_id 以為是任何?支付寶會員 id 均可查詢,實際在概覽里描述的是只能查自己家的商戶余額(https://opendoc.alipay.com/open/021kx7?pathHash=e3dbae99)
好,那么這個接口返回的余額信息有兩個:可用余額 available_amount ,凍結余額 freeze_amount
------------------------------------------------------------------------
2. 的接口,在使用之前,需要綁定操作:https://opendocs.alipay.com/open/01s7vc?pathHash=ef3327ba,否則就是 ISV 權限不足的錯誤提示。
2. 的文檔描述中,bill_user_id 為目標查詢賬戶,可選字段,查詢自身時候不需要傳遞當前字段。那么我嘗試查詢另外一個商戶 id 賬號(2088開頭的值),返回的錯誤信息為:用戶協(xié)議授權檢查不通過。
既然如此,我實在不明白,不能查詢另外的賬戶,何必還要這個字段呢?還是必須是同主體的不同商戶號可以互相查詢?未驗證!
這個接口返回的余額信息有四個:可用余額 available_amount ,凍結余額 freeze_amount,全部余額?total_amount 和 待結算金額 settle_amount
但是我測試的返回結果,未返回 待結算金額 settle_amount
------------------------------------------------------------------------
總結:2 接口 比 1 接口返回的余額數(shù)據(jù)多兩個金額;2 接口需要綁定操作后才可以使用;兩個接口疑似只能查詢自己商戶的余額,商戶 id 賬號為 2088開頭的值
也不知道是我自己的理解問題還是支付寶文檔的混亂,依然不清楚支付寶弄出來兩個相似的余額查詢的目的是什么,望高人解惑。