券核销 - 客如云 API

（上行接口）合作方提供此接口地址，接受客如云商户pos端核销券的请求（满足第三方满减券、折扣券在客如云POS端核销验券场景）注：crm2.0商户不可使用该接口

curl --location -g --request POST '{{url}}?appKey=&shopIdenty=&brandId=&version=&timestamp=&sign=' \ --header 'Content-Type: application/json' \ --data-raw '{ "coupons":["123456789012345601"], "shopId":810094162, "tradeNo":1234567890 }'

{ "code": 0, "message": "OK", "messageUuid": "3b4cce269b0d45a3a2a783e91bed263a", "result": [ { "couponNo": "123456789012345601", "status": 1, "statusDesc": "验券成功" } ] }

请求参数

Query 参数

appKey

string

必需

开发者申请服务客如云分配的appKey

默认值:

shopIdenty

string

必需

客如云门店id （门店维度接口传递门店ID）

默认值:

brandId

string

必需

客如云品牌id（品牌授权的接口传递品牌ID）

默认值:

version

string

必需

版本,默认2.0（1.0版本仍可用）

默认值:

2.0

timestamp

string

必需

时间戳,单位:秒,时间戳校验签名,开放平台校验签名时用此参数和服务器当前时间戳对比不能大于300秒，我方服务器使用阿里云授时中心

默认值:

sign

string

必需

签名，64位长度的字符串，获取规则详见签名规则

默认值:

Body 参数application/json

coupons

array[string]

待核销券码集合

必需

shopId

integer

客如云商户门店编号

必需

tradeNo

string

客如云订单编号

必需

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

返回编码，详见附录 2. 错误码

message

string

返回信息

必需

messageUuid

string

消息uuid

必需

result

array[object (CouponResult) {3}]

可选

返回响应数据，json对象或数组，可空

couponNo

string

券码

必需

status

integer

必需

核销状态：1 成功 0 失败

statusDesc

string

状态消息详细描述

必需