退款状态变更通知

方向:Inbound(QI Tech / 支付基础设施 → BNPL WL)。 合作伙伴不直接调用此端点。

Webhook endpoint for receiving refund status change notifications.

This is triggered when a refund transitions between states.

Use this to track refund progress asynchronously, especially useful when a refund request times out.

Common status transitions:

  • PENDING -> LIMIT_RESTORED: 客户信用额度已恢复,退款转账仍在处理中

  • LIMIT_RESTORED -> COMPLETED: Refund processed successfully

  • PENDING -> FAILED: Refund processing failed

  • PENDING -> ACTION_REQUIRED: Refund needs partner action (e.g., invalid PIX key — collect a new one from the customer)

  • ACTION_REQUIRED -> PENDING: Partner resubmitted corrected data, refund is being retried

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Webhook payload for refund status change notifications. Sent when a refund transitions between states.

uuid
required

Person identifier associated with this refund

string
enum
required

Webhook事件类型

Show Details
refund.status_changeTriggered when a refund status changes
Allowed:
uuid
required

Application identifier associated with this refund

uuid
required

退款标识符

string

合作伙伴为此退款提供的参考ID,用于对账

string
enum
required

Previous refund status before the change

Show Details
PENDING退款正在处理中
LIMIT_RESTORED客户信用额度已恢复;退款转账(PIX)仍在处理中
COMPLETED退款已成功完成
FAILED退款处理失败
ACTION_REQUIREDRefund requires partner action — new or corrected data must be provided by the customer
Allowed:
string
enum
required

New refund status after the change

Show Details
PENDING退款正在处理中
COMPLETED退款已成功完成
FAILED退款处理失败
ACTION_REQUIREDRefund requires partner action — new or corrected data must be provided by the customer
Allowed:
date-time
required

Timestamp when the status change occurred

data
object
required

Event data with refund details

Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json