Skip to main content

授权报告

无论您是要复核每一次授权决策、核对哪些交易被批准或拒绝,还是满足监管对授权流程可追溯的要求,每日授权报告(Authorisation Report)都能提供当日完整、可存储的授权决策记录。DCS 作为持牌发卡机构,将每一笔授权决策(包括同意与拒绝)记录为标准化字段,并通过每日全量对账文件交付给接入机构。 授权报告记录的是授权阶段的决策与额度占用——即「这笔交易是否放行、冻结了多少」,而非资金最终落地结果。它与交易流水报告(Transaction Report)一同交付:授权报告回答「批没批」,交易流水报告回答「最终扣了多少」。

它在资金生命周期中的位置

在合作伙伴自管方案中,额度由接入机构掌握,授权由接入机构决策。DCS 将渠道的授权请求转发给接入机构判定放行与否,并把每一次决策结果落为授权记录。授权 → 待清算 → 交易流水三者通过 ID 串联:
授权报告在资金生命周期中的位置授权报告在资金生命周期中的位置
  • 授权报告中的每条记录通过 authId 唯一标识,通过 outsId 关联到对应账单(待清算)。
  • originalAuthId 用于多笔退款、增量授权等需要追溯到原始授权的关联场景。
  • 授权与清算的完整组合场景(普通清算、增量、撤销、超额/少额清算、强制清算、提现等),请参阅 授权与清算全场景

授权类型(authType)

authType 标识一条授权记录的产生方式,帮助接入机构区分实时授权与系统补建、释放等不同场景。 权威定义另见 授权与清算全场景

交易类型(transactionType)

transactionType 标识持卡人发起授权时的交易性质,便于接入机构在对账环节快速识别交易场景。

授权状态与拒绝原因(approveFlag / rejectReason)

rejectReason 常见取值:
由于授权决策权在接入机构侧,rejectReason 既可能源自接入机构的业务判定,也可能源自 DCS/渠道侧的校验与对账修正(如超时)。各码的归类与处理见 授权拒绝与错误码

如何获取授权报告

合作伙伴自管方案中,授权记录不提供实时单笔查询接口,统一通过每日全量对账文件交付。DCS 每日为每个接入机构(Enterprise)生成一份当日全量的授权文件。 接口(领取下载链接)
请注意 fileType 取值为英式拼写 authorisation(非 authorization),如实传入。
响应:在统一响应结构 { code, message, messageDetail, data } 中,data 为字符串形式的文件下载链接(AWS S3 临时链接,有效期较短,请领取后尽快下载)。
响应结构说明:判断调用是否成功以 code 为准;message 为简要提示,messageDetail 为面向终端展示的结构化消息对象(含 title/type/action/linkUrl 等)。统一结构与判定规则详见 API 参考总览。错误码请参阅 授权拒绝与错误码
谁做什么
  • DCS:每日生成当日全量授权文件并存入 S3,按需签发临时下载链接。
  • 接入机构:调用本接口领取链接 → 在有效期内下载文件 → 存储核对授权决策与本侧记录是否一致。
系统默认 T+1 生成前一日文件,任务完成后可下载。临时下载链接固定有效 120 秒;过期后可再次调用接口领取新链接。
下载链接的统一获取方式与每日对账机制,另见 对账概述

授权报告文件字段

每行一条授权记录,字段以 > 分隔,顺序如下: 示例样本
上方样本演示了一笔被拒绝的授权:approveFlag=DrejectReason=DAPI_AUTH_ENTERPRISE_TIMEOUT_REJECT(接入机构授权超时拒绝),交易类型 R(卡消费),结算币种 702(SGD),商户国家 840(美国)。

注意事项

字段扩展说明

授权文件后续可能会追加新字段,字段扩展遵循以下兼容性承诺:
  1. 存量列下标保持稳定:当前文档已定义的列,其下标、含义永不变更,不删除、不在中间插入新列;
  2. 新字段仅在行尾追加:每次追加会提前发布变更通知,接入机构可按需读取新增下标;暂不需要时忽略行尾新增列即可,不影响既有解析;
  3. 所有列均占位:任何列(包括空值列)都保留占位,单行的分隔符数量与列数恒定一致。
建议按列下标解析字段,并兼容行尾出现未知的追加列。

下一步