paymentDetails Webhook

📡 Payment Details Webhook

This webhook provides your system with the full and latest payment details for a booking whenever a relevant update occurs. Unlike the paymentEvent webhook — which focuses on status changes — this webhook delivers a complete snapshot of all payment records, amounts, and breakdowns tied to the booking.

It ensures your internal systems always have the most up-to-date and detailed view of payment activity.

This webhook is optional — you can rely solely on the paymentEvent webhook in combination with the getPaymentStatus API if preferred.

🛠 What You Need to Do

Expose an endpoint in your system to receive POST requests from Fikäfi.

Verify the signature (if enabled) to ensure the request is from a trusted source.

Parse the payload and update your internal payment records accordingly.

Respond with HTTP 200 OK within 5 seconds to acknowledge receipt.

🔐 Webhook Headers

Header Name	Type	Required	Description
`Content-Type`	string	✅ Yes	Must be `application/json`
`X-Signature`	string	✅ Yes	HMAC signature for verifying payload authenticity (if security is enabled)

curl --location --request POST 'http://sandbox.fikafi.com/FikafiApi/api/payment/paymentDetails' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIzMmVkOTI0OC1kNTc4LTQ3NzUtODYwYS1iZGZkOGExM2Y0MzciLCJ1bmlxdWVfbmFtZSI6IkFkbWluIiwiVXNlcklEIjoiMSIsIm5iZiI6MTc0MDM5Mzg4NywiZXhwIjoxNzQwNDgwMjg3LCJpYXQiOjE3NDAzOTM4ODd9.J6oPTYH9x5ia_a7OUBj9K038o8gu04gL4kLuVyJ8RQo' \ --header 'Content-Type: application/json' \ --data-raw '{ "bookingRefNum": "BKG20250401", "fikafiRefNum": "FIK987654", "paymentStatus": { "status": "Completed", "isCardCaptured": true, "currency": "USD", "totalAmountReq": 1000, "totalAmountPaid": 1000, "numOfPaymentsReq": 2, "numOfPaymentsPaid": 2 }, "payments": [ { "paymentNumber": 1, "amount": 500, "date": "2025-04-01", "status": "Paid", "paidAt": "2025-04-01T10:00:00Z" }, { "paymentNumber": 2, "amount": 500, "date": "2025-04-15", "status": "Paid", "paidAt": "2025-04-15T11:30:00Z" } ] }'