Update Merchant Configuration

PATCH

/merchant/config

Updates your merchant configuration. Only the fields included in the request body are updated; omitted fields remain unchanged.

Common use cases include updating the minimum redemption threshold, enabling point expiration, or updating social media links.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Configuration updated successfully.

Body

🟠400Bad Request

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/merchant/config' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "minimum_threshold_amount": 100,
    "point_should_expire": true,
    "point_expiration_date": 365,
    "last_chance_email_countdown": 7,
    "reactivation_email_countdown": 30,
    "facebook": "string",
    "ig_handle": "string",
    "linked_in": "string",
    "telegram": "string",
    "tiktok": "string",
    "whatsapp": "string",
    "x_handle": "string",
    "youtube": "string",
    "snapchat": "string"
}'

Response Example

200 - Example 1

{
    "status": true,
    "message": "Merchant configuration updated successfully",
    "data": {
        "merchant_id": "merch_xyz789",
        "email": "admin@mybusiness.com",
        "full_name": "My Coffee Shop",
        "phone_number": "+2348099887766",
        "created_at": "2025-12-01T08:00:00.000Z",
        "facebook": "https://facebook.com/mycoffeeshop",
        "ig_handle": "@mycoffeeshop",
        "linked_in": "string",
        "telegram": "string",
        "tiktok": "string",
        "whatsapp": "string",
        "x_handle": "string",
        "youtube": "string",
        "snapchat": "string",
        "point_balance": 50000,
        "last_chance_email_countdown": 7,
        "minimum_threshold_amount": 100,
        "point_should_expire": true,
        "reactivation_email_countdown": 30,
        "point_expiration_date": 365,
        "minimum_threshold_updated_at": "2019-08-24T14:15:22.123Z",
        "first_name": "Tolu",
        "last_name": "Adeyemi",
        "status": "active",
        "ip_whitelist": [
            "203.0.113.50",
            "198.51.100.25"
        ],
        "webhook_url": "https://mybusiness.com/webhooks/rewrd",
        "webhook_secret": "whsec_abc123..."
    }
}

Modified at 2026-02-25 12:17:15

Get Merchant Configuration

List Earning Rules