Payment Due Webhook Integration Guide

This guide explains the exact webhook URL/path and integration steps for both Web backend and Android.

1) Webhook Paths

Local testing path (already available in Laravel)

Production path (receiver in client system)

Set this production URL inside each device row: device_payment_dues.client_webhook_url.

2) Payload You Must Send

{
  "device_id": "IMEI_NUMBER"
}

• device_id = IMEI/Serial of device (mandatory)
• Receiver should identify the target user/device using this IMEI.

3) Required Headers

Content-Type: application/json
Accept: application/json
X-Webhook-Token: your-secret-token (optional but recommended)

4) Web Integration (PHP/Laravel/Node Backend)

Your web backend should expose a POST endpoint, receive payload, identify device using device_id, and update status.

Identify which device to notify using: device_id

Expected response to webhook sender

{
  "status": true,
  "message": "received"
}

5) Android Integration (Important)

Android app should not directly receive webhooks. Webhook must go to Android team's backend API first.

• Step 1: Android backend receives webhook payload.
• Step 2: Backend finds app user/device by device_id.
• Step 3: Backend sends push notification to app via FCM.

Recommended Android backend path

6) Curl Test Commands

Local receiver test

curl -X POST "https://chronextechnologies.com/demo/pos/api/webhooks/payment-due/test-receiver" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "device_id":"LOCAL_IMEI_001"
  }'

Production/client backend test

curl -X POST "https://your-domain.com/webhooks/payment-due/receive" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Webhook-Token: your-secret-token" \
  -d '{
    "device_id":"356938035643809"
  }'

7) Laravel Sender Commands

# Process real due webhooks from DB
php artisan payments:process-due-webhooks --days=2

# Manual webhook send test
php artisan payments:test-webhook "https://chronextechnologies.com/demo/pos/api/webhooks/payment-due/test-receiver" \
  --device_id=LOCAL_IMEI_001

8) Logs and Debugging

• Webhook logs: storage/logs/payment-webhook-YYYY-MM-DD.log
• App fallback logs: storage/logs/laravel.log

# View latest webhook logs
tail -n 100 storage/logs/payment-webhook-$(date +%Y-%m-%d).log

9) Final Checklist

• Save correct client_webhook_url per device/contract.
• Store real IMEI in device_id.
• Use device_id on receiver side to target correct device.
• Receiver must return HTTP 200 for success.