Complete reference for ZBD Ramp webhook events
Session Initiated
RAMP_WIDGET.V1.SESSION.INITIATED
Triggered when a Ramp session is successfully initiated.Session Closed
RAMP_WIDGET.V1.SESSION.CLOSED
Fired when a Ramp session is closed, either by unmount, user action, or completion.Code Verification Succeeded
RAMP_WIDGET.V1.CODE_VERIFICATION.SUCCEEDED
Sent when a user successfully verifies their 6-digit code.Code Verification Failed
RAMP_WIDGET.V1.CODE_VERIFICATION.FAILED
Triggered when a 6-digit code verification attempt fails.Access Token Created
RAMP_WIDGET.V1.USER_ACCESS_TOKEN.CREATED
Fired when user access and refresh tokens are generated.KYC Initiated
RAMP_WIDGET.V1.KYC.INITIATED
Fired when KYC (Know Your Customer) verification process is initiated.KYC Processing
RAMP_WIDGET.V1.KYC.PROCESSING
Indicates that KYC verification is being processed.KYC Completed
RAMP_WIDGET.V1.KYC.COMPLETED
Sent when KYC verification is successfully completed.KYC Rejected
RAMP_WIDGET.V1.KYC.REJECTED
Triggered when KYC verification is rejected or fails.Bank Connection Initiated
RAMP_WIDGET.V1.BANK_CONNECTION.INITIATED
Triggered when bank connection flow is initiated.Bank Connection Completed
RAMP_WIDGET.V1.BANK_CONNECTION.COMPLETED
Sent when bank connection is successfully established.Bank Connection Failed
RAMP_WIDGET.V1.BANK_CONNECTION.FAILED
Fired when bank connection attempt fails.Payment Initiated
RAMP_WIDGET.V1.PAYMENT.INITIATED
Triggered when a payment transaction is initiated.Payment Settled
RAMP_WIDGET.V1.PAYMENT.SETTLED
Sent when a payment transaction is successfully settled.Payment Failed
RAMP_WIDGET.V1.PAYMENT.FAILED
Fired when a payment transaction fails.Withdrawal Succeeded
RAMP_WIDGET.V1.WITHDRAWAL.SUCCEEDED
Triggered when a withdrawal is successfully completed.Withdrawal Failed
RAMP_WIDGET.V1.WITHDRAWAL.FAILED
Sent when a withdrawal attempt fails.200 OK
status, even if processing failsWebhooks not being received
Duplicate webhooks
Webhook timeout errors