Chargement de vos clés API…

Déclarer une adresse de réception

POSThttps://staging.mobupay.nc/api/v1/agency/webhooks

Ce que fait cet appel

Déclare une adresse de réception des événements de votre agence. Mobupay y envoie une requête POST signée au format { id, type, createdAt, data }, avec les en-têtes X-Mobupay-Event, X-Mobupay-Timestamp et X-Mobupay-Signature-V2 (HMAC SHA-256 de <timestamp>.<corps>, avec le secret rendu ici une seule fois).

L'environnement de l'adresse est celui de votre clé. Un événement réel part vers vos adresses de test ET de production ; un événement simulé vers vos seules adresses de test.

Événements : agency.invitation.created, agency.invitation.expired, agency.invitation.cancelled, agency.client.onboarding.updated, agency.client.opened, agency.mandate.created, agency.mandate.updated, agency.mandate.revoked. Portée de clé requise : webhooks.write.

En-tête d'authentification

Authorization: Bearer sk_test_XXXX

Le pool est déduit du préfixe de la clé

Il n'y a pas d'interrupteur test et production sur cette page. sk_test_* ne traite aucun paiement réel, sk_live_* encaisse.

Corps de la requête

application/json

urlstring · uriRequis

Adresse HTTPS.

eventsarray[string]Requis

events[0]

events[1]

Codes de retour

201

Adresse déclarée. Le secret n'est rendu qu'ici.

400

Corps invalide, adresse qui n'est pas en HTTPS, ou événement qui n'est pas un événement d'agence.

Langage

Requête cURLpostExemple

1curl --request POST \

2 --url https://api.mobupay.nc/api/v1/agency/webhooks \

3 --header 'authorization: Bearer sk_test_XXXX' \

4 --header 'content-type: application/json' \

5 --data '{ "url": "https://app.agence.nc/webhooks/mobupay", "events": [ "agency.client.onboarding.updated", "agency.mandate.revoked" ] }'

Réponse

Cliquez sur Essayer pour lancer la requête et voir la réponse ici. Ou choisissez un exemple :

application/json