Receives settlement status updates from settlement provider. Requires signature validation. Statuses: SETTLING, COMPLETED, FAILED. For FAILED status, initiates refund process using configured refund method.
Webhook type identifier
"SETTLEMENT_STATUS_UPDATE"
Provider reference ID
"PROVIDER-TXN-20241122-001"
Kotani reference ID
"KOTANI-REF-789"
Updated settlement status
DEPOSIT_INITIATED, DEPOSIT_CONFIRMED, PAYMENT_SENT, PAYMENT_CONFIRMED, SETTLING, COMPLETED, FAILED, SETTLEMENT_UNCONFIRMED, REFUNDED "COMPLETED"
Webhook timestamp (ISO 8601)
"2024-11-22T12:05:00Z"
Crypto payment details
Settlement details (if successful)
Failure details (if failed)
Refund details (if failed and refund initiated)
Transaction metadata