概述

本文档详细描述了调用所有订单管理API接口时所需的通用参数、业务参数的格式、规则和要求。请在发起请求前仔细阅读。

通用请求头（所有接口必传）

这部分是所有接口都需要请求接口的通行令牌。s

参数名	类型	是否必填	描述	示例
Content-Type	string	是	数据类型	application/json
Authorization	string	是	请求接口的通行令牌

webhook列表

Request

参数名	类型	长度	是否必填	描述	示例
cursor	int	10	否	用于分页查询的游标
limit	int	5	否	查询条数
webhook_name	string	20	否	webhook名称
webhook_url	string	100	否	通知地址
ascending	boolean		否	是否升序，默认降序 true false

Response

参数名	类型	描述	示例
msg	string	描述
code	int	状态码
trace_id	string	错误跟踪id
data	object	数据
next_cursor	string	分页游标
has_more	boolean	是否有下一页
data	array	数据列表
webhook_id	int	webhook Id
webhook_name	string	webhook名称
webhook_url	string	通知地址
sign_secret	string	签名密钥
creator_id	int	创建人ID
creator_name	string	创建人名称
create_time	string	创建时间
operator_id	int	更新人ID
operator_name	string	更新人名称
operate_time	string	更新时间
event_code	string	事件code
event_type	string	事件类型
event_description	string	事件描述

新增webhook

Request

参数名	类型	长度	是否必填	描述	示例
webhook_name	string	20	是	webhook名称
webhook_url	string	100	否	通知地址

Response

参数名	类型	描述	示例
msg	string	描述
code	int	状态码
trace_id	string	错误跟踪id
data	array	数据
webhook_id	int	webhook Id
webhook_name	string	webhook名称
webhook_url	string	通知地址
sign_secret	string	签名密钥
creator_id	int	创建人ID
creator_name	string	创建人名称
create_time	string	创建时间
operator_id	string	更新人ID
operator_name	string	更新人名称
operate_time	string	更新时间

更新webhook

Request

参数名	类型	长度	是否必填	描述	示例
webhook_name	string	20	是	webhook名称
webhook_url	string	100	否	通知地址

Response

参数名	类型	描述	示例
msg	string	描述
code	int	状态码
trace_id	string	错误跟踪id
data	array	数据
webhook_id	int	webhook Id
webhook_name	string	webhook名称
webhook_url	string	通知地址
sign_secret	string	签名密钥
creator_id	int	创建人ID
creator_name	string	创建人名称
create_time	string	创建时间
operator_id	string	更新人ID
operator_name	string	更新人名称
operate_time	string	更新时间

事件列表

Request

参数名	类型	长度	是否必填	描述	示例
cursor	int	10	否	用于分页查询的游标——由上一次调用返回，首次调用不填
limit	int	10	否	查询条数
event_type	string	50	否	事件类型 card.transaction.success： 交易成功通知 card.load： 续额通知 card.transaction.failure：交易失败通知 card.authorization.success： 授权成功通知 card.authorization.failure： 授权失败通知
event_code	string	20	否	事件编码 165801： 交易成功通知 165802： 续额通知 165803： 交易失败通知 165804：授权成功通知 165805：授权失败通知
ascending	boolean		否	是否升序——默认降序（true/false）

Response

参数名	类型	描述	示例
msg	string	描述
code	int	结果代码
trace_id	string	错误跟踪id
data	object	返回数据
next_cursor	string	分页游标
has_more	boolean	是否有下一页
data	array	数据列表
event_id	int	事件ID
event_type	string	事件类型 card.transaction.success： 交易成功通知 card.load： 续额通知 card.transaction.failure：交易失败通知 card.authorization.success： 授权成功通知 card.authorization.failure： 授权失败通知
event_category	string	事件分类
event_code	string	事件编码 165801： 交易成功通知 165802： 续额通知 165803： 交易失败通知 165804：授权成功通知 165805：授权失败通知
event_description	string	事件描述

事件订阅

Request

参数名	类型	长度	是否必填	描述	示例
event_type	string	50	是	事件类型 card.transaction.success： 交易成功通知 card.load： 续额通知 card.transaction.failure：交易失败通知 card.authorization.success： 授权成功通知 card.authorization.failure： 授权失败通知

Response

参数名	类型	描述	示例
msg	string	描述
code	int	状态码
trace_id	string	错误跟踪id
data	array	数据
webhook_id	int	webhook Id
webhook_name	string	webhook名称
webhook_url	string	通知地址
sign_secret	string	签名密钥
creator_id	int	创建人ID
creator_name	string	创建人名称
create_time	string	创建时间
operator_id	string	更新人ID
operator_name	string	更新人名称
operate_time	string	更新时间
event_type	string	事件类型 card.transaction.success： 交易成功通知 card.load： 续额通知 card.transaction.failure：交易失败通知 card.authorization.success： 授权成功通知 card.authorization.failure： 授权失败通知
event_code	string	事件编码 165801： 交易成功通知 165802： 续额通知 165803： 交易失败通知 165804：授权成功通知 165805：授权失败通知
event_description	string	事件描述

事件取消订阅

Request

参数名	类型	长度	是否必填	描述	示例
event_type	string	50	是	事件类型 card.transaction.success： 交易成功通知 card.load： 续额通知 card.transaction.failure：交易失败通知 card.authorization.success： 授权成功通知 card.authorization.failure： 授权失败通知

Response

参数名	类型	描述	示例
msg	string	描述
code	int	状态码
trace_id	string	错误跟踪id
data	array	数据
webhook_id	int	webhook Id
webhook_name	string	webhook名称
webhook_url	string	通知地址
sign_secret	string	签名密钥
creator_id	int	创建人ID
creator_name	string	创建人名称
create_time	string	创建时间
operator_id	string	更新人ID
operator_name	string	更新人名称
operate_time	string	更新时间
event_type	string	事件类型 card.transaction.success： 交易成功通知 card.load： 续额通知 card.transaction.failure：交易失败通知 card.authorization.success： 授权成功通知 card.authorization.failure： 授权失败通知
event_code	string	事件编码 165801： 交易成功通知 165802： 续额通知 165803： 交易失败通知 165804：授权成功通知 165805：授权失败通知
event_description	string	事件描述