Seeds Webhook

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 event	When the event gets sent
merchant.activated	Triggers when a child merchant is activated, providing their details and any feature-specific information.
merchant.declined	Triggers when a child merchant is declined, providing details about the declined merchant.
consumer.activated	Triggers when a related consumer is activated, providing their details and any feature-specific information.
consumer.declined	Triggers 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.