Webhook endpoint for provider settlement status updates
Crypto Bridge
Crypto Bridge Provider Settlement Webhook
Receives settlement status updates from settlement provider. Requires signature validation. Statuses: SETTLING, COMPLETED, FAILED. For FAILED status, initiates refund process using configured refund method.
POST
Webhook endpoint for provider settlement status updates
Body
application/json
Webhook type identifier
Example:
"SETTLEMENT_STATUS_UPDATE"
Provider reference ID
Example:
"PROVIDER-TXN-20241122-001"
Kotani reference ID
Example:
"KOTANI-REF-789"
Updated settlement status
Available options:
DEPOSIT_INITIATED, DEPOSIT_CONFIRMED, PAYMENT_SENT, PAYMENT_CONFIRMED, SETTLING, COMPLETED, FAILED, REFUNDED Example:
"COMPLETED"
Webhook timestamp (ISO 8601)
Example:
"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