Skip to main content
Receive real-time notifications for payment events.

Overview

Webhooks allow your server to receive automatic notifications when events occur in your Atlas account. This is essential for:
  • Order fulfillment after successful payments
  • Sending confirmation emails
  • Updating inventory
  • Handling failed payments

Setting Up Webhooks

  1. Go to your Dashboard
  2. Add your endpoint URL (e.g., https://yoursite.com/webhooks/atlas)
  3. Select the events you want to receive
  4. Copy your webhook signing secret

Event Types

Webhook Payload

Verifying Signatures

Always verify webhook signatures to ensure requests are from Atlas:

Best Practices

  1. Return 200 quickly - Process webhooks asynchronously to avoid timeouts
  2. Handle duplicates - Use idempotency keys or check if you’ve already processed the event
  3. Verify signatures - Always verify the x-atlas-signature header
  4. Use HTTPS - Webhook endpoints must use HTTPS in production
  5. Retry logic - Atlas retries failed webhooks with exponential backoff

Retry Policy

If your endpoint returns a non-2xx status code, Atlas will retry: After 5 failed attempts, the webhook is marked as failed and won’t be retried.