MERCHANT APPROVED

Event Overview

Event Type: MERCHANT_APPROVED
Category: Onboarding
Description: Merchant account has been approved and activated This webhook is triggered when a merchant account is approved and can start collecting payments through EximPe.

Delivery Details

Attribute	Value
HTTP method	`POST`
URL	The webhook URL configured on your merchant account’s API credentials
Content-Type	`application/json`
Timeout	10 seconds
Retries	Up to 5 delivery attempts (backoff: 1 min, 5 min, 15 min, 60 min)

Headers

Header	Description
`Content-Type`	`application/json`
`User-Agent`	`Eximpe-Webhook/1.0`
`X-Webhook-Event`	`MERCHANT_APPROVED`
`X-Webhook-Timestamp`	Unix timestamp (string) at the time of the request
`X-Webhook-Signature`	HMAC-SHA256 signature of the request body (JSON string with keys sorted, no extra whitespace), using your API key as the secret. Hex-encoded.

Signature verification (recommended):
Compute HMAC-SHA256(encryption_key, raw_body) where raw_body is the exact UTF-8 request body as received. Compare the hex result with the X-Webhook-Signature header to ensure the webhook is from the platform and unchanged.

Payload Schema

{
    "event_type": "MERCHANT_APPROVED",
    "event_time": "2024-12-15 14:32:18",
    "version": "1.0",
    "sequence_number": "a3791670-7c5d-4a86-aa7a-fe35e58a9dbb",
    "data": {
        "approved_at": "2024-12-15T14:32:18.456789Z",
        "merchant_id": "1380229823",
        "legal_name": "TechStore Solutions Private Limited",
        "trade_name": "TechStore Online"
    }
}

Field Specifications

Root Level Fields
Data Object Fields

string

required

Always "MERCHANT_APPROVED" for this webhook event

string

required

Timestamp when the event occurred in YYYY-MM-DD HH:MM:SS formatExample: "2024-12-15 14:32:18"

string

required

Webhook payload version (currently “1.0”)

string

required

Unique identifier for the event instanceExample: "a3791670-7c5d-4a86-aa7a-fe35e58a9dbb"

object

required

Event-specific data payload containing merchant approval details

string

required

ISO 8601 timestamp when the merchant was approvedExample: "2024-12-15T14:32:18.456789Z"

string

required

Unique identifier for the approved merchantExample: "1380229823"

string

required

Legal business name of the merchant as registered with authoritiesExample: "TechStore Solutions Private Limited"

string

required

Trading or brand name of the merchant used for customer-facing operationsExample: "TechStore Online"

Order

Payment

Card Tokens

Merchant

Settlement

Refund

Subscriptions

Payment Links

Utilities

Webhooks

Event Overview

Delivery Details

Headers

Payload Schema

Field Specifications

​Event Overview

​Delivery Details

​Headers

​Payload Schema

​Field Specifications

Event Overview

Delivery Details

Headers

Payload Schema

Field Specifications