pos机 接口 php,POS机接口

# POS机接口

[TOC]

## 至尊卡消费

**请求方式**：POST

**请求地址**：`card/pos/consume`

**参数说明：**

| 参数 | 参数类型 | 必须 | 说明|

| ----------- | ------------------------------ | ------------ | --- |

| customid | String | yes | 会员ID|

| consume_amount | Integer | yes | 消费金额 |

| out_order | String | yes |渠道订单号|

| pay_pwd | String | yes |支付密码|

| panterid | Integer | yes | 商户ID |

| termposno | Integer | yes | POS终端号 |

| sourceCode | Integer | yes | 渠道标识 |

| key | String | yes |签名md5(秘钥.customid.consume_amount.out_order.pay_pwd.panterid.termposno.sourceCode)|

**请求包结构体：**

```

{

"customid ": "MDI1Njc4NTkO0O0O",

"consume_amount": "1",

"out_order": "SW201908131639232136",

"pay_pwd": "anljYXJkMjAyY2I5NjJhYzU5MDc1Yjk2NGIwNzE1MmQyMzRiNzBqeWNvaW4=",

"panterid": "12345678",

"termposno": "12345678",

"sourceCode ": "1234",

"key": "140fe94840090c3e79f47af7a73c2b29"

}

```

**建议密码原生传入，是否舍去以下payPwd数据格式**

**注：**

**payPwd 数据格式：**

假设密码：`202cb962ac59075b964b07152d234b70`

1. 前拼接： `jycard`

2. 后拼接： `jycoin`

3. 进行base64加密

得到数据：`anljYXJkMjAyY2I5NjJhYzU5MDc1Yjk2NGIwNzE1MmQyMzRiNzBqeWNvaW4=`

**若需要免密支付，请联系文档提供人员**

**返回信息**

金额以`元`为单位

| 参数 | 参数类型 | 必须 | 说明|

| ----------- | ------------------------------ | ------------ | --- |

| order_no| Integer | yes |消费订单号|

| out_order| String| yes | 渠道订单号|

| consume_amount| Integer | yes | 消费金额|

| customid| String| yes | 会员ID|

**返回示例：**

```

{

"status": "0",

"time": 1565614897,

"codemsg": "成功",

"data": {

"order_no": "201906101010100101",

"out_order": "SW201908131639232136",

"consume_amount": "100",

"customid": "MDI1Njc4NTkO0O0O"

}

}

```

## 至尊卡退款

**请求方式**：POST

**请求地址**：```JyCoin/returnGoods```

**参数说明：**

| 参数 | 参数类型 | 必须 | 说明|

| ----------- | ------------------------------ | ------------ | --- |

| returnAmount| Integer | yes | 退款金额|

| orderId| String| yes | 渠道订单号 |

| sourceCode | Integer | yes | 渠道标识 |

| key| String | yes |签名md5(秘钥.orderId.returnAmount.sourceCode)|

**请求包结构体：**

```

{

"returnAmount": "1",

"orderId": "SW201908131639232136",

"sourceCode ": "1234",

"key": "140fe94840090c3e79f47af7a73c2b29"

}

```

**返回信息**

金额以`元`为单位

| 参数 | 参数类型 | 必须 | 说明|

| ----------- | ------------------------------ | ------------ | --- |

| order_no| Integer | yes |退款订单号|

| out_order| String| yes | 渠道订单号|

| refund_amount| String| yes | 退款金额|

| customid| String| yes | 会员ID|

**返回示例：**

```

{

"status": "0",

"time": 1565614897,

"codemsg": "成功",

"data": {

"order_no": "201906101010100101",

"out_order": "SW201908131639232136",

"refund_amount": "100",

"customid": "MDI1Njc4NTkO0O0O"

}

}

```