Webhook

Le Webhook (ou callback) de Digitalpaye permet de recevoir des notifications en temps réel concernant les transactions effectuées via votre plateforme. Lorsqu'une transaction est effectuée avec succès ou rencontre une erreur, Digitalpaye envoie une notification à l'URL que vous avez configurée comme webhook.

URL du Webhook

Vous devez fournir une URL de réception pour le webhook afin que Digitalpaye puisse envoyer les notifications de transaction. Assurez-vous que cette URL est accessible publiquement depuis Internet.

Exemple d'URL du Webhook :

https://votre-domaine.com/webhook

Format de la Notification (Payload)

Le webhook envoie des données au format JSON contenant les détails de la transaction. Voici un exemple du format de données que vous recevrez :

{
        "ref": "6AY5E5GS2F",
        "transactionId": "b553d176-9152-4537-a536-4ad320ec773c",
        "currency": "XOF",
        "amount": "25000",
        "fees": "250",
        "amountReceive": "25000",
        "amountTotal": "25250",
        "phone": "0777101308",
        "status": "SUCCESSFUL",
        "typeTransaction": "transfer",
        "operator": "ORANGE_MONEY_CI",
        "createdAt": "2025-04-03T22:03:50.000Z",
        "customer": {
            "id": "26b35534-3165-4143-8fff-ec2f70bb430c",
            "lastName": "GUEI",
            "firstName": "HELIE",
            "email": "[email protected]",
            "phoneNumber": "0777101308",
            "address": {
                "countryCode": "CI",
                "city": "Abidjan",
                "streetAddress": "Plateau Cocody"
            },
            "createdAt": "2024-10-11T07:07:59.000Z"
        }
}

Utilisation du Webhook

Pour utiliser le webhook de Digitalpaye, configurez l'URL de réception dans votre compte Digitalpaye. Une fois configuré, Digitalpaye enverra automatiquement les notifications de transaction à cette URL en temps réel.

Pour traiter ces notifications, vous pouvez créer un script ou un endpoint sur votre serveur web pour recevoir les données JSON et effectuer les actions nécessaires en fonction du statut et des détails de la transaction reçue.