# 进件相关 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` |