拒付

Markdown

开始之前

您的 API 请求使用访问令牌进行身份验证。任何不包含有效访问令牌的请求都将返回错误。在身份验证中了解更多信息。

基础 URL

UAT：https://transactions.transactional.uat.unico.app/api/public/v1
生产环境：https://transactions.transactional.unico.app/api/public/v1

报告拒付

POST /credit/transactions/{transaction_id}/chargeback — 向 Unico 报告指定交易已收到拒付。

报告不等于提出异议

此端点仅用于报告拒付。它不会发起拒付分析，也不会触发责任保障。如需由 Unico 对拒付进行分析，请在门户中为该交易提出异议。

请求头

请求头	值
`Authorization`	`Bearer {token}` — 一个有效的访问令牌。

请求体

{
  "datetime": "2023-01-05T03:00:00.000Z",
  "requestor": { "key": "cpf", "value": "USER_CPF" },
  "name": "USER_NAME",
  "reason": "REQUEST_REASON",
  "observation": "GENERAL_OBSERVATIONS"
}

字段	类型	是否必填	描述
`datetime`	string	是	收到拒付的日期和时间，ISO 8601 格式。
`requestor`	object	是	申请人的信息。
`requestor.key`	string	是	申请人的识别键类型（例如 `cpf`）。
`requestor.value`	string	是	申请人的识别键值。
`name`	string	是	申请人的姓名。
`reason`	string	是	拒付的原因。
`observation`	string	否	有关该拒付的一般性说明。

201 Created

{
  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0"
}

字段	描述
`id`	拒付 ID。

一笔交易只有一笔拒付。对已有拒付的交易再次报告时，将返回 200 OK 及现有拒付的 id，且不会对其做任何更改。

有关错误响应，请参阅错误 — 交易创建。

获取拒付状态

GET /credit/transactions/{transaction_id}/chargeback/{chargeback_id} — 查询指定拒付的状态。

请求头

请求头	值
`Authorization`	`Bearer {token}` — 一个有效的访问令牌。

200 OK

{
  "id": "8263a268-5388-492a-bca2-28e1ff4a69f0",
  "status": "waiting"
}

字段	描述
`id`	拒付 ID。
`status`	拒付的当前状态。

已报告的拒付将保持 waiting 状态。如果该交易在门户中被提出异议，同一个 id 会显示分析的进度和结果。有关所有可能的状态，请参阅枚举 — 拒付结果。为优化性能，建议实现 Webhook，而非轮询此端点。

开始之前​

报告拒付​

获取拒付状态​

开始之前

报告拒付

获取拒付状态