Skip to content
HitchPay API Docs

Webhooks

Card Transaction Update

Fired whenever a spend or authorization occurs on a card.

Use this webhook to

  • Get real-time notice of every purchase or authorization on a card
  • Update a customer-facing transaction feed without polling
  • Detect unusual spend quickly enough to freeze a card if needed

Event

Event Fired when
card.transaction A spend/authorization occurs on a card

Payload

{
  "event": "card.transaction",
  "data": {
    "tracking_id": "EXTCARD…",
    "customer_uuid": "…",
    "card_id": "…",
    "reference": "…",
    "amount": 12.50,
    "currency": "USD",
    "type": "PURCHASE",
    "status": "SUCCESS",
    "description": "NETFLIX.COM",
    "merchant": "…"
  }
}

Payload fields

Field Type Description
tracking_id string Card id
customer_uuid string Customer this card belongs to
card_id string Card reference
reference string Transaction reference
amount number Transaction amount
currency string USD
type string e.g. PURCHASE
status string e.g. SUCCESS
description string Merchant descriptor as it appears on the transaction
merchant string Merchant identifier, when available
  • Get Card Transactions, see the Virtual Cards section (use as a fallback if this webhook is missed)
  • See Overview & Signature Verification for how to verify the x-hitchpay-signature header before trusting this payload

Questions? Email [email protected]. Also on GitBook.