๐Ÿ”— Fairlane Webhook API

Standard Chartered Open Banking โ†’ Business Central Integration

โœ“ Service Online

๐Ÿ“ก Available Endpoints

GET /api/fairlane/health

Health check endpoint - verify the service is running

GET /api/fairlane/test-bc

Test Business Central connection status

POST /api/fairlane/webhook

Main webhook endpoint - receives payment notifications from Standard Chartered

๐Ÿ“ Webhook Payload Example

{
  "EventId": "evt-12345-abcde",
  "EventType": "payment.completed",
  "Timestamp": "2026-02-26T10:30:00Z",
  "Data": {
    "TransactionId": "TXN-2026-001",
    "Amount": 15000.00,
    "Currency": "KES",
    "Status": "completed",
    "Narration": "Payment for Invoice INV-001"
  }
}

๐Ÿงช Test with cURL

# Health Check
curl -X GET https://your-domain/api/fairlane/health

# Send Test Webhook
curl -X POST https://your-domain/api/fairlane/webhook \
  -H "Content-Type: application/json" \
  -d '{
    "EventId": "test-001",
    "EventType": "payment.completed",
    "Timestamp": "2026-02-26T10:30:00Z",
    "Data": {
      "TransactionId": "TXN-TEST-001",
      "Amount": 5000.00,
      "Currency": "KES",
      "Status": "completed",
      "Narration": "Test payment"
    }
  }'

๐Ÿ”— Quick Links