AlipayF2F-NodeJS

支付宝当面付NodeJS API.

如何使用

~~偷懒起见我就不提交到npm了, 如果您需要使用直接clone本项目即可.~~

今天打算提交到npm然后发现alipay-f2f这个名已经被占了, 所以使用alipay-ftof作为名字来发布.

安装方式:

npm install alipay-ftof

express-example为express的example项目, 您可以在config.js内修改好您的当面付配置信息后直接使用.

5分钟快速了解

目前已实现的功能

createQRPay: 预创建二维码支付宝订单, 当扫码后才是真创建订单.
verifyCallback: 支付宝回调验签.
checkInvoiceStatus: 查询订单状况.
createRefund: 订单退款.(guanbo)
openAuthTokenApp: ISV授权。

屁话多!如何使用?

您先需要准备一个Object对象内部存放alipay的配置如下:

// config.js

module.exports = {

	/* 以下信息可以在https://openhome.alipay.com/platform/appManage.htm查到, 不过merchantPrivateKey需要您自己生成 */

	/* 应用AppID */
	"appid": 0,

	/* 通知URL 接受支付宝异步通知需要用到  */
	"notifyUrl": "",

	/* 公钥 和 私钥 的填写方式 */
	"testPrivateKey": "-----BEGIN RSA PRIVATE KEY-----\n" +
		          "公钥或私钥内容..." +
		          "\n-----END RSA PRIVATE KEY-----",

	/* 应用RSA私钥 请勿忘记 -----BEGIN RSA PRIVATE KEY----- 与 -----END RSA PRIVATE KEY-----  */
	"merchantPrivateKey": "",

	/* 支付宝公钥 如果为注释掉会使用沙盒公钥 请勿忘记 -----BEGIN PUBLIC KEY----- 与 -----END PUBLIC KEY----- */
	"alipayPublicKey": "",
	
	/* 支付宝支付网关 如果为注释掉会使用沙盒网关 */
	"gatewayUrl": "",
};

注意！您需要生成RSA2公钥与私钥来配合本项目使用.

预创建订单

new一个alipayf2f对象并将刚刚的config.js传入

var alipay_f2f = new alipayf2f(require("./config.js"));

然后就能使用createQRPay肛出一个二维码来让用户扫了

alipay_f2f.createQRPay({
    tradeNo: "123",      // 必填 商户订单主键, 就是你要生成的
    subject: "女装",      // 必填 商品概要
    totalAmount: 0.5,    // 必填 多少钱
    body: "黑丝吊带小蜡烛", // 可选 订单描述, 可以对交易或商品进行一个详细地描述，比如填写"购买商品2件共15.00元"
    timeExpress: 5       // 可选 支付超时, 默认为5分钟
}).then(result => {
    console.log(result) // 支付宝返回的结果
}).catch(error => console.error(error));

如果一切都是理想情况, 支付宝应该会返回code为10000的一段这样JSON:

{
    "code":"10000",
    "msg":"Success",
    "out_trade_no":"123",
    "qr_code":"https://qr.alipay.com/bax09352lmfssonc0gzr0028"
}

这时您就可以直接把qr_code中的字符串进行二维码化然后直接给用户扫就可以了!

用户扫码并支付

当用户付款后支付宝会发一个post请求到您设置的notifyUrl.

你要想确认这个回调请求是不是支付宝的该如何判断? 不要慌有个方法叫verifyCallback就能帮您鉴别是不是支付宝发送的了!

假设我们现在使用的是express, 并且notifyUrl为http://example.com/callback

router.post("/callback", (req, res) => {
	/* 请勿改动支付宝回调过来的post参数, 否则会导致验签失败 */
	var signStatus = alipay_f2f.verifyCallback(req.body);
	if(signStatus === false) {
		return res.error("回调签名验证未通过");
	}

	/* 商户订单号 */
	var noInvoice = req.body["out_trade_no"];
	/* 订单状态 */
	var invoiceStatus = req.body["trade_status"];

	// 支付宝回调通知有多种状态您可以点击已下链接查看支付宝全部通知状态
	// https://doc.open.alipay.com/docs/doc.htm?spm=a219a.7386797.0.0.aZMdK2&treeId=193&articleId=103296&docType=1#s1
	if(invoiceStatus !== "TRADE_SUCCESS") {
		return res.send("success");
	}

	/* 一切都验证好后就能更新数据库里数据说用户已经付钱啦 */
	req.database.update(noInvoice, { pay: true }).then(result => res.send("success")).catch(err => res.catch(err));
});

需要注意的是当处理完支付宝回调后应当返回success来告诉支付宝我已经搞定了, 否则支付宝会重复通知防止掉单.

服务器网络暴毙? 没收到支付宝回调?

不要慌我给你实现了一个checkInvoiceStatus方法.

这个方法呢可以给你手动查询订单状态. 使用起来也很方便, 只需要传入一个商户订单号就行了:

alipay_f2f.checkInvoiceStatus("2333333").then(result => {
  console.log(result);
}).catch(error => { });

输出

{
    "code":"10000",
    "msg":"Success",
    "buyer_logon_id":"494***@qq.com",
    "buyer_pay_amount":"0.01",
    "buyer_user_id":"0000702210000000",
    "fund_bill_list":[
        {
            "amount":"0.01",
            "fund_channel":"ALIPAYACCOUNT"
        }
    ],
    "invoice_amount":"0.01",
    "open_id":"00001023939817879028820892810000",
    "out_trade_no":"alipayf2f_1481800000000",
    "point_amount":"0.00",
    "receipt_amount":"0.01",
    "send_pay_date":"2016-12-16 00:00:00",
    "total_amount":"0.01",
    "trade_no":"2016121621001000000000000000",
    "trade_status":"TRADE_SUCCESS"
}

退款

var refund = {
  tradeNo: payment.tradeNo,
  refundNo: Date.now(),
  refundAmount: payment.totalAmount
}
app.alipay_f2f.createRefund(refund).then(result => {
  result.should.have.property('code', '10000');
  result.should.have.property('refund_fee');
});

refundNo 部分退款时必传。

响应

{
  "code": "10000",
  "msg": "Success",
  "buyer_logon_id": "hya***@sandbox.com",
  "buyer_user_id": "2088102170322284",
  "fund_change": "Y",
  "gmt_refund_pay": "2017-02-06 17:46:34",
  "open_id": "20881013820906275677621172812028",
  "out_trade_no": "1486372683551",
  "refund_detail_item_list": [{
    "amount": "100.00",
    "fund_channel": "ALIPAYACCOUNT"
  }],
  "refund_fee": "100.00",
  "send_back_fee": "100.00",
  "trade_no": "2017020621001004280200150698"
}

授权

const bizContent = {
  grant_type: 'authorization_code',
  code: query.app_auth_code
};
app.alipay_f2f.openAuthTokenApp(bizContent).then(result => {
  result.should.have.property('app_auth_token');
  result.should.have.property('app_refresh_token');
  token = result;
  done();
}, done)

响应

{
    "alipay_open_auth_token_app_response": {
        "code": "10000",
        "msg": "Success",
        "app_auth_token": "201510BBb507dc9f5efe41a0b98ae22f01519X62",
        "app_refresh_token": "201510BB0c409dd5758b4d939d4008a525463X62",
        "auth_app_id": "2013111800001989",
        "expires_in": 31536000,
        "re_expires_in": 32140800,
        "user_id": "2088011177545623"
    },
    "sign": "TR5xJkWX65vRjwnNNic5n228DFuXGFOCW4isWxx5iLN8EuHoU2OTOeh1SOzRredhnJ6G9eOXFMxHWl7066KQqtyxVq2PvW9jm94QOuvx3TZu7yFcEhiGvAuDSZXcZ0sw4TyQU9+/cvo0JKt4m1M91/Quq+QLOf+NSwJWaiJFZ9k="
}

测试

make test

退款测试

支付环节需要人工介入，退款的测试需要调整下面的 ./test/test-f2f.js

var payment = {
  tradeNo: '1486372683551',
  subject: "女装",
  totalAmount: 100
}

describe.only('QRPay', function(){
....

describe.skip('Refund', function(){
...

设定tradeNo，每次不能重复。
make test
沙盒支付宝App扫码支付。
QRPay => describe.skip('QRPay', function(){
Refund => describe.only('Refund', function(){
make test

ISV授权

参考test/test-auth.js将拼装的url二维码。
mocha test/test-auth.js
沙盒支付宝扫码授权。

直接看看效果?

点这里然后我也不介意您给我5毛的(:

guanbo / AlipayF2F