Webhooks

Webhooks let your systems receive events from Hello Tractor — payment completions, billing period updates, and marketplace activity (where enabled).

Register a webhook

Configure webhooks from the partner dashboard when registering or editing a connected system:

1. Provide an HTTPS endpoint URL on your servers
2. Select event types for your access permissions
3. Copy the signing secret for verification

Verify signatures

Each PAYG/collaborator request includes x-hellotractor-signature (HMAC-SHA256 of the raw body using your webhook secret):

import crypto from 'crypto'

function verify(body, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(body)
    .digest('hex')
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected),
  )
}

Collaborator payment confirmation (planned)

Funding partners may POST payment confirmations to a dedicated Hello Tractor payment endpoint (URL provided at onboarding):

{
  "customer_name": "Adaobi Farms Ltd",
  "amount_paid": "50000.00",
  "transaction_code": "BOA-TXN-20250522-001",
  "initiated_at": "2025-05-22T10:00:00Z",
  "completed_at": "2025-05-22T10:05:00Z"
}

Hello Tractor applies the payment to the matching loan, balance, and billing period. Confirm exact schema and authentication with your collaboration contact.

Event types

Event availability depends on your granted access permissions.

For booking integrations, track status by polling GET partner/booking/{booking_id}.