API – Geliştirici dokümantasyonu

Test webhook'u

Webhook URL'ine test bildirimi gönderir. Bu yöntem gerçek ödeme oluşturmadan endpoint erişilebilirliğini, gelen veri işleme doğruluğunu ve bildirim alımını kontrol etmenizi sağlar.

URL

POST

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

İstek formatıapplication/json

`id` uuid	Mevcut olmayan ödeme tanımlayıcısı Varsayılan: generated
`webhook_link` required url	Ödeme durumunun gönderileceği URL
`status` string	Ödeme durumu Varsayılan: paid

Yanıt formatıdata object

`status` number	Webhook'un endpoint'inize gönderilmesinin HTTP durumu
`response_body` json	Endpoint'inize veri gönderildikten sonra alınan yanıt gövdesi

İstek örnekleri

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"
}'

Başarılı yanıt

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

Hatalar

Ayrıntılı yetkilendirme hataları listesi şu bölümdedir: Yetkilendirme - Hatalar

{
  "status": 403,
  "message": "Forbidden"
}

{
  "status": 422,
  "message": "Validation Error",
  "data": {
    "field": "name",
    "message": "field validation error"
  }
}

{
  "status": 500,
  "message": "Internal Server Error"
}