发卡
用户在三方平台下单后,通知开放平台发卡
请求url
https://m-api.lejian.com/open-api/V2/sendCard?accessToken=ACCESS_TOKEN&nonce=NONCE&sign=SIGN
请求协议:HTTPS
请求方式:POST
需要签名: 是
URL参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| accessToken | 是 | string | 当前有效的accessToken |
| nonce | 是 | string | 当前有效的nonce |
| sign | 是 | string | 数据sign值 |
关于nonce和sign请查看 数据签名。
POST参数示例
{"quantity":1,"mobile":"15676539876","outerId":"1287d","skuId":"1505"}
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| mobile | 是 | string | 购买人的手机号 |
| quantity | 是 | int | 购买数量 |
| outerId | 是 | string | 三方平台订单号 |
| skuId | 是 | string | 平台提供的skuId |
正常返回示例:
{"data":{"cards":[{"cardNum":"20210603105823824000205"}],"outerId":"1287d"},"msg":"success","success":"T"}
| 参数名 | 类型 | 说明 |
|---|---|---|
| outerId | String | 三方平台订单号(值是请求参数中的outerId对应的值) |
| cards | JSONObject | 卡信息 |
异常返回示例
{"success":"F","errCode":"206009","msg":"操作失败:{0}" //0为具体异常信息}
撤销
根据三方提供的outerId撤销对应的卡。
eg:outerId 对应 三张卡,卡A,kB,KC。
倘若一张都没有使用,撤销成功后,卡A,kB,KC都会变成已撤销。
倘若有一张或多张已使用,不允许撤销。
请求url
https://m-api.lejian.com/open-api/V2/revokeCard?accessToken=ACCESS_TOKEN&nonce=NONCE&sign=SIGN
请求协议:HTTPS
请求方式:POST
需要签名: 是
URL参数:
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| accessToken | 是 | string | 当前有效的accessToken |
| nonce | 是 | string | 当前有效的nonce |
| sign | 是 | string | 数据sign值 |
关于nonce和sign请查看 数据签名。
POST参数示例
{"outerId":"1287d"}
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| outerId | 是 | string | 三方平台订单号 |
正常返回示例
{"data":{"result":true},"msg":"success","success":"T"}
异常返回示例
{"success":"F","errCode":"206010","msg":"操作失败:{0}" //0为具体异常信息}
文档更新时间: 2023-11-20 18:08