🔥码云GVP开源项目 12k star Uniapp+ElementUI 功能强大 支持多语言、二开方便! 广告
# [](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)查看更加详细的参数说明。 * * *