支付文檔：支付能力 · 支付筆記

# [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E6%94%AF%E4%BB%98%E8%83%BD%E5%8A%9B-payment)支付能力 Payment ## [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E9%80%9A%E7%94%A8%E6%8E%A5%E5%8F%A3-common)通用接口 Common ### [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E5%88%9B%E5%BB%BA%E4%BA%A4%E6%98%93)創建交易 * API聲明 create(subject: string, outTradeNo: string, totalAmount: string, buyerId: string) * 入參說明 | 字段名 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | subject | string | 是 | 訂單標題 | | outTradeNo | string | 是 | 商戶訂單號，64個字符以內，可包含字母、數字、下劃線，需保證在商戶端不重復 | | totalAmount | string | 是 | 訂單總金額，單位為元，精確到小數點后兩位，取值范圍\[0.01,100000000\] | | buyerId | string | 是 | 買家的支付寶唯一用戶號（2088開頭的16位純數字） | * 出參說明可前往[alipay.trade.create](https://docs.open.alipay.com/api_1/alipay.trade.create)查看更加詳細的參數說明。 ### [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E6%9F%A5%E8%AF%A2%E4%BA%A4%E6%98%93)查詢交易 * API聲明 query(outTradeNo: string) * 入參說明 | 字段名 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | outTradeNo | string | 是 | 交易創建時傳入的商戶訂單號 | * 出參說明可前往[alipay.trade.query](https://docs.open.alipay.com/api_1/alipay.trade.query)查看更加詳細的參數說明。 ### [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E4%BA%A4%E6%98%93%E9%80%80%E6%AC%BE)交易退款 * API聲明 refund(outTradeNo: string, refundAmount: string) * 入參說明 | 字段名 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | outTradeNo | string | 是 | 交易創建時傳入的商戶訂單號 | | refundAmount | string | 是 | 需要退款的金額，該金額不能大于訂單金額，單位為元，支持兩位小數 | * 出參說明可前往[alipay.trade.refund](https://docs.open.alipay.com/api_1/alipay.trade.refund)查看更加詳細的參數說明。 ### [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E5%85%B3%E9%97%AD%E4%BA%A4%E6%98%93)關閉交易 * API聲明 close(outTradeNo: string) * 入參說明 | 字段名 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | outTradeNo | string | 是 | 交易創建時傳入的商戶訂單號 | * 出參說明可前往[alipay.trade.close](https://docs.open.alipay.com/api_1/alipay.trade.close)查看更加詳細的參數說明。 ### [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E6%92%A4%E9%94%80%E4%BA%A4%E6%98%93)撤銷交易 * API聲明 cancel(outTradeNo: string) * 入參說明 | 字段名 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | outTradeNo | string | 是 | 交易創建時傳入的商戶訂單號 | * 出參說明可前往[alipay.trade.cancel](https://docs.open.alipay.com/api_1/alipay.trade.cancel)查看更加詳細的參數說明。 ### [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E4%BA%A4%E6%98%93%E9%80%80%E6%AC%BE%E6%9F%A5%E8%AF%A2)交易退款查詢 * API聲明 queryRefund(outTradeNo: string, outRequestNo: string) * 入參說明 | 字段名 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | outTradeNo | string | 是 | 交易創建時傳入的商戶訂單號 | | outRequestNo | string | 是 | 請求退款接口時，傳入的退款請求號，如果在退款請求時未傳入，則該值為創建交易時的外部交易號 | * 出參說明可前往[alipay.trade.fastpay.refund.query](https://opendocs.alipay.com/apis/api_1/alipay.trade.fastpay.refund.query)查看更加詳細的參數說明。 ### [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E6%9F%A5%E8%AF%A2%E5%AF%B9%E8%B4%A6%E5%8D%95%E4%B8%8B%E8%BD%BD%E5%9C%B0%E5%9D%80)查詢對賬單下載地址 * API聲明 downloadBill(billType: string, billDate: string) * 入參說明 | 字段名 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | billType | string | 是 | 賬單類型，商戶通過接口或商戶經開放平臺授權后其所屬服務商通過接口可以獲取以下賬單類型：trade、signcustomer；trade指商戶基于支付寶交易收單的業務賬單；signcustomer是指基于商戶支付寶余額收入及支出等資金變動的帳務賬單 | | billDate | string | 是 | 賬單時間：日賬單格式為yyyy-MM-dd，最早可下載2016年1月1日開始的日賬單；月賬單格式為yyyy-MM，最早可下載2016年1月開始的月賬單 | * 出參說明可前往[alipay.data.dataservice.bill.downloadurl.query](https://opendocs.alipay.com/apis/api_15/alipay.data.dataservice.bill.downloadurl.query)查看更加詳細的參數說明。 ### [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E5%BC%82%E6%AD%A5%E9%80%9A%E7%9F%A5%E9%AA%8C%E7%AD%BE)異步通知驗簽 * API聲明 verifyNotify(parameters: map\[string\]string) * 入參說明 | 字段名 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | parameters | map\[string\]string | 是 | 異步通知中收到的待驗簽的所有參數 | * * * ## [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E8%8A%B1%E5%91%97%E5%88%86%E6%9C%9F-huabei)花唄分期 Huabei ### [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E5%88%9B%E5%BB%BA%E8%8A%B1%E5%91%97%E5%88%86%E6%9C%9F%E4%BA%A4%E6%98%93)創建花唄分期交易 * API聲明 create(subject: string, outTradeNo: string, totalAmount: string, buyerId: string, extendParams: HuabeiConfig) * 入參說明 | 字段名 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | subject | string | 是 | 訂單標題 | | outTradeNo | string | 是 | 商戶訂單號，64個字符以內，可包含字母、數字、下劃線，需保證在商戶端不重復 | | totalAmount | string | 是 | 訂單總金額，單位為元，精確到小數點后兩位，取值范圍\[0.01,100000000\] | | buyerId | string | 是 | 買家的支付寶用戶ID，如果為空，會從傳入的碼值信息中獲取買家ID | | extendParams | HuabeiConfig | 是 | 花唄交易擴展參數 | HuabeiConfig對象說明 | 字段名 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | hbFqNum | string | 是 | 花唄分期數，僅支持傳入3、6、12 | | hbFqSellerPercent | string | 是 | 代表賣家承擔收費比例，商家承擔手續費傳入100，用戶承擔手續費傳入0，僅支持傳入100、0兩種 | * 出參說明可前往[alipay.trade.create](https://docs.open.alipay.com/api_1/alipay.trade.create)查看更加詳細的參數說明。 * * * ## [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E5%BD%93%E9%9D%A2%E4%BB%98-facetoface)當面付 FaceToFace ### [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E5%BD%93%E9%9D%A2%E4%BB%98%E4%BA%A4%E6%98%93%E4%BB%98%E6%AC%BE)當面付交易付款 * API聲明 pay(subject: string, outTradeNo: string, totalAmount: string, authCode: string) * 入參說明 | 字段名 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | subject | string | 是 | 訂單標題 | | outTradeNo | string | 是 | 交易創建時傳入的商戶訂單號 | | totalAmount | string | 是 | 訂單總金額，單位為元，精確到小數點后兩位，取值范圍\[0.01,100000000\] | | authCode | string | 是 | 支付授權碼，即買家的付款碼數字 | * 出參說明可前往[alipay.trade.pay](https://docs.open.alipay.com/api_1/alipay.trade.pay)查看更加詳細的參數說明。 * 返傭說明 ISV對接當面付產品需涉及返傭時，請先閱讀[政策詳情](https://opendocs.alipay.com/p/00fc2g)與[合作攻略](https://opendocs.alipay.com/open/300/taphxd)。 **對接時必須在支付接口的extend\_params參數中設置sys\_service\_provider\_id返傭參數，參數值為簽約返傭協議的PID**，示例代碼如下（Java為例）： ~~~java Map<String, String> extendParams = new HashMap<>(); extendParams.put("sys_service_provider_id", "<--請填寫ISV簽約協議的PID，比如：2088511833207846-->"); AlipayTradePayResponse response = Factory.Payment.FaceToFace() .agent("<--請填寫商戶應用授權后獲取到的app_auth_token，比如：ca34ea491e7146cc87d25fca24c4cD11-->") .optional("extend_params", extendParams) .pay("iPhone6 16G", "64628156-f784-4572-9540-485b7c91b850", "0.01", "289821051157962364"); ~~~ * * * ### [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E4%BA%A4%E6%98%93%E9%A2%84%E5%88%9B%E5%BB%BA%E7%94%9F%E6%88%90%E6%AD%A3%E6%89%AB%E4%BA%8C%E7%BB%B4%E7%A0%81)交易預創建，生成正掃二維碼 * API聲明 precreate(subject: string, outTradeNo: string, totalAmount: string) * 入參說明 | 字段名 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | subject | string | 是 | 訂單標題 | | outTradeNo | string | 是 | 交易創建時傳入的商戶訂單號 | | totalAmount | string | 是 | 訂單總金額，單位為元，精確到小數點后兩位，取值范圍\[0.01,100000000\] | * 出參說明可前往[alipay.trade.precreate](https://docs.open.alipay.com/api_1/alipay.trade.precreate)查看更加詳細的參數說明。 * 返傭說明 ISV對接當面付產品需涉及返傭時，請先閱讀[政策詳情](https://opendocs.alipay.com/p/00fc2g)與[合作攻略](https://opendocs.alipay.com/open/300/taphxd)。 **對接時必須在支付接口的extend\_params參數中設置sys\_service\_provider\_id返傭參數，參數值為簽約返傭協議的PID**，示例代碼如下（Java為例）： ~~~java Map<String, String> extendParams = new HashMap<>(); extendParams.put("sys_service_provider_id", "<--請填寫ISV簽約協議的PID，比如：2088511833207846-->"); AlipayTradePrecreateResponse response = Payment.FaceToFace() .agent("<--請填寫商戶應用授權后獲取到的app_auth_token，比如：ca34ea491e7146cc87d25fca24c4cD11-->") .optional("extend_params", extendParams) .preCreate("iPhone6 16G", "64628156-f784-4572-9540-485b7c91b850", "0.01"); ~~~ * * * ## [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E7%94%B5%E8%84%91%E7%BD%91%E7%AB%99-page)電腦網站 Page ### [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E7%94%B5%E8%84%91%E7%BD%91%E7%AB%99%E6%94%AF%E4%BB%98)電腦網站支付 * API聲明 pay(subject: string, outTradeNo: string, totalAmount: string, returnUrl: string) * 入參說明 | 字段名 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | subject | string | 是 | 訂單標題 | | outTradeNo | string | 是 | 交易創建時傳入的商戶訂單號 | | totalAmount | string | 是 | 訂單總金額，單位為元，精確到小數點后兩位，取值范圍\[0.01,100000000\] | | returnUrl | string | 否 | 支付成功后同步跳轉的頁面，是一個http/https開頭的字符串 | * 出參說明可前往[alipay.trade.page.pay](https://docs.open.alipay.com/api_1/alipay.trade.page.pay)查看更加詳細的參數說明。 * * * ## [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E6%89%8B%E6%9C%BA%E7%BD%91%E7%AB%99-wap)手機網站 Wap ### [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E6%89%8B%E6%9C%BA%E7%BD%91%E7%AB%99%E6%94%AF%E4%BB%98)手機網站支付 * API聲明 pay(subject: string, outTradeNo: string, totalAmount: string, quitUrl: string, returnUrl: string) * 入參說明 | 字段名 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | subject | string | 是 | 訂單標題 | | outTradeNo | string | 是 | 交易創建時傳入的商戶訂單號 | | totalAmount | string | 是 | 訂單總金額，單位為元，精確到小數點后兩位，取值范圍\[0.01,100000000\] | | quitUrl | string | 是 | 用戶付款中途退出返回商戶網站的地址 | | returnUrl | string | 否 | 支付成功后同步跳轉的頁面，是一個http/https開頭的字符串 | * 出參說明可前往[alipay.trade.wap.pay](https://docs.open.alipay.com/api_1/alipay.trade.wap.pay)查看更加詳細的參數說明。 * * * ## [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#app%E6%94%AF%E4%BB%98-app)App支付 App ### [](https://github.com/alipay/alipay-easysdk/blob/master/APIDoc.md#%E6%89%8B%E6%9C%BAapp%E6%94%AF%E4%BB%98)手機APP支付 * API聲明 pay(subject: string, outTradeNo: string, totalAmount: string) * 入參說明 | 字段名 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | subject | string | 是 | 訂單標題 | | outTradeNo | string | 是 | 交易創建時傳入的商戶訂單號 | | totalAmount | string | 是 | 訂單總金額，單位為元，精確到小數點后兩位，取值范圍\[0.01,100000000\] | * 出參說明可前往[alipay.trade.app.pay](https://docs.open.alipay.com/api_1/alipay.trade.app.pay)查看更加詳細的參數說明。 * * *