1.0.5 • Published 8 months ago

ga-payment-sdk v1.0.5

Weekly downloads
-
License
ISC
Repository
-
Last release
8 months ago

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 配置信息说明

参数类型是否必须描述默认值
envstring支付环境沙箱或线上环境,值为"sandbox""product"--
sign_typestring签名算法 "RSA""HMAC""RSA"
merchant_sign_keystring配置商户秘钥;RSA - 商户私钥 - 商户自己创建;HMAC - 连连提供的HMAC key---
ll_sign_keystring配置连连秘钥;RSA - 连连公钥 - 连连提供;HMAC - 连连提供的HMAC key---
merchant_idstring商户号 连连提供---
sub_merchant_idstring二级商户号 连连提供(若无则不填)---
is_print_logboolean控制台是否打印日志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_idsub_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);
1.0.5

8 months ago

1.0.4

8 months ago

1.0.2

9 months ago

1.0.3

9 months ago

1.0.1

2 years ago

1.0.0-beta.1

2 years ago