支付退款

当支付退款被创建、成功或失败时发送。

WEBHOOK paymentRefund

JSON

created

{
  "version": "V1.6.0",
  "event_name": "ACQUIRING",
  "event_type": "acquiring.refund.created",
  "event_id": "ff65da37-6fcc-4e3a-a418-547b349aee8b",
  "source_id": "RF2043629695899013120",
  "data": {
    "amount": "8.88",
    "complete_time": null,
    "create_time": "2026-04-13T17:57:42+08:00",
    "currency": "SGD",
    "metadata": {
      "order_id": "order_6789"
    },
    "payment_attempt_id": "PA2043628825429938176",
    "payment_intent_id": "PI2043628825316691968",
    "payment_refund_id": "RF2043629695899013120",
    "reason": "full refund",
    "refund_status": "INITIATED"
  }
}

​

事件类型

事件类型	描述
acquiring.refund.created	退款请求已创建。
acquiring.refund.succeeded	退款成功完成。
acquiring.refund.failed	退款失败。

请求体

application/json

event_id · string<uuid> · 必填

A unique identifier for this event.

event_name · enum<string> · 必填

Top-level event category.

可用选项: ACQUIRING

event_type · enum<string> · 必填

The specific event type that occurred.

可用选项: acquiring.refund.created, acquiring.refund.succeeded, acquiring.refund.failed

source_id · string · 必填

Payment refund ID.

version · string · 必填

API version number.

示例:

"V1.6.0"

data · object

Payment refund details associated with the event.

Show child attributes

响应

200

Return 200 to acknowledge receipt.