Webhook Events Coming Soon
Real-Time Payments are coming soon. This preview gives you an early look at the expected experience so you can begin planning your integration.
RTP received payments reuse the existing receivedPayment.* webhook event types. The attributes.type field is Realtime (alongside Ach and Wire). RTP-specific fields such as counterparty, description, returnReason, and rejectReason appear in the event payloads below.
receivedPayment.created
Occurs when a Realtime Received Payment is created.
{
"data": [
{
"id": "1337",
"type": "receivedPayment.created",
"attributes": {
"createdAt": "2026-07-08T09:30:00.000Z",
"status": "Pending",
"type": "Realtime",
"amount": 100000,
"description": "Payroll deposit",
"counterparty": {
"name": "PAYROLL SERVICES INC",
"routingNumber": "026009593",
"accountNumber": "5551234567"
},
"tags": {}
},
"relationships": {
"receivedPayment": {
"data": {
"id": "30176754",
"type": "receivedPayment"
}
},
"account": {
"data": {
"id": "2150353",
"type": "account"
}
},
"customer": {
"data": {
"id": "1802611",
"type": "customer"
}
}
}
}
]
}
receivedPayment.rejected
Occurs when a Realtime Received Payment is rejected. See RTP Reject Reasons for possible reject reasons.
{
"data": [
{
"id": "1338",
"type": "receivedPayment.rejected",
"attributes": {
"createdAt": "2026-07-09T10:05:00.000Z",
"status": "Rejected",
"type": "Realtime",
"amount": 150000,
"description": "Vendor payment",
"counterparty": {
"name": "SUPPLY CO",
"routingNumber": "026009593",
"accountNumber": "4445556666"
},
"rejectReason": "ClosedAccountNumber",
"tags": {}
},
"relationships": {
"receivedPayment": {
"data": {
"id": "30176755",
"type": "receivedPayment"
}
},
"account": {
"data": {
"id": "2150353",
"type": "account"
}
},
"customer": {
"data": {
"id": "1802611",
"type": "customer"
}
}
}
}
]
}
receivedPayment.returned
Occurs when a Realtime Received Payment is returned. See RTP Return Reasons for possible return reasons. The fund reversal is made by originating an ACH payment — see Returns.
{
"data": [
{
"id": "1337",
"type": "receivedPayment.returned",
"attributes": {
"createdAt": "2026-07-09T15:12:01.120Z",
"status": "Returned",
"type": "Realtime",
"amount": 250000,
"description": "Invoice 9176",
"counterparty": {
"name": "ACME CORP",
"routingNumber": "021000021",
"accountNumber": "1234567890"
},
"returnReason": "InsufficientFunds",
"tags": {}
},
"relationships": {
"receivedPayment": {
"data": {
"id": "30176753",
"type": "receivedPayment"
}
},
"account": {
"data": {
"id": "2150353",
"type": "account"
}
},
"customer": {
"data": {
"id": "1802611",
"type": "customer"
}
}
}
}
]
}
receivedPayment.timedOut
Occurs when a Realtime Received Payment times out before settlement completes.
{
"data": [
{
"id": "1339",
"type": "receivedPayment.timedOut",
"attributes": {
"createdAt": "2026-07-09T08:00:00.000Z",
"status": "TimedOut",
"type": "Realtime",
"amount": 50000,
"description": "Refund",
"counterparty": {
"name": "RETAIL PARTNER",
"routingNumber": "121000248",
"accountNumber": "1112223333"
},
"tags": {}
},
"relationships": {
"receivedPayment": {
"data": {
"id": "30176756",
"type": "receivedPayment"
}
},
"account": {
"data": {
"id": "2150353",
"type": "account"
}
},
"customer": {
"data": {
"id": "1802611",
"type": "customer"
}
}
}
}
]
}
receivedPayment.completed
Occurs when a Realtime Received Payment is completed.
{
"data": [
{
"id": "411",
"type": "receivedPayment.completed",
"attributes": {
"createdAt": "2026-07-10T22:43:35.000Z",
"previousStatus": "Pending",
"type": "Realtime",
"amount": 50000,
"description": "Refund",
"counterparty": {
"name": "RETAIL PARTNER",
"routingNumber": "121000248",
"accountNumber": "1112223333"
},
"tags": {}
},
"relationships": {
"receivedPayment": {
"data": {
"id": "30176752",
"type": "receivedPayment"
}
},
"account": {
"data": {
"id": "2150353",
"type": "account"
}
},
"customer": {
"data": {
"id": "1802611",
"type": "customer"
}
}
}
}
]
}
transaction.created
Occurs when a Received Realtime Payment Transaction is created. This happens when a received RTP payment is completed.
{
"data": [
{
"id": "34",
"type": "transaction.created",
"attributes": {
"summary": "RTP from WFG NATL TITLE CO OF",
"direction": "Credit",
"amount": 6911520,
"balance": 6911520,
"createdAt": "2026-07-10T22:43:34.385Z",
"tags": {}
},
"relationships": {
"transaction": {
"data": {
"id": "9547",
"type": "receivedRealtimePaymentTransaction"
}
},
"account": {
"data": {
"id": "2150353",
"type": "account"
}
},
"customer": {
"data": {
"id": "1802611",
"type": "customer"
}
}
}
}
]
}