@yunzhanghu/sdk-nodejs 1.0.9 → 1.0.11

package/.gitlab-ci.yml

@@ -0,0 +1,7 @@
+include:                                # include包含模板配置
+  - project: "laboratory/gitlab-ci"
+    ref: sdk-test
+    file: "/sdk-test.gitlab-ci.yml"
+
+
+image: docker.yunzhanghu.net/base/node18-sdk-unittest:v1.0.1

package/README.md

@@ -77,6 +77,7 @@ OpenSSL-> rsa -in private_key.pem -pubout -out pubkey.pem
 - [异步通知](./example/notify.js)
 - [对账文件获取](./example/dataService.js)
 - [发票开具](./example/invoice.js)
+- [个人所得税扣缴明细表](./example/tax.js)
 
 ### 示例
 

package/example/authentication.js

@@ -188,7 +188,7 @@ function parse(file) {
   return data
 }
 
-// 上传免验证用户名单信息
+// 上传非居民身份证验证名单信息
 authentication
   .UserExemptedInfo({
     
@@ -225,7 +225,7 @@ authentication
     console.log(err.toString())
   })
 
-// 查看免验证用户名单是否存在
+// 查看用户是否在非居民身份证验证名单中
 authentication
   .UserWhiteCheck({
     

package/example/payment.js

@@ -212,6 +212,28 @@ payment
     console.log('@@@@@@', err.toString())
   })
 
+// 重试挂起状态订单
+payment
+  .RetryOrder({
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
+    request_id: 'requestIdExample123456789',
+    dealer_id: config.dealer_id,
+    order_id: '202009010016562012987',
+    ref: '176826728298982',
+    channel: 'bankpay',
+  })
+  .then((data) => {
+    console.log('响应内容：', data)
+  })
+  .catch((err) => {
+    console.log('@@@@@@', err.toString())
+  })
+
 // 查询平台企业汇款信息
 payment
   .GetDealerVARechargeAccount({
@@ -239,6 +261,35 @@ payment
     console.log(err.toString())
   })
 
+// 用户结算金额校验
+payment
+  .CheckUserAmount({
+    
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
+    request_id: 'requestIdExample123456789',
+    broker_id: config.broker_id,
+    real_name: '张三',
+    id_card: '11010519491231002X',
+    amount: '10000.00',
+  })
+  .then((data) => {
+    if (data.code === '0000') {
+      // 操作成功
+      console.log('操作成功 ', data.data)
+    } else {
+      // 失败返回
+      console.log('失败返回 ', 'code：' + data.code + ' message：' + data.message + ' request_id：' + data.request_id)
+    } 
+  })
+  .catch((err) => {
+    // 发生异常
+    console.log(err.toString())
+  })
+
 // 批次下单
 payment
   .CreateBatchOrder({

package/example/tax.js

@@ -1,10 +1,10 @@
 const yzhAPI = require('../yzh/index.js')
 const config = require('./conf/config.js')
 
-// 个人所得税扣缴明细表
+// 个人所得税申报明细表
 const tax = new yzhAPI.TaxClient(config)
 
-// 下载个人所得税扣缴明细表
+// 下载个人所得税申报明细表
 tax
   .GetTaxFile({
     

package/example/uploadusersign.js

@@ -19,7 +19,6 @@ uploaduserSign
     real_name: '张三',
     id_card: '11010519491231002X',
     phone: '188****8888',
-    is_abroad: false,
     notify_url: 'https://www.example.com',
   })
   .then((data) => {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@yunzhanghu/sdk-nodejs",
-    "version": "1.0.9",
+    "version": "1.0.11",
     "description": "云账户 SDK for Node.js",
     "main": "yzh/index.js",
     "scripts": {
@@ -47,4 +47,4 @@
             "git add"
         ]
     }
-}
+}

package/src/common/client.ts

@@ -252,7 +252,7 @@ export class YZHClient {
             const { data: axiosData } = result;
             let response = axiosData;
             // 需解密
-            if (encryption) {
+            if (encryption && response?.data) {
                 response = { ...response, data: this.decrypt(response.data) };
             }
             return response;

package/src/services/authentication/index.ts

@@ -76,7 +76,7 @@ interface IDCardVerifyRequest {
 /** IDCardVerifyResponse 身份证实名验证返回 */
 interface IDCardVerifyResponse {}
 
-/** UserExemptedInfoRequest 上传免验证用户名单信息请求 */
+/** UserExemptedInfoRequest 上传非居民身份证验证名单信息请求 */
 interface UserExemptedInfoRequest {
     /** 证件类型码 */
     card_type: string;
@@ -104,13 +104,13 @@ interface UserExemptedInfoRequest {
     ref: string;
 }
 
-/** UserExemptedInfoResponse 上传免验证用户名单信息返回 */
+/** UserExemptedInfoResponse 上传非居民身份证验证名单信息返回 */
 interface UserExemptedInfoResponse {
     /** 是否上传成功 */
     ok: string;
 }
 
-/** UserWhiteCheckRequest 查看免验证用户名单是否存在请求 */
+/** UserWhiteCheckRequest 查看用户是否在非居民身份证验证名单中请求 */
 interface UserWhiteCheckRequest {
     /** 证件号码 */
     id_card: string;
@@ -118,7 +118,7 @@ interface UserWhiteCheckRequest {
     real_name: string;
 }
 
-/** UserWhiteCheckResponse 查看免验证用户名单是否存在返回 */
+/** UserWhiteCheckResponse 查看用户是否在非居民身份证验证名单中返回 */
 interface UserWhiteCheckResponse {
     ok: boolean;
 }
@@ -199,7 +199,7 @@ export class AuthenticationClient extends YZHclient {
         return this.request('post', '/authentication/verify-id', req, { encryption: false }, cb);
     }
 
-    // UserExemptedInfo 上传免验证用户名单信息
+    // UserExemptedInfo 上传非居民身份证验证名单信息
     async UserExemptedInfo(
         req: UserExemptedInfoRequest,
         cb?: (error: null | string, rep: UserExemptedInfoResponse) => void
@@ -207,7 +207,7 @@ export class AuthenticationClient extends YZHclient {
         return this.request('post', '/api/payment/v1/user/exempted/info', req, { encryption: false }, cb);
     }
 
-    // UserWhiteCheck 查看免验证用户名单是否存在
+    // UserWhiteCheck 查看用户是否在非居民身份证验证名单中
     async UserWhiteCheck(
         req: UserWhiteCheckRequest,
         cb?: (error: null | string, rep: UserWhiteCheckResponse) => void

package/src/services/payment/index.ts

@@ -229,6 +229,24 @@ interface CancelOrderResponse {
     ok: string;
 }
 
+/** RetryOrderRequest 重试挂起状态订单请求 */
+interface RetryOrderRequest {
+    /** 平台企业 ID */
+    dealer_id: string;
+    /** 平台企业订单号 */
+    order_id: string;
+    /** 综合服务平台流水号 */
+    ref: string;
+    /** 支付路径名 */
+    channel: string;
+}
+
+/** RetryOrderResponse 重试挂起状态订单返回 */
+interface RetryOrderResponse {
+    /** 请求标识 */
+    ok: string;
+}
+
 /** ListAccountRequest 查询平台企业余额请求 */
 interface ListAccountRequest {
     /** 平台企业 ID */
@@ -474,6 +492,26 @@ interface CancelBatchOrderRequest {
 /** CancelBatchOrderResponse 批次撤销返回 */
 interface CancelBatchOrderResponse {}
 
+/** CheckUserAmountRequest 用户结算金额校验请求 */
+interface CheckUserAmountRequest {
+    /** 综合服务主体 ID */
+    broker_id: string;
+    /** 姓名 */
+    real_name: string;
+    /** 身份证号码 */
+    id_card: string;
+    /** 校验金额 */
+    amount: string;
+}
+
+/** CheckUserAmountResponse 用户结算金额校验返回 */
+interface CheckUserAmountResponse {
+    /** 是否超过月限额 */
+    is_over_whole_user_month_quota: boolean;
+    /** 是否超过年限额 */
+    is_over_whole_user_year_quota: boolean;
+}
+
 export class PaymentClient extends YZHclient {
     // eslint-disable-next-line no-useless-constructor
     constructor(conf: {
@@ -560,6 +598,14 @@ export class PaymentClient extends YZHclient {
         return this.request('post', '/api/payment/v1/order/fail', req, { encryption: false }, cb);
     }
 
+    // RetryOrder 重试挂起状态订单
+    async RetryOrder(
+        req: RetryOrderRequest,
+        cb?: (error: null | string, rep: RetryOrderResponse) => void
+    ): Promise<RetryOrderResponse> {
+        return this.request('post', '/api/payment/v1/order/retry', req, { encryption: false }, cb);
+    }
+
     // CreateBatchOrder 批次下单
     async CreateBatchOrder(
         req: CreateBatchOrderRequest,
@@ -591,4 +637,12 @@ export class PaymentClient extends YZHclient {
     ): Promise<CancelBatchOrderResponse> {
         return this.request('post', '/api/payment/v1/cancel-batch', req, { encryption: false }, cb);
     }
+
+    // CheckUserAmount 用户结算金额校验
+    async CheckUserAmount(
+        req: CheckUserAmountRequest,
+        cb?: (error: null | string, rep: CheckUserAmountResponse) => void
+    ): Promise<CheckUserAmountResponse> {
+        return this.request('post', '/api/payment/v1/risk-check/amount', req, { encryption: false }, cb);
+    }
 }

package/src/services/tax/index.ts

@@ -1,6 +1,6 @@
 import YZHclient from '../../common/client';
 
-/** GetTaxFileRequest 下载个人所得税扣缴明细表请求 */
+/** GetTaxFileRequest 下载个人所得税申报明细表请求 */
 interface GetTaxFileRequest {
     /** 平台企业 ID */
     dealer_id: string;
@@ -10,7 +10,7 @@ interface GetTaxFileRequest {
     year_month: string;
 }
 
-/** GetTaxFileResponse 下载个人所得税扣缴明细表返回 */
+/** GetTaxFileResponse 下载个人所得税申报明细表返回 */
 interface GetTaxFileResponse {
     /** 文件详情 */
     file_info: FileInfo[];
@@ -60,7 +60,7 @@ export class TaxClient extends YZHclient {
         super(conf);
     }
 
-    // GetTaxFile 下载个人所得税扣缴明细表
+    // GetTaxFile 下载个人所得税申报明细表
     async GetTaxFile(
         req: GetTaxFileRequest,
         cb?: (error: null | string, rep: GetTaxFileResponse) => void

package/yzh/common/client.js

@@ -302,7 +302,7 @@ class YZHClient {
             const { data: axiosData } = result;
             let response = axiosData;
             // 需解密
-            if (encryption) {
+            if (encryption && (response === null || response === void 0 ? void 0 : response.data)) {
                 response = { ...response, data: this.decrypt(response.data) };
             }
             return response;

package/yzh/services/authentication/index.d.ts

@@ -75,7 +75,7 @@ interface IDCardVerifyRequest {
 /** IDCardVerifyResponse 身份证实名验证返回 */
 interface IDCardVerifyResponse {}
 
-/** UserExemptedInfoRequest 上传免验证用户名单信息请求 */
+/** UserExemptedInfoRequest 上传非居民身份证验证名单信息请求 */
 interface UserExemptedInfoRequest {
     /** 证件类型码 */
     card_type: string;
@@ -103,13 +103,13 @@ interface UserExemptedInfoRequest {
     ref: string;
 }
 
-/** UserExemptedInfoResponse 上传免验证用户名单信息返回 */
+/** UserExemptedInfoResponse 上传非居民身份证验证名单信息返回 */
 interface UserExemptedInfoResponse {
     /** 是否上传成功 */
     ok: string;
 }
 
-/** UserWhiteCheckRequest 查看免验证用户名单是否存在请求 */
+/** UserWhiteCheckRequest 查看用户是否在非居民身份证验证名单中请求 */
 interface UserWhiteCheckRequest {
     /** 证件号码 */
     id_card: string;
@@ -117,7 +117,7 @@ interface UserWhiteCheckRequest {
     real_name: string;
 }
 
-/** UserWhiteCheckResponse 查看免验证用户名单是否存在返回 */
+/** UserWhiteCheckResponse 查看用户是否在非居民身份证验证名单中返回 */
 interface UserWhiteCheckResponse {
     ok: boolean;
 }

package/yzh/services/authentication/index.js

@@ -27,11 +27,11 @@ class AuthenticationClient extends client_1.default {
     async IDCardVerify(req, cb) {
         return this.request('post', '/authentication/verify-id', req, { encryption: false }, cb);
     }
-    // UserExemptedInfo 上传免验证用户名单信息
+    // UserExemptedInfo 上传非居民身份证验证名单信息
     async UserExemptedInfo(req, cb) {
         return this.request('post', '/api/payment/v1/user/exempted/info', req, { encryption: false }, cb);
     }
-    // UserWhiteCheck 查看免验证用户名单是否存在
+    // UserWhiteCheck 查看用户是否在非居民身份证验证名单中
     async UserWhiteCheck(req, cb) {
         return this.request('post', '/api/payment/v1/user/white/check', req, { encryption: false }, cb);
     }

package/yzh/services/payment/index.d.ts

@@ -228,6 +228,24 @@ interface CancelOrderResponse {
     ok: string;
 }
 
+/** RetryOrderRequest 重试挂起状态订单请求 */
+interface RetryOrderRequest {
+    /** 平台企业 ID */
+    dealer_id: string;
+    /** 平台企业订单号 */
+    order_id: string;
+    /** 综合服务平台流水号 */
+    ref: string;
+    /** 支付路径名 */
+    channel: string;
+}
+
+/** RetryOrderResponse 重试挂起状态订单返回 */
+interface RetryOrderResponse {
+    /** 请求标识 */
+    ok: string;
+}
+
 /** ListAccountRequest 查询平台企业余额请求 */
 interface ListAccountRequest {
     /** 平台企业 ID */
@@ -473,6 +491,26 @@ interface CancelBatchOrderRequest {
 /** CancelBatchOrderResponse 批次撤销返回 */
 interface CancelBatchOrderResponse {}
 
+/** CheckUserAmountRequest 用户结算金额校验请求 */
+interface CheckUserAmountRequest {
+    /** 综合服务主体 ID */
+    broker_id: string;
+    /** 姓名 */
+    real_name: string;
+    /** 身份证号码 */
+    id_card: string;
+    /** 校验金额 */
+    amount: string;
+}
+
+/** CheckUserAmountResponse 用户结算金额校验返回 */
+interface CheckUserAmountResponse {
+    /** 是否超过月限额 */
+    is_over_whole_user_month_quota: boolean;
+    /** 是否超过年限额 */
+    is_over_whole_user_year_quota: boolean;
+}
+
 export declare class PaymentClient extends YZHclient {
     constructor(conf: {
         dealer_id: string;
@@ -517,6 +555,10 @@ export declare class PaymentClient extends YZHclient {
         req: CancelOrderRequest,
         cb?: (error: null | string, rep: CancelOrderResponse) => void
     ): Promise<CancelOrderResponse>;
+    RetryOrder(
+        req: RetryOrderRequest,
+        cb?: (error: null | string, rep: RetryOrderResponse) => void
+    ): Promise<RetryOrderResponse>;
     CreateBatchOrder(
         req: CreateBatchOrderRequest,
         cb?: (error: null | string, rep: CreateBatchOrderResponse) => void
@@ -533,6 +575,10 @@ export declare class PaymentClient extends YZHclient {
         req: CancelBatchOrderRequest,
         cb?: (error: null | string, rep: CancelBatchOrderResponse) => void
     ): Promise<CancelBatchOrderResponse>;
+    CheckUserAmount(
+        req: CheckUserAmountRequest,
+        cb?: (error: null | string, rep: CheckUserAmountResponse) => void
+    ): Promise<CheckUserAmountResponse>;
 }
 
 export {};

package/yzh/services/payment/index.js

@@ -45,6 +45,10 @@ class PaymentClient extends client_1.default {
     async CancelOrder(req, cb) {
         return this.request('post', '/api/payment/v1/order/fail', req, { encryption: false }, cb);
     }
+    // RetryOrder 重试挂起状态订单
+    async RetryOrder(req, cb) {
+        return this.request('post', '/api/payment/v1/order/retry', req, { encryption: false }, cb);
+    }
     // CreateBatchOrder 批次下单
     async CreateBatchOrder(req, cb) {
         return this.request('post', '/api/payment/v1/order-batch', req, { encryption: false }, cb);
@@ -61,5 +65,9 @@ class PaymentClient extends client_1.default {
     async CancelBatchOrder(req, cb) {
         return this.request('post', '/api/payment/v1/cancel-batch', req, { encryption: false }, cb);
     }
+    // CheckUserAmount 用户结算金额校验
+    async CheckUserAmount(req, cb) {
+        return this.request('post', '/api/payment/v1/risk-check/amount', req, { encryption: false }, cb);
+    }
 }
 exports.PaymentClient = PaymentClient;

package/yzh/services/tax/index.d.ts

@@ -1,5 +1,5 @@
 import YZHclient from '../../common/client';
-/** GetTaxFileRequest 下载个人所得税扣缴明细表请求 */
+/** GetTaxFileRequest 下载个人所得税申报明细表请求 */
 interface GetTaxFileRequest {
     /** 平台企业 ID */
     dealer_id: string;
@@ -9,7 +9,7 @@ interface GetTaxFileRequest {
     year_month: string;
 }
 
-/** GetTaxFileResponse 下载个人所得税扣缴明细表返回 */
+/** GetTaxFileResponse 下载个人所得税申报明细表返回 */
 interface GetTaxFileResponse {
     /** 文件详情 */
     file_info: FileInfo[];

package/yzh/services/tax/index.js

@@ -7,7 +7,7 @@ class TaxClient extends client_1.default {
     constructor(conf) {
         super(conf);
     }
-    // GetTaxFile 下载个人所得税扣缴明细表
+    // GetTaxFile 下载个人所得税申报明细表
     async GetTaxFile(req, cb) {
         return this.request('post', '/api/tax/v1/taxfile/download', req, { encryption: false }, cb);
     }