Developer Webhooks

Webhook Registration Console

Register your endpoint URL and keep the signing secret safe. Use Sandbox first, then verify every delivery before Production.

// Developer Notes

How deliveries work

Every event is sent as a signed JSON payload via HTTPS POST.
Verify the signature header with your secret before processing.
Respond with 2xx within 10 seconds; failed deliveries are retried.
Test all event types in Sandbox before switching to Production.

Test in Sandbox

Choose Event Types

Select the events your application needs, including payouts, marketplace orders, and compliance updates.

Save Event Types

☑ payout.completed

Fires when a farmer payout settles, fails, or is reversed. Includes amount, currency, and transaction reference.

☑ marketplace.order

Order created, updated, or fulfilled on the TFarms marketplace, with buyer, listing, and status details.

☐ intelligence.update

Compliance, risk, and crop intelligence updates, plus farmer Android app activity events.

Send a Test Event

Send a sample webhook to your registered endpoint and confirm your signature verification and response handling.

Payout Event

payout.completed — signed JSON with payout ID, amount, currency and recipient account.

Fire Event

Marketplace Event

marketplace.order_created — order ID, listing, buyer, quantity and total.

Intelligence Event

intelligence.insight_ready — report ID, farm region, model and risk score.

Farmer Android Event

farmer.android_sync — farmer ID, device, app version and sync timestamp.

Webhook Delivery History

Review recent deliveries, response codes, and retry attempts while you debug your integration.

Timestamp

Event Type

Status

Response

Retries

2025-01-14 10:42:08 UTC

payout.completed

Delivered

200 OK

2025-01-14 10:37:51 UTC

marketplace.order.created

Delivered

200 OK

2025-01-14 10:21:16 UTC

intelligence.report.ready

Retrying

503

2025-01-14 09:58:02 UTC

farmer.android.sync

Delivered

202 Accepted

View Delivery Logs