PAYCOW / DOCUMENTATION
Events & payloads
Receive and verify real-time payment events.
Event Types & Payload
Webhook events fired on on-chain state transitions
| Event Type | Transition | Description |
|---|---|---|
payment.detected | PENDING → DETECTED | Deposit observed in mempool |
payment.confirming | DETECTED → CONFIRMING | Accumulating block confirmations |
payment.paid | CONFIRMING → PAID | Fulfill order or credit balance |
payment.expired | PENDING → EXPIRED | 30-min window elapsed |
payment.rejected | ANY → REJECTED | Manually rejected or invalidated |
webhook.test | N/A | Test 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.