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
- Overlay Checkout
- Metadata Guide
- Configuring Allowed Payment Methods
- MCP Server
- Technical - FAQs
- Error Codes
- Transaction Failures
Subscriptions
Discounts
Licenses
Customers
Products
Disputes
Payouts
Miscellaneous
Brands
Customers
Discounts
Disputes
Invoices
License Keys
Payouts
Products
Subscriptions
Webhook Events
Outgoing Webhooks
Outgoing Webhooks
Post your webhook url
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>"
},
"brand_id": "<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_code": "<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",
"is_partial": true,
"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>"
},
"brand_id": "<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_code": "<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",
"is_partial": true,
"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"
}'
Assistant
Responses are generated using AI and may contain mistakes.