---
updatedAt: 2026-09-11T20:23:58.000Z
agentTools:
  projectIndex: https://docs.staxpayments.com/llms.txt
---

# Partner Webhooks

# Partner Webhooks

Partner webhooks let you receive notifications about events in your account. These webhooks are essential for building integrations and keeping your systems synchronized with data.

<Tabs>
  <Tab title="Overview">
    ## What are Partner Webhooks?

    Partner webhooks are HTTP callbacks that sends to your specified endpoints when certain events occur in your account. They enable real-time notifications and help you build powerful integrations.

    ### Key Benefits

    <Cards columns="2">
      <Card title="Real-time Updates" icon="fa-bolt">
        Receive instant notifications when events occur in your account
      </Card>

      <Card title="Automated Workflows" icon="fa-cogs">
        Trigger automated processes based on events
      </Card>

      <Card title="Data Synchronization" icon="fa-sync">
        Keep your systems in sync with data changes
      </Card>

      <Card title="Custom Integrations" icon="fa-puzzle-piece">
        Build custom integrations with third-party services
      </Card>
    </Cards>

    ### How It Works

    1. **Configure** your webhook endpoint
    2. **Subscribe** to specific events you want to monitor
    3. **Receive** HTTP POST requests when events occur
    4. **Process** the webhook payload in your application
  </Tab>

  <Tab title="Setup & Configuration">
    ## Setting Up Partner Webhooks

    <Accordion title="Step 1: Create Your Webhook Endpoint" icon="fa-server">
      Create an HTTP endpoint in your application that can receive POST requests. This endpoint should:

      * Accept HTTP POST requests
      * Validate the webhook signature for security
      * Process the webhook payload
      * Return a 2xx status code to acknowledge receipt

      ```javascript
      app.post('/webhook/create-merchant', (req, res) => {
        // Validate signature
        // Process webhook data
        res.status(200).send('OK');
      });
      ```
    </Accordion>
  </Tab>
</Tabs>

## Testing Tools

For testing and development, you can use services like [webhook.site](https://webhook.site) to create temporary webhook endpoints that help you inspect the payloads ReadMe sends.

## Need Help?

<Cards columns="2">
  <Card title="API Reference" href="/reference/partner-webhook-events" icon="fa-book">
    Complete listing of Webhook events.
  </Card>

  <Card title="Merchant Webhooks" href="/reference/merchant-webhooks" icon="fa-tachometer-alt">
    Learn more about merchant webhooks.
  </Card>
</Cards>