Seeds Webhook

What are the seeds related webhooks?

To start receiving platform webhook events, you'll need to register for the relevant events and follow our Creating a Webhook guide. It's important to note that these events are only available for accounts designated as a parent merchant.

Here's a breakdown of the supported webhook events:

Webhook eventWhen the event gets sent
merchant.activatedTriggers when a child merchant is activated, providing their details and any feature-specific information.
merchant.declinedTriggers when a child merchant is declined, providing details about the declined merchant.
consumer.activatedTriggers when a related consumer is activated, providing their details and any feature-specific information.
consumer.declinedTriggers when a related consumer is declined, providing details about the declined consumer

Below are examples of the relevant webhook events that you will receive:

{
  "data": {
    "id": "evt_xxxxxxxxxxxxxxxxxxxxxxxx",
    "type": "event",
    "attributes": {
      "type": "merchant.activated",
      "livemode": true,
      "data": {
        "merchant_id": "org_xxxxxxxx",
        "account": {
          "legal_name": "Staff Merchant",
          "trade_name": "PayMongo Test Account",
          "type": "individual"
        },
        "activation_status": "activated",
        "features": [
          "payment_gateway"
        ],
        "keys": {
          "pk_live": "pk_live_xxxxxxxxr",
          "pk_test": "pk_test_xxxxxxxx",
          "sk_live": "sk_live_xxxxxxxx",
          "sk_test": "sk_test_xxxxxxxx"
        },
      },
      "previous_data": {},
      "created_at": 1746755984,
      "updated_at": 1746755984,
    }
  }
}
{
  "data": {
    "id": "evt_xxxxxxxxxxxxxxxxxxxxxxxx",
    "type": "event",
    "attributes": {
      "type": "merchant.activated",
      "livemode": true,
      "data": {
        "merchant_id": "org_xxxxxxxx",
        "account": {
          "legal_name": "Legal Name",
          "trade_name": "PayMongo Test Account",
          "type": "partnership"
        },
        "activation_status": "activated",
        "features": [
          "standard_wallet"
        ],
        "wallet": {
          "id": "wallet_xxxxxxxx",
          "account_number": "123456789101",
          "keys": {
            "sk_live": "sk_live_xxxxxxxx",
            "sk_test": "sk_test_xxxxxxxx"
          },
          "status": "activated",
          "type": "standard"
        },
      },
      "previous_data": {},
      "created_at": 1746755984,
      "updated_at": 1746755984
    }
  }
}
{
  "data": {
    "id": "evt_xxxxxxxxxxxxxxxxxxxxxxxx",
    "type": "event",
    "attributes": {
      "type": "merchant.declined",
      "livemode": true,
      "data": {
        "merchant_id": "org_xxxxxxxxxxxxxxxxxxxxxxx",
        "account": {
          "legal_name": "Jose Rizal",
          "trade_name": "Jose Rizal",
          "type": "individual"
        },
        "activation_status": "declined",
        "declined_message": "The information provided, along with our independent verification process, failed to provide a sufficient basis to meet the required Know-Your-Customer standards."
      },
      "previous_data": {},
      "created_at": 1715684435,
      "updated_at": 1715684435
    }
  }
}
{
  "data": {
    "id": "evt_xxxx",
    "type": "event",
    "attributes": {
      "type": "consumer.activated",
      "livemode": true,
      "data": {
        "consumer_id": "org_xxxx",
        "account": {
          "first_name": "John",
          "last_name": "Doe",
          "email_address": "[email protected]"
        },
        "activation_status": "activated",
        "features": [
          "fully_verified_standard_wallet"
        ],
        "wallet": {
          "id": "wallet_xxxx",
          "account_number": "1234567890",
          "keys": {
            "sk_live": "sk_live_xxxx",
            "sk_test": "sk_test_xxxx"
          },
          "status": "activated",
          "type": "fully_verified_standard"
        }
      },
      "previous_data": {},
      "created_at": 1746675190,
      "updated_at": 1746675190
    }
  }
}
{
  "data": {
    "id": "evt_xxxx",
    "type": "event",
    "attributes": {
      "type": "consumer.declined",
      "livemode": true,
      "data": {
        "account": {
          "first_name": "John",
          "last_name": "Doe",
          "email_address": "[email protected]"
        },
        "activation_status": "declined",
        "decline_message": "The information provided, along with our independent verification process, failed to provide a sufficient basis to meet the required Know-Your-Customer standards.",
        "consumer_id": "org_xxxxx"
      },
      "previous_data": {},
      "created_at": 1746598148,
      "updated_at": 1746598148
    }
  }
}

You must respond with a 2xx HTTP status code. If you do not, we will attempt to resend the event. We will retry up to twelve times, using exponential backoff. For enhanced security, refer to our guide on securing a webhook.