Webhook de test

Envoie une notification de test à l'URL Webhook. Cette méthode permet de vérifier la disponibilité de votre endpoint, le traitement des données entrantes et la réception des notifications sans créer de paiement réel.

URL

Autorisation requise

POST

https://api.fps.pro/invoices/webhook/test

Format de requêteapplication/json

id

uuid

Identifiant d'un paiement inexistant

Par défaut: generated

webhook_link

required

url

URL à laquelle le statut du paiement sera renvoyé

status

string

Statut du paiement

Par défaut: paid

Format de réponsedata object

status

number

Statut HTTP de l'envoi du webhook vers votre endpoint

response_body

json

Corps de réponse reçu après l'envoi des données vers votre endpoint

Exemples de requête

curl --request POST 'https://api.fps.pro/invoices/webhook/test' \
  --header 'Content-Type: application/json' \
  --header 'X-Client-Id: YOUR_CLIENT_ID' \
  --header 'X-Timestamp: 1720000000' \
  --header 'X-Signature: YOUR_HMAC_SHA256_SIGNATURE' \
  --data '{
  "id": "0a718b02-131d-495a-9641-39ca52139c07",
  "webhook_link": "https://merchant.example.com/webhooks/fps",
  "status": "paid"
}'

Réponse réussie

{
  "status": 200,
  "message": "success",
  "data": {
    "status": 200,
    "response_body": "Webhook receive"
  }
}

Erreurs

La liste détaillée des erreurs d'autorisation se trouve dans Autorisation - Erreurs

{
  "status": 403,
  "message": "Forbidden"
}
{
  "status": 422,
  "message": "Validation Error",
  "data": {
    "field": "name",
    "message": "field validation error"
  }
}
{
  "status": 500,
  "message": "Internal Server Error"
}