API ReferenceWebhooks

Refund failed, reserved funds released.

Fired when the linked payout fails and the refund reservation is released back to the merchant balance.

Signature: X-Halfin-Signature: t={timestamp},v1={hmac} where hmac = HMAC-SHA256(secret, "{timestamp}.{raw_body}"). Reject if abs(now - timestamp) > 300 seconds.

eventstring

Event type identifier.

Value in"refund.created" | "refund.completed" | "refund.failed"
created_atstring

Event creation timestamp.

Formatdate-time
dataRefundWebhookData

Payload data for refund.created, refund.completed, and refund.failed events.