跳到主要内容

接收退款申请

与违规报告不同，退款申请在符合某些准则的情况下，应尽可能以接受方式关闭，除非账户已关闭或余额不足。因此，客户只会收到有关退款申请状态更新的 webhooks 通知，这不是可争议的，因为通过 MED 提出退款申请的原因要么是已接受的违规报告，要么是其他参与方因运营故障而提出的。

incoming refund request 的 Webhook​

incoming refund request 是由另一家银行提出的退款，账户所有者是被争议交易的目标。

Webhook request body​

Webhook: incoming refund request
{
  "event_datetime": "2024-07-16T16:48:43Z",
  "key": "0dedf537-a75e-4945-be1d-5d278c623022",
  "data": {
    "refund_request_key": "9eb5f452-81fd-4f67-9f2a-49e14e53ef64",
    "infraction_report_key": "3541127e-cbc9-44f6-bb0e-3e346ddaefb4",
    "target_account_key": "6711e3cf-fdf4-41b4-88e8-0a31cb83b9f4",
    "refund_request_type": "fraud",
    "blocked_balance_status": "completelly_blocked",
    "pix_transfer_key": "957ef961-1824-47e6-90fd-f8b4775a1e1c",
    "end_to_end_id": "E12345678202404302308s188f18bJty",
    "requesting_participant": "18236120",
    "contested_participant": "32402502",
    "refund_request_details": null,
    "refund_payment_event": null,
    "requested_amount": 40,
    "refunded_amount": 0,
    "refund_request_status": "open",
    "analysis_result": null,
    "analysis_details": null,
    "reject_reason": null,
    "updated_at": "2024-07-16T19:48:43Z",
    "created_at": "2024-07-16T19:48:43Z"
  },
  "status": "open",
  "webhook_type": "incoming.internal_refund_request"
}

字段类型描述字符数
event_datetime *string交易创建日期和时间。20
key *string事件发送的唯一标识键。32
data *stringincoming refund request 数据对象。Objeto incoming_refund_request
status *string退款状态。枚举值 refund_request_status

枚举值 refund_request_status​

枚举值描述
open申请已收到，待分析。
closed分析完成，申请已关闭。
cancelled申请被发起方取消。

Objeto incoming_refund_request​

字段类型描述字符数
refund_request_key *string巴西央行中退款的 UUID4 标识符。32
infraction_report_keystring巴西央行中相关违规的 UUID4 标识符。32
target_account_key *string原始交易目标账户的 Account key。32
refund_request_type *string退款申请类型。枚举值 refund_request_type
pix_transfer_key *string原始交易的 Pix transfer key。32
end_to_end_id *string原始交易的 end_to_end_id。32
requesting_participant *string发起交易的参与者。8
contested_participant *string接收交易的参与者。8
refund_request_detailsstring由另一参与方发送的退款详情。2000
refund_payment_eventstring退款执行事件。Objeto refund_payment_event
requested_amount *float退款申请金额。2000
refunded_amount *float已退款总金额。2000
refund_request_status *string退款状态。枚举值 refund_request_status
analysis_resultstring分析结果。由 QI Tech 决定。枚举值 refund_request_analysis_result
analysis_detailsstring分析结果的理由。200
reject_reasonstring申请拒绝原因。枚举值 refund_request_reject_reason
blocked_balance_status *string目标账户余额冻结状态。枚举值 blocked_balance_status
created_at *string交易更改日期和时间。20
updated_at *string交易创建日期和时间。20

Objeto refund_payment_event​

字段类型描述字符数
refund_end_to_end_idstring退款交易的 end_to_end_id。32
refund_transfer_keystring退款交易的 Pix transfer key。32
refund_amountstring退款交易金额。
created_atstring交易创建日期和时间。20

枚举值 refund_request_analysis_result​

枚举值描述
totally_accepted已退还全部申请金额。
partially_accepted因余额不足进行部分退款。正在监控账户以进行后续退款。
rejected退款被拒绝，未退还任何资金。若原因为余额不足，将监控该账户。

枚举值 refund_request_type​

枚举值描述
fraud在违规报告被接受后开启。
operational_flaw无需违规报告，用于纠正参与者的运营故障。
refund_cancelled纠正错误执行的退款。

枚举值 blocked_balance_status​

枚举值描述
no_balance客户账户无余额。正在监控待处理余额。
completelly_blocked与交易等额的资金已完全冻结。
partially_blocked与交易等额的资金已部分冻结。正在监控余额。
settled违规已接受，退款申请付款已完成。
partially_settled违规已接受，退款申请付款已部分完成。
released资金已释放，原因是违规取消或以不同意方式关闭。

枚举值 refund_request_reject_reason​

枚举值描述
no_balance客户账户无余额。正在监控待处理余额。
account_closure客户关系已终止。无法执行退款。
other其他不适用于上述列表的原因。
信息

对部分退款账户的余额监控有效期限为原始交易发生后 90 天。

outgoing refund request 的 Webhook​

outgoing refund request 是 QI 提出的退款申请，目标是另一参与者。​

Webhook request body​

Webhook: outgoing refund request
{
  "event_datetime": "2024-07-22T10:31:09Z",
  "key": "15d91f4b-a55c-41a6-9c46-2704253a1cf7",
  "data": {
    "refund_request_key": "5f98671e-9ec0-4ed7-95a9-061861243efc",
    "pix_transfer_key": "d04e0858-ea91-4dab-8089-a27d6cc68235",
    "source_account_key": "134ad635-ce80-4c8c-bca0-9dd3e8251317",
    "end_to_end_id": "E32402502202404302308s188f18bJty",
    "requested_amount": 78.5,
    "refund_request_status": "open",
    "infraction_report_key": "3b727ade-a736-473e-91a6-07b841253f55",
    "refund_request_type": "fraud",
    "refund_request_details": "Infraction aceita, favor realizar devolução de recursos.",
    "requesting_participant": "32402502",
    "contested_participant": "12345678",
    "analysis_result": null,
    "analysis_details": null,
    "reject_reason": null,
    "refund_payment_event": null,
    "updated_at": "2024-07-16T19:48:43Z",
    "created_at": "2024-07-16T19:48:43Z",
  },
  "status": "open",
  "webhook_type": "outgoing.internal_refund_request"
}
字段类型描述字符数
event_datetime *string交易创建日期和时间。20
key *enum事件发送的唯一标识键。32
data *stringoutgoing refund request 数据对象。Objeto outgoing_refund_request
status *string退款状态。枚举值 refund_request_status

Objeto outgoing_refund_request​

字段类型描述字符数
refund_request_key *string巴西央行中退款的 UUID4 标识符。32
infraction_report_keystring巴西央行中相关违规的 UUID4 标识符。32
source_account_key *string交易来源账户的 Account key。32
refund_request_type *string退款申请类型。枚举值 refund_request_type
pix_transfer_key *string原始交易的 Pix transfer key。32
end_to_end_id *string原始交易的 end_to_end_id。32
requesting_participant *string发起交易的参与者。8
contested_participant *string接收交易的参与者。8
refund_request_detailsstring由另一参与方发送的退款详情。2000
refund_payment_eventstring退款执行事件。Objeto refund_payment_event
requested_amount *float退款申请金额。2000
refund_request_status *string退款状态。枚举值 refund_request_status
analysis_resultstring分析结果。由 QI Tech 决定。枚举值 refund_request_analysis_result
analysis_detailsstring分析结果的理由。200
reject_reasonstring申请拒绝原因。枚举值 refund_request_reject_reason
created_at *string交易更改日期和时间。20
updated_at *string交易创建日期和时间。20