The Bridge (Webhooks)
Listen for real-time payment events and automate your business logic.
Webhooks allow SamaPay to notify your backend when an event happens in your account. This is essential for asynchronous payments like Wave or Bank Transfers.
Webhook Lifecycle
The "Bridge" ensures that your system is synced with SamaPay even if your customer closes their browser.
Loading Flow...
Verifying Signatures
To ensure security, SamaPay signs every webhook payload. You should verify this signature before processing the data.
The Bridge will retry delivery up to 12 times over 24 hours if your server does not respond with a 2xx status code.
1
Get Secret
Copy your Webhook Secret from the Bridge Settings in the dashboard.
2
Setup Endpoint
Create a public POST endpoint that accepts raw JSON.
3
Test Payload
Use our Simulator to send test events to your local environment.