CFT-周大福

积分交易撤销

POST

/fast-service/v1/0.0/api/point/revert

积分场景

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-vpjq75s2e4.kylin.shuyun.com/fast-service/v1/0.0/api/point/revert' \
--header 'Authorization;' \
--header 'X-Caller-Service: ' \
--header 'X-Caller-sign: ' \
--header 'X-Caller-Timestamp: ' \
--header 'X-Caller-Sign: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bizCode": "CTFCN",
    "requestChannel": "WECHAT",
    "requestSystem": "WECHAT_MALL",
    "transactionId": "TX2024030490569",
    "originalTransactionId": "TX2024030490569",
    "identify": {
        "memberId": "string",
        "channel": "string",
        "userId": "wxd678efh567hg6787_oGPAG5rdBP78jh_3cmJ1en8FvZlo"
    },
    "pointBizType": "POINT",
    "description": "备注",
    "shopCode": "string",
    "shopName": "string",
    "actionId": "string",
    "actionName": "string",
    "operationType": "string",
    "revertType": "string",
    "point": 0,
    "KZZD1": "string",
    "KZZD2": "string",
    "KZZD3": "string"
}'

响应示例

{
  "success": true,
  "code": "string",
  "message": "string",
  "data": {}
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Authorization

string

必需

默认值:

Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJicmFuY2hfMzgxMCIsImF1ZCI6InNtYXJ0X3BvcnRhbF91YXQiLCJpc3MiOiJzc28iLCJpcF9hZGRyZXNzIjoiMTAuMjAwLjE4MC43NiIsImV4cCI6MTczOTc5ODIzMCwiYnJhbmNoIjoiMzgxMCIsImlhdCI6MTczOTc5MTAzMH0.jqwTnQ0ah3k94Yjpn7hw91QtmKwsvXhjyibZpXDrGifaBcvzPdz8MjCg66FUohyKTS4ciZILl6xXJ5a1pQ_iIg

X-Caller-Service

string

可选

默认值:

X-Caller-sign

string

可选

默认值:

X-Caller-Timestamp

string

可选

默认值:

X-Caller-Sign

string

网关签名

可选

默认值:

Body 参数application/json

bizCode

string

业务代码

必需

>= 1 字符

示例值:

CTFCN

requestChannel

string

请求渠道 POS;WECHAT:微信

必需

>= 1 字符

示例值:

WECHAT

requestSystem

string

请求系统 POS;WECHAT_MALL:微信商城;MEMBER_CENTER:会员中心;POINTS_MALL:积分商城

必需

>= 1 字符

示例值:

WECHAT_MALL

transactionId

string

事务ID

必需

>= 1 字符

示例值:

TX2024030490569

originalTransactionId

string

待撤销的原交易事务ID

必需

>= 1 字符

示例值:

TX2024030490569

identify

object

必需

memberId

string

麒麟会员ID

可选

channel

string

识别渠道 POS;WECHAT:微信非必输(如果不传默认取requestChannel)

可选

userId

string

渠道用户id。POS渠道:pos卡号(不能为手机号);微信:appId_openId;淘宝渠道:ouid;京东:xid;抖店:openid.其他渠道唯一id等等

可选

示例值:

wxd678efh567hg6787_oGPAG5rdBP78jh_3cmJ1en8FvZlo

pointBizType

string

积分业务类型,不传,默认为: POINT

可选

默认值:

POINT

description

string

备注

必需

>= 1 字符

示例值:

备注

shopCode

string

店铺code

可选

shopName

string

店铺描述

可选

actionId

string

活动Id

可选

actionName

string

活动名称

可选

operationType

string

操作类型

必需

revertType

string

变更类型: SEND-发放积分 DEDUCT-消耗积分 USE_FREEZE-消耗已冻结

必需

>= 1 字符

point

integer <int32>

积分值

必需

KZZD1

string

扩展字段一

可选

KZZD2

string

扩展字段二

可选

KZZD3

string

扩展字段三

可选

示例

返回响应

🟢200revert 200 response

application/json

Body

success

boolean

是否成功：true 表示成功 false 表示失败

可选

code

string

000000 表示成功，其余编码表示具体错误编码

可选

message

string

可选

data

object (Void)

可选

积分解冻

消耗已冻结积分