refund - Clink Documentation

{ "id": "<string>", "object": "event", "created": 123, "data": { "object": { "createTime": 1754819711382, "refundId": "rfd_abc123xyz", "orderId": "order_def456uvw", "customerId": "cus_ghi789rst", "refundAmount": 19.99, "refundCurrency": "USD", "status": "success", "refundReason": "Customer Initiated Refund", "metadata": { "arn": "8377252556170253", "merchantReferenceId": "sample_id" }, "paymentInstrumentId": "<string>" } } }

Headers

X-Clink-Timestamp

string

required

Timestamp sent by Clink for webhook signature verification.

X-Clink-Signature

string

required

Hex-encoded HMAC-SHA256 signature generated with the webhook signing secret over the string ${X-Clink-Timestamp}.${rawRequestBody}. Use the raw request body bytes/string exactly as received; do not parse and re-serialize the JSON before verifying.

X-Clink-SignType

enum<string>

required

Signature algorithm used to generate X-Clink-Signature. The current value is SHA256.

Available options:

SHA256

Body

application/json

Refund event payload in json

string

Unique identifier for the event

type

enum<string>

Type of event that occurred

Available options:

refund.created,

refund.succeeded,

refund.failed

object

string

Type of this json payload, 'event' if this is an event

Example:

"event"

created

integer<int64>

Unix timestamp in milliseconds when the event occurred

data

object

Show child attributes

Response

200

Return a 200 status to indicate that the data was received successfully