PAYCOW / DOCUMENTATION

Events & payloads

Receive and verify real-time payment events.

Event Types & Payload

Webhook events fired on on-chain state transitions

Event TypeTransitionDescription
payment.detectedPENDING → DETECTEDDeposit observed in mempool
payment.confirmingDETECTED → CONFIRMINGAccumulating block confirmations
payment.paidCONFIRMING → PAIDFulfill order or credit balance
payment.expiredPENDING → EXPIRED30-min window elapsed
payment.rejectedANY → REJECTEDManually rejected or invalidated
webhook.testN/ATest ping from dashboard

Standard Payload

{
  "id": "evt_01k4xyz123abc987",
  "type": "payment.paid",
  "apiVersion": "2026-09-01",
  "createdAt": "2026-09-09T12:45:31.124Z",
  "data": {
    "sessionId": "648f3a8b1c2d3e4f5a6b7c8d",
    "paymentReference": "a1b2c3d4e5f6a7b8",
    "userId": "order_84920",
    "status": "PAID",
    "amountRequested": 50,
    "payableAmount": 50.0001,
    "amountReceived": 50.0001,
    "currency": "USDT",
    "network": "TRC20",
    "depositAddress": "TJY5TestDepositAddress12345",
    "txHash": "9e1c7f4a5b6c7d8e...",
    "confirmations": 20
  }
}

Dashboard Test Payload

{
  "id": "evt_01k4test123abc987",
  "type": "webhook.test",
  "apiVersion": "2026-09-01",
  "createdAt": "2026-09-23T12:45:31.124Z",
  "data": {
    "message": "PayCow webhook test event"
  }
}
webhook.test contains no payment data and must never trigger fulfillment.