API ReferenceWebhooks

Merchant balance credited.

Fired only after the merchant's available balance is credited. Converted payments emit outcome=target_credited; terminal unconverted fallback emits outcome=source_credited.

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

event_idstring

Stable event UUID for merchant-side idempotency.

Formatuuid
eventstring

Event type identifier.

Value in"balance.credited"
created_atstring

Balance credit transaction timestamp.

Formatdate-time
dataBalanceCreditedWebhookData

Payload data for balance.credited events emitted only after spendable merchant balance is credited.