---
title: "$viva->webhooks->parse()"
method: POST
path: "/Webhooks/parse"
tags: ["Webhooks"]
---

# $viva->webhooks->parse()

`POST /Webhooks/parse`

Parse le payload JSON d'un webhook POST envoyé par Viva.

```php
// Dans votre contrôleur (Laravel) :
public function handleVivaWebhook(Request $request)
{
    $event = $viva->webhooks->parse($request->getContent());

    echo $event['event_type'];     // 'transaction.payment.created'
    echo $event['event_type_id'];  // 1796
    echo $event['event_data'];     // Données de l'événement

    match ($event['event_type']) {
        'transaction.payment.created' => $this->handlePayment($event['event_data']),
        'transaction.refund.created'  => $this->handleRefund($event['event_data']),
        default => null,
    };
}
```

## Request body

- object
  - `rawBody` string, required — Corps JSON brut du POST webhook

## Response `200`

Événement parsé

- WebhookParsedEvent
  - `event_type` string — Type d'événement lisible (ex: `transaction.payment.created`)
  - `event_type_id` integer — ID numérique du type d'événement Viva
  - `event_data` object — Données de l'événement (structure variable selon le type)

## Other responses

- `400` — `InvalidArgumentException` — JSON invalide

---

[API](https://skmtc.net/qrcommunication/apis/viva-wallet-merchant-sdk-re-fe-rence-php.md) · [All operations](https://skmtc.net/qrcommunication/apis/viva-wallet-merchant-sdk-re-fe-rence-php/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qrcommunication/viva-wallet-merchant-sdk-re-fe-rence-php/versions/bcafd06ce584/schema)