🪝 Webhooks

Webhooks allow you to subscribe to events from Coinflow about when a seller has registered their account.

Setup

1. Navigate to your marketplace dashboard

• Production
• Sandbox

2. Copy your Webhook Validation Key.

🚧

Keep this Validation Key secret, but if it gets leaked you can easily regenerate it.

3. Select Version 2

4. Select the event types to listen to.

• For seller registration events, select:

  • Sub-Merchant KYB Created, Sub-Merchant KYB Success, Sub-Merchant KYB Failure
  

3. Enter a URL route to your server endpoint

4. In your server, create a route that accepts a POST request on that url and route

🚧

Ensure that the Authorization header in this request matches your Validation Key to verify its origin as Coinflow.

router.post('/submerchant-webhook', async (req, res) => {  
	try {
    const {data} = req.body;
    const {merchantId} = data;
    
    console.log(`Merchant KYB: ${merchantId}`);
    
    const authHeader = req.get('Authorization');
    
    // Authorize using your validation key
    if (authHeader !== process.env.COINFLOW_VALIDATION_KEY)
      throw new ControllerError('User not allowed', 401);
    else handleEvent() // react to event
    
    res.sendStatus(200);
  } catch (e) {  
    handleError(res, e);  
  }  
});

📘

Webhooks will retry until your server returns a 200 response code

or until it times out after 36 hours. Webhooks will also time out after 5 seconds without a response and will retry, so make sure your server responds within 5 seconds.

5. The webhooks will contain the following data:

{
  eventType: string,
  category: 'Sub-merchant KYB Created' || 'Sub-merchant KYB Success' || 'Sub-merchant KYB Failure',
  data: {
  	merchantId: string,
  	email: string,
	},
}

6. Done! Try listening to different event types by subscribing to the different options below

Event Types