v9

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-05-05502770.7 KB
Webhooks

$viva->webhooks->parse()

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

// 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,
    };
}
post/Webhooks/parse

Request body

rawBodystring required

Corps JSON brut du POST webhook

Response

Événement parsé

event_typestring

Type d'événement lisible (ex: transaction.payment.created)

event_type_idinteger

ID numérique du type d'événement Viva

event_dataobject

Données de l'événement (structure variable selon le type)

Example response

{
  "event_type": "transaction.payment.created",
  "event_type_id": 1796
}