egg-alipay

> 支付宝新版App支付nodejs版sdk. 单笔转账到支付宝账户

Examples


``js
const path = require('path');
const Alipay = require('egg-alipay');

let outTradeId = Date.now().toString();

/**
*
* @param {Object} opts
* @param {String} opts.appId 支付宝的appId
* @param {String} opts.notifyUrl 支付宝服务器主动通知商户服务器里指定的页面http/https路径
* @param {String} opts.rsaPrivate 商户私钥pem文件路径
* @param {String} opts.rsaPublic 支付宝公钥pem文件路径
* @param {String} opts.signType 签名方式, 'RSA' or 'RSA2'
* @param {Boolean} [opts.sandbox] 是否是沙盒环境
* @constructor
*/
var ali = new Alipay({
appId: '2016080300159077',
   notifyUrl: 'http://www.xxx.com/callback/alipay',
rsaPrivate: path.resolve('./pem/sandbox_private.pem'),
rsaPublic: path.resolve('./pem/sandbox_ali_public.pem'),
sandbox: true,
signType: 'RSA'
});


/**
* 生成支付参数供客户端使用
* @param {Object} opts
* @param {String} opts.subject 商品的标题/交易标题/订单标题/订单关键字等
* @param {String} [opts.body] 对一笔交易的具体描述信息。如果是多种商品，请将商品描述字符串累加传给body
* @param {String} opts.outTradeId 商户网站唯一订单号
* @param {String} [opts.timeout] 设置未付款支付宝交易的超时时间，一旦超时，该笔交易就会自动被关闭。
当用户进入支付宝收银台页面（不包括登录页面），会触发即刻创建支付宝交易，此时开始计时。
取值范围：1m～15d。m-分钟，h-小时，d-天，1c-当天（1c-当天的情况下，无论交易何时创建，都在0点关闭）。
该参数数值不接受小数点， 如 1.5h，可转换为 90m。
* @param {String} opts.amount 订单总金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]
* @param {String} [opts.sellerId] 收款支付宝用户ID。 如果该值为空，则默认为商户签约账号对应的支付宝用户ID
* @param {String} opts.goodsType 商品主类型：0—虚拟类商品，1—实物类商品 注：虚拟类商品不支持使用花呗渠道
* @param {String} [opts.passbackParams] 公用回传参数，如果请求时传递了该参数，则返回给商户时会回传该参数。支付宝会在异步通知时将该参数原样返回。本参数必须进行UrlEncode之后才可以发送给支付宝
* @param {String} [opts.promoParams] 优惠参数(仅与支付宝协商后可用)
* @param {String} [opts.extendParams] 业务扩展参数 https://doc.open.alipay.com/docs/doc.htm?spm=a219a.7629140.0.0.3oJPAi&treeId=193&articleId=105465&docType=1#kzcs
* @param {String} [opts.enablePayChannels] 可用渠道，用户只能在指定渠道范围内支付。当有多个渠道时用“,”分隔。注：与disable_pay_channels互斥
* @param {String} [opts.disablePayChannels] 禁用渠道，用户不可用指定渠道支付。当有多个渠道时用“,”分隔。 注：与enable_pay_channels互斥
* @param {String} [opts.storeId] 商户门店编号
*/
var params = ali.appPay({
subject: '测试商品',
body: '测试商品描述',
outTradeId: outTradeId,
timeout: '10m',
amount: '10.00',
goodsType: '0'
});
console.log(params);


/**
* 生成支付参数供web端使用
* @param {Object} opts
* @param {String} opts.subject 商品的标题/交易标题/订单标题/订单关键字等
* @param {String} [opts.body] 对一笔交易的具体描述信息。如果是多种商品，请将商品描述字符串累加传给body
* @param {String} opts.outTradeId 商户网站唯一订单号
* @param {String} [opts.timeout] 设置未付款支付宝交易的超时时间，一旦超时，该笔交易就会自动被关闭。
当用户进入支付宝收银台页面（不包括登录页面），会触发即刻创建支付宝交易，此时开始计时。
取值范围：1m～15d。m-分钟，h-小时，d-天，1c-当天（1c-当天的情况下，无论交易何时创建，都在0点关闭）。
该参数数值不接受小数点， 如 1.5h，可转换为 90m。
* @param {String} opts.amount 订单总金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]
* @param {String} [opts.sellerId] 收款支付宝用户ID。 如果该值为空，则默认为商户签约账号对应的支付宝用户ID
* @param {String} opts.goodsType 商品主类型：0—虚拟类商品，1—实物类商品 注：虚拟类商品不支持使用花呗渠道
* @param {String} [opts.passbackParams] 公用回传参数，如果请求时传递了该参数，则返回给商户时会回传该参数。支付宝会在异步通知时将该参数原样返回。本参数必须进行UrlEncode之后才可以发送给支付宝
* @param {String} [opts.promoParams] 优惠参数(仅与支付宝协商后可用)
* @param {String} [opts.extendParams] 业务扩展参数 https://doc.open.alipay.com/docs/doc.htm?spm=a219a.7629140.0.0.3oJPAi&treeId=193&articleId=105465&docType=1#kzcs
* @param {String} [opts.enablePayChannels] 可用渠道，用户只能在指定渠道范围内支付。当有多个渠道时用“,”分隔。注：与disable_pay_channels互斥
* @param {String} [opts.disablePayChannels] 禁用渠道，用户不可用指定渠道支付。当有多个渠道时用“,”分隔。 注：与enable_pay_channels互斥
* @param {String} [opts.storeId] 商户门店编号
* @param {String} [opts.return_url] 客户端回调地址，HTTP/HTTPS开头字符串
*/
var params = ali.wapPay({
subject: '测试商品',
body: '测试商品描述',
outTradeId: outTradeId,
timeout: '10m',
amount: '10.00',
goodsType: '0'
});
console.log(params);

/**
* 生成支付参数供电脑网站使用
* @param {Object} opts
* @param {String} opts.outTradeId 商户网站唯一订单号
* @param {String} opts.subject 商品的标题/交易标题/订单标题/订单关键字等
* @param {String} opts.amount 订单总金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]
* @param {String} [opts.body] 对一笔交易的具体描述信息。如果是多种商品，请将商品描述字符串累加传给body
* @param {String} [opts.timeout] 设置未付款支付宝交易的超时时间，一旦超时，该笔交易就会自动被关闭。
* 当用户进入支付宝收银台页面（不包括登录页面），会触发即刻创建支付宝交易，此时开始计时。
* 取值范围：1m～15d。m-分钟，h-小时，d-天，1c-当天（1c-当天的情况下，无论交易何时创建，都在0点关闭）。
* 该参数数值不接受小数点， 如 1.5h，可转换为 90m。
* @param {String} [opts.goodsType] 商品主类型：0—虚拟类商品，1—实物类商品 注：虚拟类商品不支持使用花呗渠道
* @param {String} [opts.goodsDetail] 订单包含的商品列表信息，JSON格式，例如：{"show_url":"https://example/good/id"}
* @param {String} [opts.passbackParams] 公用回传参数，如果请求时传递了该参数，则返回给商户时会回传该参数。支付宝会在异步通知时将该参数原样返回。本参数必须进行UrlEncode之后才可以发送给支付宝
* @param {String} [opts.extendParams] 业务扩展参数 https://doc.open.alipay.com/docs/doc.htm?spm=a219a.7629140.0.0.3oJPAi&treeId=193&articleId=105465&docType=1#kzcs
* @param {String} [opts.enablePayChannels] 可用渠道，用户只能在指定渠道范围内支付。当有多个渠道时用“,”分隔。注：与disable_pay_channels互斥
* @param {String} [opts.disablePayChannels] 禁用渠道，用户不可用指定渠道支付。当有多个渠道时用“,”分隔。 注：与enable_pay_channels互斥
* @param {String} [opts.qrPayMode] PC扫码支付的方式，支持前置模式和跳转模式。前置模式是将二维码前置到商户的订单确认页的模式，需要商户在自己的页面中以 iframe 方式请求支付宝页面。
* 具体分为以下几种：
* 0，订单码-简约前置模式，对应 iframe 宽度不能小于600px，高度不能小于300px
* 1，订单码-前置模式，对应 iframe 宽度不能小于300px，高度不能小于600px
* 3，订单码-迷你模式，对应 iframe 宽度不能小于75px，高度不能小于75px
* 4，订单码-可定义宽度的嵌入式二维码，商户可根据需要设定二维码的大小
* 跳转模式下，用户的扫码界面是由支付宝生成的，不存在商户的域名下，具体为：
* 2，订单码-跳转模式
* @param {String} [opts.qrcodeWidte] 商户自定义二维码宽度。注：qrPayMode = 4 时该参数生效
* @param {String} [opts.return_url] 客户端回调地址，HTTP/HTTPS开头字符串
*/
var params = ali.pagePay({
subject: '测试商品',
body: '测试商品描述',
outTradeId: outTradeId,
timeout: '10m',
amount: '10.00',
goodsType: '0',
qrPayMode: 0
});
console.log(params);


/**
* 生成支付参数供单笔转账到支付宝账户
* @param {Object} opts
* @param {String} opts.out_biz_no 商户转账唯一订单号。发起转账来源方定义的转账单据ID，用于将转账回执通知给来源方。不同来源方给出的ID可以重复，同一个来源方必须保证其ID的唯一性。 只支持半角英文、数字，及“-”、“_”。 3142321423432
* @param {String} opts.payee_type 收款方账户类型。可取值： 1、ALIPAY_USERID：支付宝账号对应的支付宝唯一用户号。以2088开头的16位纯数字组成。 2、ALIPAY_LOGONID：支付宝登录号，支持邮箱和手机号格式。 ALIPAY_LOGONID
* @param {String} opts.payee_account 收款方账户。与payee_type配合使用。付款方和收款方不能是同一个账户。 abc@sina.com
* @param {String} opts.amount 转账金额，单位：元。只支持2位小数，小数点前最大支持13位，金额必须大于等于0.1元。 12.23
* @param {String} [opts.payer_show_name] 付款方姓名（最长支持100个英文/50个汉字）。显示在收款方的账单详情页。如果该字段不传，则默认显示付款方的支付宝认证姓名或单位名称。 斌哥的卡退款
* @param {String} [opts.payee_real_name] 收款方真实姓名（最长支持100个英文/50个汉字）。 如果本参数不为空，则会校验该账户在支付宝登记的实名是否与收款方真实姓名一致。 张三
* @param {String} [opts.remark] 转账备注（支持200个英文/100个汉字）。 当付款方为企业账户，且转账金额达到（大于等于）50000元，remark不能为空。收款方可见，会展示在收款用户的收支详情中。 转账备注。
*/
ali.accountPay({
out_biz_no: opts.out_biz_no,
payee_type: opts.payee_type,
payee_account: opts.payee_account,
amount: opts.amount,
remark: opts.remark
}).then(function (ret) {
console.log("* ret.body=" + ret.body);
});

/**
* 查询单笔转账订单接口
* @param {Object} opts
* @param {String} opts.out_biz_no 商户转账唯一订单号：发起转账来源方定义的转账单据ID。 和支付宝转账单据号不能同时为空。当和支付宝转账单据号同时提供时，将用支付宝转账单据号进行查询，忽略本参数。 3142321423432
* @param {String} opts.order_id 支付宝转账单据号：和商户转账唯一订单号不能同时为空。当和商户转账唯一订单号同时提供时，将用本参数进行查询，忽略商户转账唯一订单号。
*/
ali.accountQuery({
out_biz_no: opts.out_biz_no,
out_biz_no: opts.out_biz_no,
}).then(function (ret) {
console.log("* ret.body=" + ret.body);
});

/**
* 签名校验
* @param {Object} response 解析后的支付宝响应报文、支付宝支付结果通知报文
* returns {boolean}
*/
let ok = ali.signVerify(response);


/**
* 查询交易状态 https://doc.open.alipay.com/doc2/apiDetail.htm?spm=a219a.7629065.0.0.PlTwKb&apiId=757&docType=4
* @param {Object} opts
* @param {String} [opts.outTradeId] 订单支付时传入的商户订单号,和支付宝交易号不能同时为空。 tradeId,outTradeId如果同时存在优先取tradeId
* @param {String} [opts.tradeId] 支付宝交易号，和商户订单号不能同时为空
* @param {String} [opts.appAuthToken] https://doc.open.alipay.com/doc2/detail.htm?treeId=216&articleId=105193&docType=1
*/
ali.query({
outTradeId: outTradeId
}).then(function (ret) {
console.log("* ret.body=" + ret.body);

//签名校验
var ok = ali.signVerify(ret.json());
});


/**
* 统一收单交易关闭接口 https://doc.open.alipay.com/doc2/apiDetail.htm?spm=a219a.7629065.0.0.6VzMcn&apiId=1058&docType=4
* @param {Object} opts
* @param {String} [opts.outTradeId] 订单支付时传入的商户订单号,和支付宝交易号不能同时为空。 tradeId,outTradeId如果同时存在优先取tradeId
* @param {String} [opts.tradeId] 支付宝交易号，和商户订单号不能同时为空
* @param {String} [opts.operatorId] 卖家端自定义的的操作员 ID
* @param {String} [opts.appAuthToken] https://doc.open.alipay.com/doc2/detail.htm?treeId=216&articleId=105193&docType=1
*/
ali.close({
outTradeId: outTradeId
}).then(function (ret) {
console.log("* ret.body=" + ret.body);
});


/**
* 统一收单交易退款接口 https://doc.open.alipay.com/doc2/apiDetail.htm?spm=a219a.7629065.0.0.PlTwKb&apiId=759&docType=4
* @param {Object} opts
* @param {String} [opts.outTradeId] 订单支付时传入的商户订单号,和支付宝交易号不能同时为空。 tradeId,outTradeId如果同时存在优先取tradeId
* @param {String} [opts.tradeId] 支付宝交易号，和商户订单号不能同时为空
* @param {String} [opts.operatorId] 卖家端自定义的的操作员 ID
* @param {String} [opts.appAuthToken] https://doc.open.alipay.com/doc2/detail.htm?treeId=216&articleId=105193&docType=1
* @param {String} opts.refundAmount 需要退款的金额，该金额不能大于订单金额,单位为元，支持两位小数
* @param {String} [opts.refundReason] 退款的原因说明
* @param {String} [opts.outRequestId] 标识一次退款请求，同一笔交易多次退款需要保证唯一，如需部分退款，则此参数必传。
* @param {String} [opts.storeId] 商户的门店编号
* @param {String} [opts.terminalId] 商户的终端编号
*/
ali.refund({
outTradeId: outTradeId,
operatorId: 'XX001',
refundAmount: '2.01',
refundReason: '退款'
}).then(function (ret) {
console.log("* ret.body=" + ret.body);
});


/**
* 统一收单交易退款查询 https://doc.open.alipay.com/doc2/apiDetail.htm?docType=4&apiId=1049
* @param {Object} opts
* @param {String} [opts.outTradeId] 订单支付时传入的商户订单号,和支付宝交易号不能同时为空。 tradeId,outTradeId如果同时存在优先取tradeId
* @param {String} [opts.tradeId] 支付宝交易号，和商户订单号不能同时为空
* @param {String} [opts.outRequestId] 请求退款接口时，传入的退款请求号，如果在退款请求时未传入，则该值为创建交易时的外部交易号
* @param {String} [opts.appAuthToken] https://doc.open.alipay.com/doc2/detail.htm?treeId=216&articleId=105193&docType=1
*/
ali.refundQuery({...}).then(function(ret) {
console.log("* ret.body=" + ret.body);
});


/**
* 查询对账单下载地址 https://doc.open.alipay.com/doc2/apiDetail.htm?spm=a219a.7629065.0.0.iX5mPA&apiId=1054&docType=4
* @param {Object} opts
* @param {String} [opts.billType] 账单类型，商户通过接口或商户经开放平台授权后其所属服务商通过接口可以获取以下账单类型：
trade、signcustomer；trade指商户基于支付宝交易收单的业务账单；signcustomer是指基于商户支付宝余额收入及支出等资金变动的帐务账单；
* @param {String} [opts.billDate] 账单时间：日账单格式为yyyy-MM-dd，月账单格式为yyyy-MM。
* @param {String} [opts.appAuthToken] https://doc.open.alipay.com/doc2/detail.htm?treeId=216&articleId=105193&docType=1
*/
ali.billDownloadUrlQuery({
billType: 'trade',
billDate: '2017-03'
}).then(function (ret) {
console.log("* ret.body=" + ret.body);
});

`

注意

`sh
支付宝的公钥下载后需要格式化才能使用(添加首尾、以每行64字符进行断行),参考test/pem/sandbox_ali_public.pem
`

Install

Install with npm

`sh
$ npm i alipay-node-sdk --save
``

贡献者

 @Allidylls