新增商户进件相关接口示例

example/jingjian_api/README.md

@@ -0,0 +1,78 @@
+# 进件相关 API 说明
+进件功能主要分：1. 查询商户信息  2. 新增商户进件
+
+### 查询商户信息
+查询商户信息就一个查询接口就完事了
+
+### 新增商户进件
+新增商户进件是由一系列相关 API 请求结果的汇总的数据构成的请求数据，然后把它提交，从而实现进件。以下大概说明下它是由哪些 API 的请求组成：
+
+1. 获取地区信息、银行列表查询、获取银行地区信息
+
+2. 电子合同申请接口、EC015合同参数说明（EC015合同参数说明是文档，对应电子合同申请接口的 ec_content_parameters 参数构成）
+
+3. 各照片的上传及照片文字信息的获取（涉及的文字信息有：营业执照、 身份证、 银行卡）
+
+4. 由以上接口获取到的数据组成表单数据为‘新增商户进件接口’所用，从而完成商户进件
+
+
+### 罗列接口
+
+目录下每个 `.php` 文件对应一个接口示例（`bootstrap.php` 为公共配置，非接口）。运行方式：`php <文件名>.php`。
+
+#### 1.1 商户进件
+
+| 示例文件 | 接口说明 | 接口路径 |
+| --- | --- | --- |
+| `customer-file-upload.php` | 商户进件文件上传 | `/api/v3/tkbs/customer/file/upload` |
+| `ec-apply.php` | 电子合同申请 | `/api/v3/mms/open_api/ec/apply` |
+| `ec-select.php` | 电子合同查询 | `/api/v3/mms/open_api/ec/q_status` |
+| `img-sup.php` | 照片补充 | `/api/v3/tkbs/open_merchant_img_sup` |
+| `merchant-encry.php` | 新增商户进件 | `/api/v3/tkbs/merchant_encry` |
+| `need-photo.php` | 查看当前商户是否需要照片补充 | `/api/v3/tkbs/open_merchant_need_photo` |
+| `ocr-result.php` | OCR 结果查询 | `/api/v3/tkbs/ocr_result` |
+| `reconsider-submit.php` | 复议提交 | `/api/v3/tkbs/open_merchant_reconsider_submit` |
+
+#### 1.2 进件相关信息查询
+
+| 示例文件 | 接口说明 | 接口路径 |
+| --- | --- | --- |
+| `bank.php` | 银行列表查询 | `/api/v3/tkbs/bank` |
+| `customer-category.php` | 商户类别查询 | `/api/v3/tkbs/customer_category` |
+| `customer-category-code-name.php` | 获取商户类别名称 | `/api/v3/tkbs/customer_category_code_name` |
+| `customer-category-parent-code.php` | 获取小类 | `/api/v3/tkbs/customer_category_parent_code` |
+| `organization-bank-parent-code.php` | 获取银行地区信息 | `/api/v3/tkbs/organization_bank_parent_code` |
+| `organization-parent-code.php` | 获取地区信息 | `/api/v3/tkbs/organization_parent_code` |
+
+#### 1.3 商户信息查询
+
+| 示例文件 | 接口说明 | 接口路径 |
+| --- | --- | --- |
+| `get-micro-term-list.php` | 获取已绑定终端信息 | `/api/v3/tkbs/open_merchant_get_microTermList` |
+| `merchant-info.php` | 获取商户信息 | `/api/v3/tkbs/open_merchant_info` |
+| `register-status-query.php` | 支付宝微信认证状态查询 | `/api/v3/tkbs/open_merchant_register_status_query` |
+| `terminal-info.php` | 获取终端信息 | `/api/v3/tkbs/open_terminal_info` |
+
+#### 1.3 商户信息变更
+
+| 示例文件 | 接口说明 | 接口路径 |
+| --- | --- | --- |
+| `add-shop-term-or-term.php` | 增网增终（400 商户） | `/api/v3/tkbs/open_merchant_addShopTermOrTerm` |
+| `add-term.php` | 增终进件 | `/api/v3/tkbs/open_merchant_addTerm` |
+| `change-shop-mms.php` | 修改网点（400 商户） | `/api/v3/tkbs/open_merchant_changeShopMms` |
+| `customer-update-review.php` | 商户审核状态查询 | `/api/v3/tkbs/customer_update_review` |
+| `get-fee-info.php` | 商户费率查询 | `/api/v3/tkbs/open_merchant_get_fee_info` |
+| `get-settle-info.php` | 商户结算信息查询 | `/api/v3/tkbs/open_merchant_get_settle_info_encry` |
+| `merchant-withdrawal.php` | D0 提额 | `/api/v3/tkbs/open_merchant_withdrawal` |
+| `open-or-update-foreign-card.php` | 外卡开通（支持修改外卡费率） | `/api/v3/tkbs/open_merchant/open_or_update_foreign_card` |
+| `supplement-business-license.php` | 商户变更-添加营业执照 | `/api/v3/tkbs/open_merchant_supplement_business_license_encry` |
+| `update-basic.php` | 商户基本信息变更 | `/api/v3/tkbs/open_merchant_update_basic_encry` |
+| `update-fee.php` | 商户费率变更 | `/api/v3/tkbs/open_merchant_update_fee` |
+| `update-settle.php` | 商户结算信息变更 | `/api/v3/tkbs/open_merchant_update_settle_encry` |
+
+#### 1.4 划款信息查询
+
+| 示例文件 | 接口说明 | 接口路径 |
+| --- | --- | --- |
+| `trans-transfer.php` | 划款交易查询 | `/api/v3/tkbs/open_trans_transfer` |
+| `trans-transfer-with-page.php` | 划款交易查询（分页） | `/api/v3/tkbs/open_trans_transferWithPage` |

example/jingjian_api/add-shop-term-or-term.php

@@ -0,0 +1,46 @@
+<?php
+/**
+ * 1.3 商户信息变更 -> 增网增终接口（400商户）
+ * 接口：/api/v3/tkbs/open_merchant_addShopTermOrTerm
+ * 请求加密：SM4   返回解密：SM4
+ * shop_id 为空走增店增终逻辑，不为空走增终逻辑
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'org_code' => JINGJIAN_ORG_CODE,
+    'merchant_no' => '8222240581208PS',
+    'customer_no' => '100134759',
+    'shop_id' => null,
+    'shop_name' => '5000015-xxxpro青橙哈哇哦',
+    'city_code' => '3610',
+    'city_name' => '合肥市',
+    'province_code' => '3600',
+    'province_name' => '安徽省',
+    'shop_dist_code' => '110010',
+    'shop_dist_name' => '东丽区',
+    'shop_addr' => '安徽省-合肥市-东丽区-空港环河北路76号333333',
+    'shop_contact_name' => '于丽',
+    'shop_contact_mobile' => '13516288004',
+    'term_num' => 1,
+    'bz_pos' => 'WECHAT_PAY',
+    'fees' => [
+        ['fee' => 0.45, 'fee_type' => 'DEBIT_CARD', 'top_fee' => 20],
+        ['fee' => 0.6, 'fee_type' => 'CREDIT_CARD'],
+    ],
+    'attachments' => [],
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_addShopTermOrTerm', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/add-term.php

@@ -0,0 +1,34 @@
+<?php
+/**
+ * 1.3 商户信息变更 -> 增终进件
+ * 接口：/api/v3/tkbs/open_merchant_addTerm
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'merchant_no' => '8222240581208PS',
+    'bz_pos' => 'WECHAT_PAY',
+    'term_num' => 1,
+    'shop_id' => '954008657464496128',
+    'org_code' => JINGJIAN_ORG_CODE,
+    'fees' => [
+        ['fee' => 0.38, 'top_fee' => 20, 'fee_type' => 'DEBIT_CARD'],
+        ['fee' => 0.6, 'fee_type' => 'CREDIT_CARD'],
+    ],
+    'attachments' => [],
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_addTerm', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/bank.php

@@ -0,0 +1,27 @@
+<?php
+/**
+ * 1.2 进件相关信息查询 -> 银行列表查询
+ * 接口：/api/v3/tkbs/bank
+ * 请求加密：无   返回解密：无
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::NONE);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'org_code' => JINGJIAN_ORG_CODE,
+    'area_code' => '1000',
+    'bank_name' => '',
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/bank', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/bootstrap.php

@@ -0,0 +1,30 @@
+<?php
+/**
+ * 拉卡拉进件接口测试脚本 - 公共引导文件
+ *
+ * 使用数组方式构造 Configuration，避免改动 v3/src/.lklopensdk.env，
+ * 参数取自进件「2-接入测试参数」。各测试脚本 require 本文件后即可获得 $config。
+ */
+
+require_once __DIR__ . '/../../vendor/autoload.php';
+
+// 进件测试公共业务参数
+const JINGJIAN_ORG_CODE = '1951582';   // 机构编号（鉴权机构）
+const JINGJIAN_USER_NO  = '29153396';  // 商户归属用户信息 user_no
+
+$config = new \Lakala\OpenAPISDK\V3\Configuration([
+    'app_debug' => 'true',
+    // 主机地址
+    'host_test' => 'https://test.wsmsd.cn/sit',
+    'host_pro'  => 'https://s2.lakala.com',
+    // 接入方身份
+    'app_id'    => 'OP00000003',
+    'serial_no' => '00dfba8194c41b84cf',
+    // 国密4 SM4Key（进件测试参数）
+    'sm4_key'   => 'LHo55AjrT4aDhAIBZhb5KQ==',
+    // 证书路径（绝对路径，数组构造不会自动 realpath）
+    'merchant_private_key_path' => __DIR__ . '/../RSAKeys/DEV/OP00000003_private_key.pem',
+    'lkl_certificate_path'      => __DIR__ . '/../RSAKeys/DEV/lkl-apigw-v2.cer',
+]);
+
+return $config;

example/jingjian_api/change-shop-mms.php

@@ -0,0 +1,39 @@
+<?php
+/**
+ * 1.3 商户信息变更 -> 修改网点接口（400商户）
+ * 接口：/api/v3/tkbs/open_merchant_changeShopMms
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'shop_id' => '954008657464496128',
+    'merchant_no' => '8222240581208PS',
+    'customer_no' => '100136126',
+    'shop_name' => '测试商户验证',
+    'shop_addr' => '庐阳区庐阳大道未知编号',
+    'province_code' => '3600',
+    'province_name' => '安徽省',
+    'city_code' => '3610',
+    'city_name' => '合肥市',
+    'shop_dist_code' => '3617',
+    'shop_dist_name' => '庐阳区',
+    'shop_contact_name' => '王三才',
+    'shop_contact_mobile' => '18835678956',
+    'review_related_id' => '',
+    'org_code' => JINGJIAN_ORG_CODE,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_changeShopMms', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/customer-category-code-name.php

@@ -0,0 +1,26 @@
+<?php
+/**
+ * 1.2 进件相关信息查询 -> 获取商户类别名称
+ * 接口：/api/v3/tkbs/customer_category_code_name
+ * 请求加密：无   返回解密：无
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::NONE);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'code' => '5943',
+    'org_code' => JINGJIAN_ORG_CODE,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/customer_category_code_name', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/customer-category-parent-code.php

@@ -0,0 +1,26 @@
+<?php
+/**
+ * 1.2 进件相关信息查询 -> 获取小类
+ * 接口：/api/v3/tkbs/customer_category_parent_code
+ * 请求加密：无   返回解密：无
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::NONE);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'parent_code' => '10001',
+    'org_code' => JINGJIAN_ORG_CODE,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/customer_category_parent_code', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/customer-category.php

@@ -0,0 +1,26 @@
+<?php
+/**
+ * 1.2 进件相关信息查询 -> 商户类别查询
+ * 接口：/api/v3/tkbs/customer_category
+ * 请求加密：无   返回解密：无
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::NONE);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'org_code' => JINGJIAN_ORG_CODE,
+    'business_scene' => 1,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/customer_category', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/customer-file-upload.php

@@ -0,0 +1,33 @@
+<?php
+/**
+ * 1.1 商户进件 -> 商户进件文件上传
+ * 接口：/api/v3/tkbs/customer/file/upload
+ * 请求加密：否   返回解密：否
+ * 注意：官方建议使用 PNG 格式，file_base64 需带解析头 data:image/png;base64,
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::NONE);
+
+$data = file_get_contents(__DIR__ . '/../v2/business_licence.jpg');
+$fileBase64 = 'data:image/png;base64,' . base64_encode($data);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'file_base64' => $fileBase64,
+    'img_type' => 'BUSINESS_LICENCE', //'ID_CARD_FRONT',
+    'prefix' => 'reg',
+    'sourcechnl' => 0,
+    'is_ocr' => 'true', //'false'
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/customer/file/upload', $request);
+    print_r($response->getRespData());
+    // echo $response->getCode();
+    // print_r($response->getHeaders());
+    echo $response->getOriginalText(); // {"code":"000000","msg":"SUCCESS","resp_data":{"batch_no":"06023920260611001616220000","status":"01","url":"merchant/reg/20260611161936327518BUSINESS_LICENCE.jpeg","show_url":null}}%   
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/customer-update-review.php

@@ -0,0 +1,26 @@
+<?php
+/**
+ * 1.3 商户信息变更 -> 商户审核状态查询
+ * 接口：/api/v3/tkbs/customer_update_review
+ * 请求加密：无   返回解密：无
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::NONE);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'review_related_id' => '92463359336737',
+    'org_code' => JINGJIAN_ORG_CODE,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/customer_update_review', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/ec-apply.php

@@ -0,0 +1,243 @@
+<?php
+/**
+ * 1.1 商户进件 -> 电子合同申请
+ * 接口：/api/v3/mms/open_api/ec/apply
+ * 请求加密：无   返回解密：无
+ *
+ * 说明：电子合同签约成功后，将返回的电子合同号（ecNo）填入「新增商户进件」接口的
+ *       contract_no 字段即可，此编号与 AGREE_MENT 附件二选一。
+ *       ec_content_parameters 为按合同类别(ec_type_code)传递的 JSON 字符串参数集合。
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::NONE);
+
+// 电子合同内容参数集合（EC015 全量文本域，编码含义参见「EC015合同参数说明」；
+// 不涉及的业务/费率文本域统一以 "/" 占位，符合文档「横线处填 /」规范）
+$ecContentParameters = json_encode([
+    // ===== A 系列：合作协议（业务功能 / 费率 / 结算 / 签约信息）=====
+    'A1' => '拉卡拉科技有限公司',                   // 签约商户的商户名称
+    'A2' => '是',                                  // 业务功能：消费类
+    'A3' => '/',                                   // 业务功能：预授权类
+    'A4' => '/',                                   // 业务功能：其他
+    'A5' => '/',                                   // 业务功能（其他）填写信息
+    'A6' => '是',                                  // 收单借记卡：选择
+    'A7' => '0.50',                               // 收单借记卡：费率
+    'A8' => '20',                                 // 收单借记卡：封顶值
+    'A9' => '是',                                  // 收单贷记卡：选择
+    'A10' => '0.60',                              // 收单贷记卡：费率
+    'A11' => '是',                                 // 银联二维码借记：选择
+    'A12' => '0.38',                              // 银联二维码借记：费率
+    'A13' => '是',                                 // 银联二维码贷记：选择
+    'A14' => '0.38',                              // 银联二维码贷记：1000元以下费率
+    'A15' => '0.60',                              // 银联二维码贷记：1000元以上费率
+    'A16' => '/',                                  // 外卡业务功能：消费类
+    'A17' => '/',                                  // 外卡业务功能：预授权类
+    'A18' => '/',                                  // 外卡业务功能：其他
+    'A19' => '/',                                  // 外卡业务功能（其他）填写信息
+    'A20' => '/', 'A21' => '/',                    // 外卡VISA：DCC / 非DCC 费率
+    'A22' => '/', 'A23' => '/',                    // 外卡MasterCard：DCC / 非DCC 费率
+    'A24' => '/', 'A25' => '/',                    // 外卡American Express：DCC / 非DCC 费率
+    'A26' => '/', 'A27' => '/',                    // 外卡Diners：DCC / 非DCC 费率
+    'A28' => '/', 'A29' => '/',                    // 外卡Discover：DCC / 非DCC 费率
+    'A30' => '/', 'A31' => '/',                    // 外卡JCB：DCC / 非DCC 费率
+    'A32' => '/', 'A33' => '/',                    // 外卡其他类：DCC / 非DCC 费率
+    'A34' => '0.38',                              // 扫码支付：支付宝费率
+    'A35' => '0.38',                              // 扫码支付：微信费率
+    'A36' => '/',                                  // 扫码支付：京东费率
+    'A37' => '/',                                  // 扫码支付：拉卡拉钱包费率
+    'A38' => '/',                                  // 扫码支付：数字人民币费率
+    'A39' => '/',                                  // 扫码支付：（其他）填写信息
+    'A40' => '/',                                  // 业务功能：单笔代付选择
+    'A41' => '/', 'A42' => '/', 'A43' => '/',     // 单笔代付：费率 / 封顶值 / 下限阈值
+    'A44' => '/',                                  // 业务功能：批量代付选择
+    'A45' => '/', 'A46' => '/', 'A47' => '/',     // 批量代付：费率 / 封顶值 / 下限阈值
+    'A48' => '/',                                  // 业务功能：银联线上统一收银台选择
+    'A49' => '/', 'A50' => '/',                    // 银联线上统一收银台：借记 / 贷记费率
+    'A51' => '/',                                  // 业务功能：无跳转支付选择
+    'A52' => '/', 'A53' => '/', 'A54' => '/',     // 无跳转支付：借记费率 / 借记封顶 / 贷记费率
+    'A55' => '/',                                  // 业务功能：云微小程序选择
+    'A56' => '/', 'A57' => '/', 'A58' => '/',     // 云微小程序：借记费率 / 借记封顶 / 贷记费率
+    'A59' => '/',                                  // 业务功能：B2B订单选择
+    'A60' => '/', 'A61' => '/', 'A62' => '/',     // B2B订单：费率 / 封顶 / 下限阈值
+    'A63' => '是',                                 // 业务功能：微信支付选择
+    'A64' => '0.38',                              // 微信支付：手续费费率
+    'A65' => '是',                                 // 业务功能：支付宝支付选择
+    'A66' => '0.38',                              // 支付宝支付：手续费费率
+    'A67' => '/',                                  // 业务功能：银联代收/网联商委选择
+    'A68' => '/', 'A69' => '/', 'A70' => '/',     // 银联代收/网联商委借记：费率 / 封顶 / 下限阈值
+    'A71' => '/', 'A72' => '/', 'A73' => '/',     // 银联代收/网联商委贷记：费率 / 封顶 / 下限阈值
+    'A74' => '/',                                  // 业务功能：快捷/协议支付选择
+    'A75' => '/', 'A76' => '/', 'A77' => '/',     // 快捷/协议支付借记：费率 / 封顶 / 下限阈值
+    'A78' => '/', 'A79' => '/', 'A80' => '/',     // 快捷/协议支付贷记：费率 / 封顶 / 下限阈值
+    'A81' => '/',                                  // 业务功能：网银B2B选择
+    'A82' => '/', 'A83' => '/', 'A84' => '/', 'A85' => '/', // 网银B2B：单笔 / 费率 / 封顶 / 下限阈值
+    'A86' => '/',                                  // 业务功能：网银B2C选择
+    'A87' => '/', 'A88' => '/', 'A89' => '/',     // 网银B2C借记：费率 / 封顶 / 下限阈值
+    'A90' => '/', 'A91' => '/', 'A92' => '/',     // 网银B2C贷记：费率 / 封顶 / 下限阈值
+    'A93' => '/',                                  // 业务功能：签约支付选择
+    'A94' => '/', 'A95' => '/', 'A96' => '/',     // 签约支付借记：费率 / 封顶 / 下限阈值
+    'A97' => '/', 'A98' => '/', 'A99' => '/',     // 签约支付贷记：费率 / 封顶 / 下限阈值
+    'A100' => '/',                                 // 大额付款：收单手续费支付方式选择
+    'A101' => '/', 'A102' => '/',                  // 大额付款：费率 / 封顶
+    'A103' => '/', 'A104' => '/', 'A105' => '/',  // 大额付款：对私费率 / 对私封顶 / 对公单笔
+    'A106' => '/',                                 // 快速结算业务：手续费费率
+    'A107' => '/', 'A108' => '/',                  // 定时结算：预计到账时间 / 手续费费率
+    'A109' => '/',                                 // 通讯服务：终端运营服务费金额
+    'A110' => '/', 'A111' => '/',                  // 通讯服务费支付方式：线上 / 线下
+    'A112' => '/', 'A113' => '/',                  // 平台系统服务：收取接入费限定天数 / 接入费用
+    'A114' => '/', 'A115' => '/',                  // 平台系统服务：维护年费 / 期满支付维护年费限定天数
+    'A116' => '自动结算',                          // 默认结算模式选择
+    'A117' => '是', 'A118' => '/',                 // 退货业务：开通 / 不开通
+    'A119' => '/', 'A120' => '是',                 // 数字人民币业务：开通 / 不开通
+    'A121' => '广西柳州市',                        // 终端使用地区
+    'A122' => '/',                                 // 接入平台法律主体
+    'A123' => '/',                                 // 平台名称/APP名称
+    'A124' => 2026, 'A125' => 6, 'A126' => 12,    // 甲方签约 年/月/日
+    'A127' => 2026, 'A128' => 6, 'A129' => 12,    // 乙方签约 年/月/日
+    'A130' => '拉卡拉科技有限公司',                // 甲方电子签名/签字/盖章
+
+    // ===== B 系列：商户注册登记 / 基本信息 / 结算账户 / 法人联系人 / 终端 / 拓展 =====
+    'B1' => 2026, 'B2' => 6,                       // 商户注册登记表 年/月
+    'B3' => '是',                                  // 登记类型：增商选择
+    'B4' => '/',                                   // 登记类型：增终选择
+    'B5' => '/',                                   // 登记类型：续约选择
+    'B6' => '/',                                   // 登记类型：商户更名选择
+    'B7' => '/',                                   // 商户更名前的原名称
+    'B8' => '拉卡拉科技有限公司',                  // 基本信息：工商注册名称（中英文）
+    'B9' => '未列入其他代码的食品商店',            // 基本信息：主营业务
+    'B10' => '拉卡拉科技有限公司',                 // 基本信息：对外经营名称（中英文）
+    'B11' => '/',                                  // 基本信息：网站地址
+    'B12' => '/',                                  // 基本信息：商户简称（互联网支付）
+    'B13' => '广西柳州市解放南路金鱼巷1号',        // 基本信息：办公地址
+    'B14' => '90000000MA1FPFRF44',                // 基本信息：营业执照注册号
+    'B15' => '/',                                  // 基本信息：交易IP地址
+    'B16' => '是',                                 // 结算账户名称：同工商注册名称选择
+    'B17' => '/',                                  // 结算账户名称：其他名称选择
+    'B18' => '/',                                  // 结算账户名称：其他名称填写
+    'B19' => '招商银行股份有限公司柳州分行',            // 开户行（含支行）
+    'B20' => '6221884568549653222',               // 结算账号
+    'B21' => 'yhws@psbc-ubank.com',               // 对账单投递邮箱
+    'B22' => '/',                                  // 数字人民币开户行
+    'B23' => '/',                                  // 数字人民币钱包名称（如开通）
+    'B24' => '徐文',                               // 法定代表人/负责人姓名
+    'B25' => '431003198708066555',                  // 法人证件号码
+    'B26' => '18259179840',                       // 法定代表人/负责人手机
+    'B27' => '徐文',                               // 联系人姓名
+    'B28' => 'yhws@psbc-ubank.com',               // 联系人邮箱
+    'B29' => '431003198708066555',                  // 联系人证件号码
+    'B30' => '18259179840',                       // 联系人手机号
+    'B31' => '拉卡拉科技有限公司',                 // 分店营业名称（中英文）
+    'B32' => '徐文',                               // 网点联系人姓名
+    'B33' => '广西柳州市解放南路金鱼巷1号',        // 终端布放地址（中英文）
+    'B34' => '18259179840',                       // 网点联系人手机号
+    'B35' => '/',                                  // 签约单名称（中英文）
+    'B36' => '1',                                  // 申请台数
+    'B37' => '是',                                 // 终端类型：智能POS选择
+    'B38' => '/',                                  // 终端类型：传统POS选择
+    'B39' => '/',                                  // 终端类型：超级收款宝选择
+    'B40' => '/',                                  // 终端类型：微智能选择
+    'B41' => '/',                                  // 终端类型：一体化终端选择
+    'B42' => '/',                                  // 终端类型：蓝精灵选择
+    'B43' => '/',                                  // 终端类型：码牌音箱选择
+    'B44' => '/',                                  // 终端类型：自定义选择
+    'B45' => '/',                                  // 终端类型：自定义填写
+    'B46' => '是',                                 // 终端通讯方式：网络选择
+    'B47' => '/',                                  // 终端通讯方式：移动通讯卡选择
+    'B48' => '/',                                  // 终端通讯方式：自定义选择
+    'B49' => '/',                                  // 终端通讯方式：自定义填写
+    'B50' => '是',                                 // 拓展信息：直营拓展选择
+    'B51' => '/',                                  // 拓展信息：行业合作选择
+    'B52' => '/',                                  // 拓展信息：代理选择
+    'B53' => '/',                                  // 拓展信息：银行推荐选择
+    'B54' => '/',                                  // 拓展信息：其他选择
+    'B55' => '/',                                  // 拓展信息：其他填写
+    'B56' => '/',                                  // 拓展信息：发展方
+    'B57' => '/',                                  // 拓展信息：发展人
+    'B58' => '/',                                  // 终端型号填写
+
+    // ===== C 系列：受益人 / 高级管理层 / 董事会 / 控制人（非企业商户不涉及，统一占位 "/"）=====
+    'C1' => '/', 'C2' => '/', 'C3' => '/', 'C4' => '/', 'C5' => '/', 'C6' => '/',        // 受益人1
+    'C7' => '/', 'C8' => '/', 'C9' => '/', 'C10' => '/', 'C11' => '/', 'C12' => '/',     // 受益人2
+    'C13' => '/', 'C14' => '/', 'C15' => '/', 'C16' => '/', 'C17' => '/', 'C18' => '/',  // 高管1
+    'C19' => '/', 'C20' => '/', 'C21' => '/', 'C22' => '/', 'C23' => '/', 'C24' => '/',  // 高管2
+    'C25' => '/', 'C26' => '/', 'C27' => '/', 'C28' => '/', 'C29' => '/', 'C30' => '/',  // 董事会成员1
+    'C31' => '/', 'C32' => '/', 'C33' => '/', 'C34' => '/', 'C35' => '/', 'C36' => '/',  // 董事会成员2
+    'C37' => '/', 'C38' => '/', 'C39' => '/', 'C40' => '/', 'C41' => '/',                // 其他控制成员1
+    'C42' => '/', 'C43' => '/', 'C44' => '/', 'C45' => '/', 'C46' => '/',                // 其他控制成员2
+    'C47' => '/', 'C48' => '/', 'C49' => '/', 'C50' => '/', 'C51' => '/',                // 超25%合伙权益自然人1
+    'C52' => '/', 'C53' => '/', 'C54' => '/', 'C55' => '/', 'C56' => '/',                // 超25%合伙权益自然人2
+
+    // ===== D 系列：各类授权书 =====
+    'D1' => '招商银行',                            // 授权书（银行）：结算账户所属银行
+    'D2' => '徐文',                                // 授权书（银行）：授权承诺方签字
+    'D3' => '2026/06/12',                          // 授权书（银行）：签章/签字日期
+    'D4' => '徐文',                                // 授权书（开通微信、支付宝收单）：承诺授权方签名
+    'D5' => '2026/06/12',                          // 授权书（开通微信、支付宝收单）：盖章/签字日期
+    'D6' => '/',                                   // 授权书（数据处理方）：数据处理方名称
+    'D7' => '/',                                   // 授权书（数据处理方）：联系方式
+    'D8' => '/',                                   // 授权书（数据处理方）：承诺授权方签名
+    'D9' => '/',                                   // 授权书（数据处理方）：签章/签字日期
+    'D10' => '/', 'D11' => '/',                    // 授权书（外卡业务）：签名 / 日期
+    'D12' => '/', 'D13' => '/',                    // 授权书（开通MOSS产品）：签名 / 日期
+    'D14' => '/', 'D15' => '/',                    // 授权书（开通青橙产品）：签名 / 日期
+    'D16' => '/', 'D17' => '/',                    // 授权书（邮政项目）：签名 / 日期
+
+    // ===== E 系列：分银行费率明细（费率一致则不填，统一占位 "/"）=====
+    'E1' => '/', 'E2' => '/', 'E3' => '/', 'E4' => '/',         // 银联代收/网联商委借记卡 银行1
+    'E5' => '/', 'E6' => '/', 'E7' => '/', 'E8' => '/',         // 银联代收/网联商委借记卡 银行2
+    'E9' => '/', 'E10' => '/', 'E11' => '/',                    // 银联代收/网联商委借记卡 其他银行
+    'E12' => '/', 'E13' => '/', 'E14' => '/', 'E15' => '/',     // 银联代收/网联商委贷记卡 银行1
+    'E16' => '/', 'E17' => '/', 'E18' => '/', 'E19' => '/',     // 银联代收/网联商委贷记卡 银行2
+    'E20' => '/', 'E21' => '/', 'E22' => '/',                   // 银联代收/网联商委贷记卡 其他银行
+    'E23' => '/', 'E24' => '/', 'E25' => '/', 'E26' => '/',     // 快捷/协议/签约支付借记卡 银行1
+    'E27' => '/', 'E28' => '/', 'E29' => '/', 'E30' => '/',     // 快捷/协议/签约支付借记卡 银行2
+    'E31' => '/', 'E32' => '/', 'E33' => '/',                   // 快捷/协议/签约支付借记卡 其他银行
+    'E34' => '/', 'E35' => '/', 'E36' => '/', 'E37' => '/',     // 快捷/协议/签约支付贷记卡 银行1
+    'E38' => '/', 'E39' => '/', 'E40' => '/', 'E41' => '/',     // 快捷/协议/签约支付贷记卡 银行2
+    'E42' => '/', 'E43' => '/', 'E44' => '/',                   // 快捷/协议/签约支付贷记卡 其他银行
+    'E45' => '/', 'E46' => '/', 'E47' => '/', 'E48' => '/',     // 网银B2B企业账户 银行1
+    'E49' => '/', 'E50' => '/', 'E51' => '/', 'E52' => '/',     // 网银B2B企业账户 银行2
+    'E53' => '/', 'E54' => '/', 'E55' => '/',                   // 网银B2B企业账户 其他银行
+    'E56' => '/', 'E57' => '/', 'E58' => '/', 'E59' => '/',     // 网银B2C借记卡 银行1
+    'E60' => '/', 'E61' => '/', 'E62' => '/', 'E63' => '/',     // 网银B2C借记卡 银行2
+    'E64' => '/', 'E65' => '/', 'E66' => '/',                   // 网银B2C借记卡 其他银行
+    'E67' => '/', 'E68' => '/', 'E69' => '/', 'E70' => '/',     // 网银B2C贷记卡 银行1
+    'E71' => '/', 'E72' => '/', 'E73' => '/', 'E74' => '/',     // 网银B2C贷记卡 银行2
+    'E75' => '/', 'E76' => '/', 'E77' => '/',                   // 网银B2C贷记卡 其他银行
+    'E78' => '徐文',                               // 电子签约服务授权委托书：承诺授权方签名
+    'E79' => '徐文',                               // 电子签约服务授权委托书：承诺签名或盖章
+], JSON_UNESCAPED_UNICODE);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'order_no' => date('YmdHis', time()) . substr(str_shuffle('01234567890'), 0, 8),
+    'org_id' => (int) JINGJIAN_ORG_CODE,
+    'ec_type_code' => 'EC015',
+    'cert_type' => 'RESIDENT_ID',
+    'cert_name' => '徐文',
+    'cert_no' => '431003198708066555',
+    'mobile' => '18259179840',
+    'business_license_no' => '90000000MA1FPFRF44',
+    'business_license_name' => '拉卡拉科技有限公司',
+    'openning_bank_code' => '403100000004',
+    'openning_bank_name' => '招商银行',
+    'acct_type_code' => '57',
+    'acct_no' => '6221884568549653222',
+    'acct_name' => '农建',
+    'ec_content_parameters' => $ecContentParameters,
+    'remark' => '测试'
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/mms/open_api/ec/apply', $request);
+    print_r($response->getRespData());
+    // echo $response->getCode();
+    // print_r($response->getHeaders());
+    echo $response->getOriginalText();
+    // {"code":"000000","msg":"成功","resp_data":{"order_no":"2026061208203432970480","ec_apply_id":1117850953870880768,"result_url":"https://jrt.wsmsd.cn/signature/s/yxkusph1inogzv2f?rdm=1781252444861"}}
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}
+

example/jingjian_api/ec-select.php

@@ -0,0 +1,28 @@
+<?php
+/**
+ * 1.1 商户进件 -> 电子合同查询
+ * 接口：/api/v3/mms/open_api/ec/q_status
+ * 请求加密：无   返回解密：无
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::NONE);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'ec_apply_id' => '1117850953870880768',
+    'order_no' => '2026061208203432970480',
+    'org_code' => (int) JINGJIAN_ORG_CODE
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/mms/open_api/ec/q_status', $request);
+    print_r($response->getRespData());
+    // echo $response->getCode();
+    // print_r($response->getHeaders());
+    echo $response->getOriginalText();
+    // {"code":"000000","msg":"成功","resp_data":{"order_no":"2026061208203432970480","ec_apply_id":1117850953870880768,"ec_status":"COMPLETED","ec_no":"QY20260612602507265"}}
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/get-fee-info.php

@@ -0,0 +1,27 @@
+<?php
+/**
+ * 1.3 商户信息变更 -> 商户费率查询
+ * 接口：/api/v3/tkbs/open_merchant_get_fee_info
+ * 请求加密：无   返回解密：无
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::NONE);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'customer_no' => '100130263',
+    'product_code' => null,
+    'org_code' => JINGJIAN_ORG_CODE,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_get_fee_info', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/get-micro-term-list.php

@@ -0,0 +1,26 @@
+<?php
+/**
+ * 1.3 商户信息查询 -> 获取已绑定终端信息
+ * 接口：/api/v3/tkbs/open_merchant_get_microTermList
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'merchant_no' => '8224910581208R7',
+    'org_code' => JINGJIAN_ORG_CODE,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_get_microTermList', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/get-settle-info.php

@@ -0,0 +1,27 @@
+<?php
+/**
+ * 1.3 商户信息变更 -> 商户结算信息查询
+ * 接口：/api/v3/tkbs/open_merchant_get_settle_info_encry
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'customer_no' => '100130263',
+    'review_related_id' => null,
+    'org_code' => JINGJIAN_ORG_CODE,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_get_settle_info_encry', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/img-sup.php

@@ -0,0 +1,38 @@
+<?php
+/**
+ * 1.1 商户进件 -> 照片补充
+ * 接口：/api/v3/tkbs/open_merchant_img_sup
+ * 请求加密：无   返回解密：无
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::NONE);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'merchant_no' => '822191070110011',
+    'org_code' => JINGJIAN_ORG_CODE,
+    'attachments' => [
+        [
+            'img_path' => 'merchant/null/20230616093253148380SHOP_OUTSIDE_IMG.jpg',
+            'img_type' => 'SHOP_OUTSIDE_IMG',
+            'openplatform_id' => '',
+        ],
+        [
+            'img_path' => 'merchant/null/20230616093253148380SHOP_INSIDE_IMG.jpg',
+            'img_type' => 'SHOP_INSIDE_IMG',
+            'openplatform_id' => '',
+        ],
+    ],
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_img_sup', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/merchant-encry.php

@@ -0,0 +1,83 @@
+<?php
+/**
+ * 1.1 商户进件 -> 新增商户进件
+ * 接口：/api/v3/tkbs/merchant_encry
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'org_code' => JINGJIAN_ORG_CODE,
+    'user_no' => JINGJIAN_USER_NO,
+    'email' => '2804711849@qq.com',
+    'busi_code' => 'WECHAT_PAY',
+    'mer_reg_name' => '花掌柜进件测试',
+    'mer_type' => 'TP_PERSONAL',
+    'mer_name' => '花掌柜进件测试商户',
+    'mer_addr' => '柳州市解放南路金鱼巷1号花旗壹号楼15-10',
+    'province_code' => '6100',
+    'city_code' => '6140',
+    'county_code' => '986140',
+    'license_name' => '烟酒行批发24小时',
+    'license_no' => '92450202MA5MWYQK23',
+    'license_dt_start' => '2017-11-21',
+    'license_dt_end' => '9999-12-31',
+    'latitude' => '114.034257',
+    'longtude' => '22.663572',
+    'source' => 'H5',
+    'business_content' => '烟酒行批发24小时',
+    'lar_name' => '徐哈哈',
+    'lar_id_type' => '01',
+    'lar_id_card' => '460027200111297612',
+    'lar_id_card_start' => '2015-01-16',
+    'lar_id_card_end' => '2035-01-16',
+    'contact_mobile' => '18276770550',
+    'contact_name' => '徐哈哈',
+    'openning_bank_code' => '103614010818',
+    'openning_bank_name' => '中国农业银行广西柳州市柳南支行营业室',
+    'clearing_bank_code' => '103100000026',
+    'settle_province_code' => '45',
+    'settle_province_name' => '广西',
+    'settle_city_code' => '6140',
+    'settle_city_name' => '柳州市',
+    'account_no' => '6228480850854176714',
+    'account_name' => '徐丽',
+    'account_type' => '58',
+    'account_id_card' => '460027200111297612',
+    'account_id_dt_start' => '2015-01-16',
+    'account_id_dt_end' => '2035-01-16',
+    'settle_type' => 'D1',
+    'settlement_type' => 'AUTOMATIC',
+    'biz_content' => [
+        'term_num' => '1',
+        'mcc' => '11002',
+        'activity_id' => '37',
+        'fees' => [
+            ['fee_code' => 'WECHAT', 'fee_value' => '0.60'],
+            ['fee_code' => 'ALIPAY', 'fee_value' => '0.60'],
+            ['fee_code' => 'SCAN_PAY', 'fee_value' => '0.60'],
+            ['fee_code' => 'DEBIT_CARD', 'fee_value' => '0.38', 'top_fee' => '20'],
+            ['fee_code' => 'CREDIT_CARD', 'fee_value' => '0.6'],
+            ['fee_code' => 'UNIONPAY_WALLET_DEBIT_FEE', 'fee_value' => '0.38', 'top_fee' => '20'],
+            ['fee_code' => 'UNIONPAY_WALLET_CREDIT_FEE', 'fee_value' => '0.6'],
+        ],
+    ],
+    'attchments' => [
+        ['id' => 'merchant/null/20231227172245221010CHECKSTAND_IMG.png', 'type' => 'CHECKSTAND_IMG'],
+        ['id' => 'merchant/null/20231227172251776083SHOP_OUTSIDE_IMG.png', 'type' => 'SHOP_OUTSIDE_IMG'],
+    ],
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/merchant_encry', $request);
+    // print_r($response->getRespData());
+    // echo $response->getCode();
+    // print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/merchant-info.php

@@ -0,0 +1,27 @@
+<?php
+/**
+ * 1.3 商户信息查询 -> 获取商户信息
+ * 接口：/api/v3/tkbs/open_merchant_info
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    //'merchant_no' => "100155299",//,"100155305", //"100155299", //"100155296",
+    'customer_no' => '100155305',
+    'org_code' => JINGJIAN_ORG_CODE,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_info', $request);
+    print_r($response->getRespData());
+    // echo $response->getCode();
+    // print_r($response->getHeaders());
+    // echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/merchant-withdrawal.php

@@ -0,0 +1,28 @@
+<?php
+/**
+ * 1.3 商户信息变更 -> D0提额
+ * 接口：/api/v3/tkbs/open_merchant_withdrawal
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'merchant_no' => '822121070110BC2',
+    'auth_status' => 'VALID',
+    'auth_level' => 'TK1',
+    'org_code' => JINGJIAN_ORG_CODE,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_withdrawal', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/need-photo.php

@@ -0,0 +1,26 @@
+<?php
+/**
+ * 1.1 商户进件 -> 查看当前商户是否需要照片补充
+ * 接口：/api/v3/tkbs/open_merchant_need_photo
+ * 请求加密：无   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::RESPONSE);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'merchant_no' => '8226140581200MS',
+    'org_code' => JINGJIAN_ORG_CODE,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_need_photo', $request);
+    // print_r($response->getRespData());
+    // echo $response->getCode();
+    // print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/ocr-result.php

@@ -0,0 +1,26 @@
+<?php
+/**
+ * 1.1 商户进件 -> OCR结果查询
+ * 接口：/api/v3/tkbs/ocr_result
+ * 请求加密：否   返回解密：否
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::NONE);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'img_type' => 'BUSINESS_LICENCE', //'ID_CARD_FRONT',
+    'batch_no' => '06023920260611001616220000', // 此样例数据是公司营业执照上传批次号
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/ocr_result', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/open-or-update-foreign-card.php

@@ -0,0 +1,33 @@
+<?php
+/**
+ * 1.3 商户信息变更 -> 外卡开通（支持修改外卡费率）
+ * 接口：/api/v3/tkbs/open_merchant/open_or_update_foreign_card
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'open_org_code' => JINGJIAN_ORG_CODE,
+    'customer_no' => '100130263',
+    'name' => 'Test Merchant',
+    'city' => 'Liuzhou',
+    'address' => 'No.1 Jiefang South Rd',
+    'fees' => [
+        ['fee_type' => 'VISA', 'fee' => 0.03],
+        ['fee_type' => 'MASTER', 'fee' => 0.03],
+    ],
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant/open_or_update_foreign_card', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/organization-bank-parent-code.php

@@ -0,0 +1,26 @@
+<?php
+/**
+ * 1.2 进件相关信息查询 -> 获取银行地区信息
+ * 接口：/api/v3/tkbs/organization_bank_parent_code
+ * 请求加密：无   返回解密：无
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::NONE);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'parent_code' => '63',
+    'org_code' => JINGJIAN_ORG_CODE,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/organization_bank_parent_code', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/organization-parent-code.php

@@ -0,0 +1,26 @@
+<?php
+/**
+ * 1.2 进件相关信息查询 -> 获取地区信息
+ * 接口：/api/v3/tkbs/organization_parent_code
+ * 请求加密：无   返回解密：无
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::NONE);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'parent_code' => '1', //如果 1 查询所有。首先查询 1 ，然后查询 1 的子级，然后查询 1 的子级的子级，以此类推。
+    'org_code' => JINGJIAN_ORG_CODE,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/organization_parent_code', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/reconsider-submit.php

@@ -0,0 +1,26 @@
+<?php
+/**
+ * 1.1 商户进件 -> 复议提交
+ * 接口：/api/v3/tkbs/open_merchant_reconsider_submit
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'customer_no' => '110000019',
+    'org_code' => JINGJIAN_ORG_CODE,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_reconsider_submit', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/register-status-query.php

@@ -0,0 +1,27 @@
+<?php
+/**
+ * 1.3 商户信息查询 -> 支付宝微信认证状态查询
+ * 接口：/api/v3/tkbs/open_merchant_register_status_query
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'org_code' => JINGJIAN_ORG_CODE,
+    'merchant_no' => '82224405331000A',
+    'register_type' => 'WXZF', // 微信:WXZF / 支付宝:ZFBZF
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_register_status_query', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/supplement-business-license.php

@@ -0,0 +1,41 @@
+<?php
+/**
+ * 1.3 商户信息变更 -> 商户变更-添加营业执照
+ * 接口：/api/v3/tkbs/open_merchant_supplement_business_license_encry
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'org_code' => JINGJIAN_ORG_CODE,
+    'customer_update_basic_dto' => [
+        'channel_type' => 'TP_PERSONAL',
+        'customer_no' => 100131161,
+        'merchant_no' => '8221620701109AZ',
+        'mer_blis' => '91150102MA7KUU3C02',
+        'mer_blis_name' => '呼和浩特市晓利商业管理有限公司',
+        'mer_blis_exp_dt' => '9999-12-31',
+        'lar_name' => '宋立杰',
+        'lar_idcard' => '211302197009110865',
+        'lar_idcard_exp_dt' => '9999-12-31',
+        'file_data' => [
+            ['img_path' => 'merchant/100131161/20241023114918955182ID_CARD_FRONT.jpeg', 'img_type' => 'ID_CARD_FRONT'],
+            ['img_path' => 'merchant/100131161/20241023114925727893ID_CARD_BEHIND.jpeg', 'img_type' => 'ID_CARD_BEHIND'],
+            ['img_path' => 'merchant/100131161/20241023114951278116BUSINESS_LICENCE.jpeg', 'img_type' => 'BUSINESS_LICENCE'],
+        ],
+    ],
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_supplement_business_license_encry', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/terminal-info.php

@@ -0,0 +1,26 @@
+<?php
+/**
+ * 1.3 商户信息查询 -> 获取终端信息
+ * 接口：/api/v3/tkbs/open_terminal_info
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'pos_sn' => '202410110000000000000000000001',
+    'org_code' => JINGJIAN_ORG_CODE,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_terminal_info', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/trans-transfer-with-page.php

@@ -0,0 +1,30 @@
+<?php
+/**
+ * 1.4 划款信息查询 -> 划款交易查询（分页）
+ * 接口：/api/v3/tkbs/open_trans_transferWithPage
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'merchant_no' => '8222900701105HK',
+    'start_date' => '2023-11-01 00:00:00',
+    'end_date' => '2023-11-30 23:59:59',
+    'org_code' => JINGJIAN_ORG_CODE,
+    'page' => 1,
+    'size' => 2,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_trans_transferWithPage', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/trans-transfer.php

@@ -0,0 +1,30 @@
+<?php
+/**
+ * 1.4 划款信息查询 -> 划款交易查询
+ * 接口：/api/v3/tkbs/open_trans_transfer
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'merchant_no' => '8222900701105HK',
+    'start_date' => '2023-11-01 00:00:00',
+    'end_date' => '2023-11-30 23:59:59',
+    'org_code' => JINGJIAN_ORG_CODE,
+    'page' => 1,
+    'size' => 2,
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_trans_transfer', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/update-basic.php

@@ -0,0 +1,38 @@
+<?php
+/**
+ * 1.3 商户信息变更 -> 商户基本信息变更
+ * 接口：/api/v3/tkbs/open_merchant_update_basic_encry
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'customer_no' => '100130263',
+    'org_code' => JINGJIAN_ORG_CODE,
+    'customer_update_basic_dto' => [
+        'customer_no' => 100130263,
+        'mer_reg_name' => '哈哈哈体验馆',
+        'mer_biz_name' => '哈哈哈体验馆',
+        'province_code' => '4200',
+        'city_code' => '4210',
+        'county_code' => '984210',
+        'mer_reg_addr' => 'wefdsaf',
+        'mer_contact_mobile' => '15268891559',
+        'lar_name' => '成鹏',
+        'lar_idcard' => '331081199310068013',
+    ],
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_update_basic_encry', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/update-fee.php

@@ -0,0 +1,33 @@
+<?php
+/**
+ * 1.3 商户信息变更 -> 商户费率变更
+ * 接口：/api/v3/tkbs/open_merchant_update_fee
+ * 请求加密：无   返回解密：无
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::NONE);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'customer_no' => '100109984',
+    'org_code' => JINGJIAN_ORG_CODE,
+    'customer_fee_update_dto' => [
+        'customer_no' => 100109984,
+        'settle_type' => 'D0',
+        'fees' => [
+            ['fee' => 0.0058, 'top_fee' => null, 'fee_type' => 'CREDIT_CARD'],
+        ],
+    ],
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_update_fee', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}

example/jingjian_api/update-settle.php

@@ -0,0 +1,41 @@
+<?php
+/**
+ * 1.3 商户信息变更 -> 商户结算信息变更
+ * 接口：/api/v3/tkbs/open_merchant_update_settle_encry
+ * 请求加密：SM4   返回解密：SM4
+ */
+
+$config = require __DIR__ . '/bootstrap.php';
+
+$api = new \Lakala\OpenAPISDK\V3\Api\LakalaApi($config, \Lakala\OpenAPISDK\V3\Api\EncryptMode::BOTH);
+
+$request = new \Lakala\OpenAPISDK\V3\Model\ModelRequest();
+$request->setReqData([
+    'customer_no' => '100130263',
+    'org_code' => JINGJIAN_ORG_CODE,
+    'customer_settle_update_dto' => [
+        'account_kind' => '58',
+        'is_legal_person' => true,
+        'account_name' => '曾雄华',
+        'identity_no' => '420984197708116014',
+        'account_no' => '6217001330022264323',
+        'bank_no' => '105312000230',
+        'bank_name' => '中国建设银行股份有限公司扬州市凯旋支行',
+        'clearing_bank_no' => '105100000017',
+        'settle_province_code' => '32',
+        'settle_city_code' => '3120',
+        'settle_province_name' => '江苏省',
+        'settle_city_name' => '扬州市',
+        'attachments' => [],
+    ],
+]);
+
+try {
+    $response = $api->tradeApi('/api/v3/tkbs/open_merchant_update_settle_encry', $request);
+    print_r($response->getRespData());
+    echo $response->getCode();
+    print_r($response->getHeaders());
+    echo $response->getOriginalText();
+} catch (\Lakala\OpenAPISDK\V3\ApiException $e) {
+    echo $e->getMessage();
+}