1.0.5 • Published 8 months ago
ga-payment-sdk v1.0.5
ga-payment-sdk
连连全球支付 ga-payment-sdk for Node.js
一、安装
npm install ga-payment-sdk
二、使用说明
//引入ga-payment-sdk
const LLPaySdk = require('ga-payment-sdk');
//配置信息:
const config = {
env: 'sandbox', //支付环境'sandbox' | 'product';
sign_type: 'RSA', //签名算法 'RSA' | 'HMAC';
merchant_sign_key: '', //配置商户秘钥
ll_sign_key: '', // 配置连连秘钥
merchant_id: '', //商户号
sub_merchant_id: '', //二级商户号
is_print_log: true, //控制台是否打印日志
};
const LLPay = new LLPaySdk(config);
config 配置信息说明
参数 | 类型 | 是否必须 | 描述 | 默认值 |
---|---|---|---|---|
env | string | 是 | 支付环境沙箱或线上环境,值为"sandbox" 或"product" | -- |
sign_type | string | 否 | 签名算法 "RSA" 或 "HMAC" | "RSA" |
merchant_sign_key | string | 是 | 配置商户秘钥;RSA - 商户私钥 - 商户自己创建;HMAC - 连连提供的HMAC key | --- |
ll_sign_key | string | 是 | 配置连连秘钥;RSA - 连连公钥 - 连连提供;HMAC - 连连提供的HMAC key | --- |
merchant_id | string | 是 | 商户号 连连提供 | --- |
sub_merchant_id | string | 否 | 二级商户号 连连提供(若无则不填) | --- |
is_print_log | boolean | 否 | 控制台是否打印日志 | true |
三、方法说明
提供创单支付、退款、支付查询、退款查询、物流上传、支付取消、获取 iframe 支付 token、支付通知/退款通知解析的方法,开发者只需按如下调用示例说明调用即可。
目前已支持的接口,如 api 文档所示:https://doc.lianlianpay.com/doc-api/open-api/pay-order
SDK集成说明:SDK已经对加签验签逻辑做了封装,使用 SDK 时传入商户公钥等内容可直接通过SDK自动进行加验签,签名方法:加签验签详情参见:https://doc.lianlianpay.com/pay-guide/dev-ready/rule
注意:
1、调用方法中的params中的merchant_id
和sub_merchant_id
均不需传入,因为在实例化对象的config配置信息中已配置。2、接口请求成功回调的res:Object结构示例及说明:
{ "verifySignResult": true, //boolean,验签成功或失败 "verifySignMessage": "验签成功", //string,验签描述 "body": "{}" // json字符串,body其中的参数可参考各API文档出参 }
四、调用方法示例
创单支付调用示例
LLPay.pay({
params: {
//请求入参,参考API文档:https://doc.lianlianpay.com/doc-api/open-api/pay-order#%E5%85%A5%E5%8F%82
},
//成功回调
successcb: function (res) {
},
//失败回调
failcb: function (res) {
},
});
支付结果查询调用示例
LLPay.payResultQuery({
params: {
//请求入参,参考API文档:https://doc.lianlianpay.com/doc-api/open-api/pay-result#%E5%85%A5%E5%8F%82
},
//成功回调
successcb: function (res) {
},
//失败回调
failcb: function (res) {
},
});
退款调用示例
LLPay.refund({
params: {
//请求入参,参考API文档:https://doc.lianlianpay.com/doc-api/open-api/refund#%E5%85%A5%E5%8F%82
},
//成功回调
successcb: function (res) {
},
//失败回调
failcb: function (res) {
},
});
退款结果查询调用示例
LLPay.refundResultQuery({
params: {
//请求入参,参考 API文档:https://doc.lianlianpay.com/doc-api/open-api/refund-result#%E5%85%A5%E5%8F%82
},
//成功回调
successcb: function (res) {
},
//失败回调
failcb: function (res) {
},
});
支付取消调用示例
LLPay.payCancel({
params: {
//请求入参,参考API文档:https://doc.lianlianpay.com/doc-api/open-api/pay-cancel#%E5%85%A5%E5%8F%82
},
//成功回调
successcb: function (res) {
},
//失败回调
failcb: function (res) {
},
});
物流上传调用示例
LLPay.shipmentsUpload({
params: {
//请求入参,参考API文档:https://doc.lianlianpay.com/doc-api/open-api/logistics#%E5%85%A5%E5%8F%82
},
//成功回调
successcb: function (res) {
},
//失败回调
failcb: function (res) {
},
});
获取iframe支付token调用示例
LLPay.getTokenIframe({
//成功回调
successcb: function (res) {
},
//失败回调
failcb: function (res) {
},
});
支付/退款通知解析调用示例
/**
* @params body:String, 通知body,为json字符串
* @params header:{ [key: string]: string } 通知头部,类型为Object
* @return {Object}
* {
* verifySignResult: true | false, //验签结果
* verifySignMessage: '验签成功'|'验签失败',//验签成功或失败的描述
* body
* }
*
*/
LLPay.llNotice(body, header);