# Subscribe to Multi Card Webhooks (/docs/guides/multi-card/multi-card-webhooks) 

# 📬 Multi Card Webhook Events [#-multi-card-webhook-events]

Hands In supports a real-time webhook notification system so your system can stay in sync with payment activity. You can subscribe to a set of webhook events to receive updates when key actions occur within a session.

***

## 🛠️ Setting Up a Webhook [#️-setting-up-a-webhook]

<img src="/docs-assets/c6b053baaf4734990a82578154babcbebf572a86e76c27db117329cfa81a1d07-multi-card-webhooks.png" />

To add a webhook:

1. Log in to your [**Hands In Merchant Dashboard**](https://merchant.handsin.com).
2. Navigate to Developers > [**Webhooks**](https://merchant.handsin.com/dashboard/developers/webhooks)
3. Click **Add Webhook**.
4. Provide the following:
   * A webhook **name**
   * A **URL** where you wish to receive `POST `requests. (must be HTTPS - can use tunnel services like [**ngrok**](https://ngrok.com/) for development/testing )
   * Lastly, select the **multi card events** you wish to subscribe to from the dropdown list

<Callout type="warn">
  **Note:** Before going live, you will need to register webhooks for both sandbox and live environments separately.
</Callout>

## 📋 Multi Card Webhook Event Types [#-multi-card-webhook-event-types]

Use the dropdown during webhook setup to subscribe to any of the following events:

| Event Type             | Description                                         |
| ---------------------- | --------------------------------------------------- |
| `MULTI_CARD_CREATED`   | A new multi card payment session was created.       |
| `MULTI_CARD_UPDATED`   | An existing multi card payment session was updated. |
| `MULTI_CARD_APPROVED`  | The multi card payment session was approved.        |
| `MULTI_CARD_COMPLETED` | The multi card payment session was completed.       |
| `MULTI_CARD_EXPIRED`   | The multi card payment session has expired.         |
| `MULTI_CARD_CANCELLED` | The multi card payment session was cancelled.       |
| `MULTI_CARD_REFUNDED`  | The multi card payment was refunded.                |

<Callout type="info">
  For a full list of events across the platform, see [Webhook Event Reference](/docs/webhooks/webhooks-events) for more details.
</Callout>

## 📦 Example Webhook Payload [#-example-webhook-payload]

When an event is triggered, Hands In sends a `POST` request to your webhook URL with the following payload:

```json
{
  "id": "eventId",
  "eventType": "MULTI_CARD_CREATED",
  "merchantId": "merchant_456",
  "createdAt": "2025-05-06T12:00:00Z",
  "multiCardId": "multicard_789",
  "data": {
    // ... event-specific object (e.g., multicard payment session)
  }
}
```

You can then perform your business logic accordingly based on the `eventType`. For example, when you receive `MULTI_CARD_COMPLETED`, you might want to email the customer from your system with the necessary information.

***