5. 附录

####

## [1.1.附录1]()，报文签名验签说明

Md5 block只包含标签值，不包含标签名称；

Licence字段为设备入网时，在管理平台生成的验证字符串；

请求报文md5 block生成规则：APP_ID + BUSINESS_ID + CUST_DATA + licence；

应答报文md5 block生成规则：APP_ID + BUSINESS_ID + RSP_DATA + licence ；

如请求报文：

{"BUSINESS_ID":"100000003","CUST_DATA":"{\"BUSINESS_ID\":\"100000003\",\"AMOUNT\":\"000000000002\",\"ORDER_NO\":\"123123213\"}","CASH_ID":"NKAB1201","STORE_ID":"NKAB12","APP_ID":"app_id_001","SIGN_DATA":"e2c6637abe8ea3cbb5ec64246c2ff82e","APP_PACKAGE_NM":"","APP_CLASS_NM":""}

Md5 block 为：

app_id_001100000003{"BUSINESS_ID":"100000003","AMOUNT":"000000000002","ORDER_NO":"123123213"}9a432306-b93d-4d0d-aa7d-ac2bb89dee25-20200208002855

计算的请求md5 值为：

e2c6637abe8ea3cbb5ec64246c2ff82e

应答报文的SIGN_DATA计算方法同请求报文；

## 1.2.附录2，扩展字段说明

BUS_INFO：该字段可包含多个子节点，以嵌套 json 方式上送，具体定义如下：

| **子参数名称** | **必填** | **注释**         | **格式**                                                             |
| ---------------------- | ---------------- | ------------------------ | ---------------------------------------------------------------------------- |
| **BUS_INFO**   | **C**    | **业务扩展结构** | “BUS_INFO”:{“SUB_MERCHANT”:{…},“SUB_ACCT”:[{ },{ },…],IS_PRINT: 0} |

BUS_INFO子节点：

| SUB_MERCHANT         | C           | 子商户号                 | “SUB_MERCHANT”:{“MID”:“821290054110001”,“NAME”:“测试商户”（可选）}                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ---------------------- | ------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| SUB_ACCT             | C           | 交易分账功能子账户       | “SUB_ACCT”:[{“MODE”:“1”,“MID”:“5506510541102N4”“AMT”:“30”,“RATIO”:“10”,}，… ]说明：MODE取值为 1，代表按比例分账，AMT 字段可不出现。MODE 字段为 2 时，代表按金额分账，RATIO 字段可不出现。选择按比例分账时，RATIO 字段整数部分最长为 2 位，可带 2 位小数，如 30.45 代表 30.45%；选择按金额分账时,AMT 字段为数字，可带 2 位小数，最长 12 位，以元为单位，如 30.55 表示 30.55 元。交易报文中可包含多个分账账户，一个或多个分账账户用中括号[ ]括起来，分账账户之间用逗号分隔，多个分账账户所表示的金额之和需等于原始交易金额。 |
| IS_PRINT             | C           | 是否打印                 | 0：不打印；1：打印注：目前只针对提取指定交易明细（900100004）接口                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **TRANS_INFO** | **C** | **交易扩展结构**   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|                      | C           | 暂无                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **PARA_INFO**  |             | **参数型扩展结构** |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|                      |             | 暂无                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |

VALIDATE_INFO：该字段可包含多个子节点，以嵌套 json 方式上送至 USDK，具体定义如下：

| **子参数名称** | **必填** | **注释**         | **格式**                                                                                                                    |
| ---------------------- | ---------------- | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| VALIDATE_INFO        | **C**    | **验证拓展字段** | “VALIDATE_INFO”:{“INPUT_PAN”:“xxxxxxxxx”“ID_CARD_NO”:“xxxxxxxxx”“ID_CARD_NAME”:“xxxxxxxxx”“SUPP_CARD_TYPE”:“x”} |

VALIDATE_INFO子节点（有就传入没有无需传入）：

| INPUT_PAN      | C | 输入指定银行卡号   |                                                                  |
| ---------------- | --- | -------------------- | ------------------------------------------------------------------ |
| ID_CARD_NO     | C | 身份证号码         |                                                                  |
| ID_CARD_NAME   | C | 姓名               |                                                                  |
| VAL_CARD_TYPE  | C | 是否需要验证借贷记 | 否(默认)是                                                       |
| SUPP_CARD_TYPE | C | 支持卡种           | 借贷记（默认）借记卡贷记卡该字段有值的话  VAL_CARD_TYPE 必须传值 |

PAGE_APPEND_CONTENT：该字段可包含多个子节点，以 json 方式上送，具体定义如下：

| **子参数名称** | **必填** | **注释**           | **格式**                                                                                   |
| ---------------------- | ---------------- | -------------------------- | -------------------------------------------------------------------------------------------------- |
| PAGE_APPEND_CONTENT  | **C**    | **自定义打印字段** | “PAGE_APPEND_CONTENT”:{“MERCHANT_PAGE”:“xx”,“CARD_HOLDER_PAGE”:“xx,“THIRD_PAGE”:“xx} |

PAGE_APPEND_CONTENT子节点（有就传入没有无需传入）：

| MERCHANT_PAGE    | C | 商户联   | WORD：打印文字，如需要打印多行以\n 换行处理QR_CODE：需要打印的二维码以字符串形式传入PICTURE：打印图片，图片需要先压缩后转成字节数组，再 BASE64 编码成字符串传入该联以嵌套 json 方式传递[{“WORD”:”XXX”,“QR_CODE”:”XX”, “PICTURE”:”XX”,“LOCATION”:”XX”},…….]LOCATION取值说明：0-左边对齐 2 -右边对齐 3- 居中（默认） |
| ------------------ | --- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CARD_HOLDER_PAGE | C | 持卡人联 | 同上                                                                                                                                                                                                                                                                                                                                 |
| THIRD_PAGE       | C | 第三联   | 同上                                                                                                                                                                                                                                                                                                                                 |

## 1.3.附录3，小票内容格式说明

公共部分为真实小票的商户联、持卡人联都需要包含的部分；

商户联小票内容组装规则：打印小票公共联内容 **+ ** 打印小票商户联内容；

持卡人联小票内容组装规则：打印小票公共联内容 **+ ** 打印小票持卡人联内容；

返回示例如下：

**{"APP_ID": "22edd04a19dd4bae815f20a9ab052adf","BUSINESS_ID": "100100003","RSP_CODE": "Y0000","RSP_DATA": "{\"BUSINESS_ID\":\"100100003\",\"REJCODE\":\"00\",\"REJCODE_CN\":\"**  **交易成功**  **\",\"MERCH_ID\":\"990605055336000\",\"TER_ID\":\"10000081\",\"MERCH_NAME\":\"**  **进贤门店**  **_** **测试** **3\",\"TRACE_NO\":\"000159\",\"BATCH_NO\":\"000001\",\"TRANS_TICKET_NO\":\"112003370001968579\",\"ORDER_NO\":\"2222222222\",\"AMOUNT\":\"000000000001\",\"REF_NO\":\"110337968579\",\"CARDNO\":\"6214852106834826\",\"CARD_TYPE_IDENTY\":\"0\",\"WILD_CARD_SIGN\":\"0\",\"EXP_DATE\":\"2605\",\"ISS_NAME\":\"** **招商银行** **  \",\"DATE\":\"0803\",\"TIME\":\"135635\",\"PRINT_FLAG\":\"0\",\"CARD_FEE\":\"0\",\"AUTH_NO\":\"755137\",\"PRT_COMMON\":\"**  **版本** **:S-LDQM50-000V4.2200799\\n** **商户名称**  **:**  **进贤门店**  **_** **测试****3\\n** **商户号** **:990605055336000\\n** **终端号** **:10000081  ** **操作员** **:01\\n** **发卡机构**  **:** **招商银行****  \\n** **收单机构** **:48210001\\n** **卡号** **:621485******4826 C\\n** **交易类型**  **:**  **消费** **\\n** **有效期** **:2605   ** **批次号** **:000001\\n** **凭证号** **:000159 ** **授权码** **:755137\\n** **交易参考号** **:110337968579\\n** **时间** **:335645748-08-03 13:56:35\\n** **金额** **:RMB 0.01\\n------------------------\\n** **通联客户号** **:990605055336000\\n** **交易单号** **:112003370001968579  B\\n** **支付申请号** **:2222222222\\n\",\"PRT_CARDHOLDER\":\"------------------------\\nARQC:CC6D3A786DF9EAE9  AIP:7C00\\nTVR:0000000000  CSN:000  ATC:0BB2\\nAID:A000000333010101  CVMR:000000\\nUNPR NUM:230FD94B  TSI:0000\\n--------------------------------\\n\",\"PRT_MERCHANT\":\"------------------------\\n****交易金额不足****1000.00** **元** **, ** **免密免签** **\\n** **本人确认以上交易**  **,**  **同意将其记入本账户**  **\\n\"}",       "RSP_DESC": "**  **调用成功** **",       "ClOUD_MIS_TRX_SSN": "342667044480614400",   "SIGN_DATA": "5D7A6B999371F0230FE1108D1B648ABD"}**

## [1.4.附录4]()，使用有线网络说明

该说明针对POS机使用充电底座以有线网络方式连网的情况：

当使用底座有线网络连接时，在交易过程中一定不能将POS机与底座分离，否则将导致网络波动（包括拿起后立即放下、拿起后立即连上WiFi等重新恢复网络），虽然此时会自动重新绑定，但由于通讯信道已切换，必将导致正在进行的交易出现异常。

为减少出现这种交易异常，应尽量避免使用底座+有线网络方式连网，并且扫码交易时使用前置摄像头。