API ReferenceWebhooks

Refund completed on-chain.

Fired when the linked payout completes. The payload includes the transaction hash and the actual network fee charged to the merchant.

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.