# Notifications

Each time that a Submerchant:

* is successfully onboarded through the Referral Signup Form, or 
* a change in information has occurred in a Submerchant of yours

A webhook notification will be sent to the Referral URL that you defined at:

> Merchant Panel :arrow\_right: Settings :arrow\_right: API Access :arrow\_right: **Referral URL**

{% hint style="info" %}

#### Firewall configurations

Bear in mind we will only connect through ports 80 and 443. Make sure your `Referral URL` has one of those ports open accepting connections from us.
{% endhint %}

#### Example

```json
{
    "sub_merchant_id":18703
}
```

<table><thead><tr><th width="170.91927083333331">Field</th><th width="162.45703125">Format</th><th>Description</th></tr></thead><tbody><tr><td><code>sub_merchant_id</code></td><td>Integer</td><td>Identifier of the SubMerchant on our end.</td></tr></tbody></table>

### Retrieve Submerchant details

With the received **`sub_merchant_id`** you can now retrieve the recently created Submerchant's details.

In order to do so, you can generate an API request to the <a href="broken-reference" class="button primary" data-icon="magnifying-glass">Get submerchant information</a> or you can visit the dedicated section in the Merchant Panel ("Referred merchants").

{% code title="Example response GET /v3/sub\_merchants/{sub\_merchant\_id}" %}

```json
{
    "sub_merchant_id": 18703,
    "markup_fee": 2.00,
    "sub_merchant_name": "Dunder Mifflin",
    "email": "johndoe@pandablue.com",
    "status": "ACTIVE",
    "external_submerchant_id":"user-9876"
}
```

{% endcode %}

{% hint style="success" %}

#### `markup_fee`&#x20;

The `markup_fee` is the commision that the Platform receives for each transaction successfully created by the Submerchant.\
Note that the `markup_fee` received in the response, is the default value for all recently created Submerchants. It can be aligned with your commercial representative.

You can update the value via API <a href="https://app.gitbook.com/s/VNE8t2FopKfzgQzTjlBb/platforms-booster/update-a-commission" class="button primary" data-icon="arrows-rotate-reverse">Update a comission</a> and also through the Merchant Panel (in the *Referred merchants* section).
{% endhint %}

{% hint style="warning" %}

#### `status`

Note that only Submerchants with status `ACTIVE` are capable to process payments.
{% endhint %}