Webhooks
Outgoing Webhooks
API Documentation & SDKs
- Introduction
- Code Integration Tutorial
- SDKs - Node, Python, PHP, Go, Ruby, Java & Kotlin
- Payments Integration Guide
- Subscription Integration Guide
- Mobile Integration Guide
- On Demand Subscriptions
- Webhooks Details
- Managing Products Via API
- Metadata Guide
- Configuring Allowed Payment Methods
- MCP Server
- Technical - FAQs
Subscriptions
Discounts
Licenses
Customers
Products
Payouts
Miscellaneous
Webhooks
Outgoing Webhooks
Send a POST request to your webhook URL to receive notifications about events that occur in your account.
POST
/
your-webhook-url
curl --request POST \
--url https://test.dodopayments.com/your-webhook-url \
--header 'Content-Type: application/json' \
--header 'webhook-id: <webhook-id>' \
--header 'webhook-signature: <webhook-signature>' \
--header 'webhook-timestamp: <webhook-timestamp>' \
--data '{
"business_id": "<string>",
"data": {
"billing": {
"city": "<string>",
"country": "AF",
"state": "<string>",
"street": "<string>",
"zipcode": "<string>"
},
"business_id": "<string>",
"card_issuing_country": "AF",
"card_last_four": "<string>",
"card_network": "<string>",
"card_type": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"currency": "AED",
"customer": {
"customer_id": "<string>",
"email": "<string>",
"name": "<string>"
},
"discount_id": "<string>",
"disputes": [
{
"amount": "<string>",
"business_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"currency": "<string>",
"dispute_id": "<string>",
"dispute_stage": "pre_dispute",
"dispute_status": "dispute_opened",
"payment_id": "<string>",
"remarks": "<string>"
}
],
"error_message": "<string>",
"metadata": {},
"payment_id": "<string>",
"payment_link": "<string>",
"payment_method": "<string>",
"payment_method_type": "<string>",
"product_cart": [
{
"product_id": "<string>",
"quantity": 1
}
],
"refunds": [
{
"amount": 123,
"business_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"currency": "AED",
"payment_id": "<string>",
"reason": "<string>",
"refund_id": "<string>",
"status": "succeeded"
}
],
"settlement_amount": 123,
"settlement_currency": "AED",
"settlement_tax": 123,
"status": "succeeded",
"subscription_id": "<string>",
"tax": 123,
"total_amount": 123,
"updated_at": "2023-11-07T05:31:56Z",
"payload_type": "Payment"
},
"timestamp": "2023-11-07T05:31:56Z",
"type": "payment.succeeded"
}'
Headers
Unique identifier for the webhook
Signature of the Webhook
Unix timestamp when the webhook was sent
Body
application/json
Response
200
Webhook processed successfully
curl --request POST \
--url https://test.dodopayments.com/your-webhook-url \
--header 'Content-Type: application/json' \
--header 'webhook-id: <webhook-id>' \
--header 'webhook-signature: <webhook-signature>' \
--header 'webhook-timestamp: <webhook-timestamp>' \
--data '{
"business_id": "<string>",
"data": {
"billing": {
"city": "<string>",
"country": "AF",
"state": "<string>",
"street": "<string>",
"zipcode": "<string>"
},
"business_id": "<string>",
"card_issuing_country": "AF",
"card_last_four": "<string>",
"card_network": "<string>",
"card_type": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"currency": "AED",
"customer": {
"customer_id": "<string>",
"email": "<string>",
"name": "<string>"
},
"discount_id": "<string>",
"disputes": [
{
"amount": "<string>",
"business_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"currency": "<string>",
"dispute_id": "<string>",
"dispute_stage": "pre_dispute",
"dispute_status": "dispute_opened",
"payment_id": "<string>",
"remarks": "<string>"
}
],
"error_message": "<string>",
"metadata": {},
"payment_id": "<string>",
"payment_link": "<string>",
"payment_method": "<string>",
"payment_method_type": "<string>",
"product_cart": [
{
"product_id": "<string>",
"quantity": 1
}
],
"refunds": [
{
"amount": 123,
"business_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"currency": "AED",
"payment_id": "<string>",
"reason": "<string>",
"refund_id": "<string>",
"status": "succeeded"
}
],
"settlement_amount": 123,
"settlement_currency": "AED",
"settlement_tax": 123,
"status": "succeeded",
"subscription_id": "<string>",
"tax": 123,
"total_amount": 123,
"updated_at": "2023-11-07T05:31:56Z",
"payload_type": "Payment"
},
"timestamp": "2023-11-07T05:31:56Z",
"type": "payment.succeeded"
}'