1.0.1 • Published 3 years ago
alipay-libs v1.0.1
蚂蚁金服开放平台Node.js
SDK。
安装
npm i alipay-libs -S
基本使用
const fs = require('fs')
const Alipay = require('alipay-libs').default
const readFile = filename => {
return fs.readFileSync(path.resolve(__dirname, filename))
}
const options = {
app_id: '20180xxxxxxxxxxxx', // 应用ID
appPrivKeyFile: readFile('./pem/app_private_key.pem'), // 应用私钥
alipayPubKeyFile: readFile('./pem/alipay_public_key.pem'), // 支付宝公钥
notifyUrl: '', // 异步通知url(选填)
gatewayUrl: '', // 应用网关url(选填)
}
const service = new Alipay(options)
const data = {
subject: 'QQ充值中心',
out_trade_no: '1232423',
total_amount: '100'
}
const result = service.createOrder(data)
接口返回格式
{
code: '' // 错误码,
message: '', // 错误信息,
data: '' // 蚂蚁金服返回的原始数据(可能为空对象)
}
功能列表
- 创建订单
- 取消订单
- 订单查询
- 验证支付状态
- 订单状态异步推送
- 预创建订单
- 申请退款
- 退款查询
- 交易结算
- 关闭交易
- 账单下载地址查询
- 单笔转账到支付宝账户
API 说明
创建订单createOrder
生成二维码后,展示给用户,由用户扫描二维码完成订单支付
const service = new Alipay(options)
const data = {
subject: 'QQ充值中心',
out_trade_no: '1232423',
total_amount: '100'
}
const result = service.createNativeOrderURL(data)
创建网页订单createWebOrderURL
该接口用于支付宝手机网页支付,服务端调用该接口生成一个
URL
返回给客户端, 客户端拿到该URL
之后跳转到该URL发起支付请求。支付结束支付宝会跳转到客户端填写的return_url
。
const service = new Alipay(options)
const data = {
subject: '辣条',
out_trade_no: '1232423',
total_amount: '100'
}
const basicParams = {
return_url: 'http://xxx.com'
}
const result = service.createWebOrderURL(data, basicParams)
创建pc端订单createPageOrderURL
const service = new Alipay(options)
const data = {
subject: 'QQ充值中心',
out_trade_no: '1232423',
total_amount: '100'
}
const basicParams = {
return_url: 'http://xxx.com'
}
const result = service.createPageOrderURL(data, basicParams)
用于返回给APP,传递给支付宝端发起交易申请
const service = new Alipay(options)
const data = {
subject: 'QQ充值中心',
out_trade_no: '1232423',
total_amount: '100'
}
const result = service.createOrder(data)
订单查询queryOrder
const outTradeNo = '1232423'
return service.queryOrder({ out_trade_no: outTradeNo }).then(result => {\
// 结果
console.log(result)
})
取消订单cancelOrder
const outTradeNo = 'foobar'
return service.cancelOrder({ out_trade_no: outTradeNo }).then(result => {
// 结果
console.log(result)
})
验证支付结果verifyPayment
const params = {
memo: "xxxx",
result: "xxxx",
resultStatus: "xxx"
}
return utils.verifyPayment(params)
异步通知校验makeNotifyResponse
const params = {
sign: 'xxxxxxxx',
sign_type: 'xxxxx',
...
}
return service.makeNotifyResponse(params)
交易关闭tradeClose
const params = {
out_trade_no: 'xxxxx'
}
return service.tradeClose(params)
交易退款tradeRefund
const params = {
out_trade_no: 'xxxxx'
}
return service.tradeRefund(params)
交易退款查询tradeRefundQuery
const params = {
out_trade_no: 'xxxxx'
}
return service.tradeRefundQuery(params)
查询账单下载地址billDownloadQuery
const params = {
bill_type: 'trade',
bill_date: '2017-05-06'
}
return service.billDownloadQuery(params)
交易预创建tradePrecreate
const params = {
out_trade_no: 'xxx',
seller_id: 'asad',
total_amount: '231wawsda',
subject: '面包'
}
return service.tradePrecreate(params)
交易结算tradeSettle
const params = {
out_request_no: 'xxx'
}
return service.tradeSettle(params)
单笔转账到支付宝账户接口toaccountTransfer
const params = {
out_biz_no: "1234",
payee_type: 'ALIPAY_LOGONID',
payee_account: "user666",
amount: "100"
}
return service.toaccountTransfer(params)
LICENSE
1.0.1
3 years ago