Skip to main content

Resources Coming Soon

Early preview

Real-Time Payments are coming soon. This preview gives you an early look at the expected experience so you can begin planning your integration.

Realtime Received Payment

RealtimeReceivedPayment is a JSON:API resource, top-level fields:

NameTypeDescription
idstringIdentifier of the received payment resource.
typestringType of the received payment resource. The value is always realtimeReceivedPayment.
attributesJSON ObjectJSON object representing the received payment data.
relationshipsJSON:API RelationshipsDescribes relationships between the received payment resource and other resources (account, customer, transaction).

Attributes

NameTypeDescription
createdAtRFC3339 Date stringThe date the received payment was created. Common to all receive payment types.
statusstringThe status of the Received Payment. One of Pending, Completed, Returned, Rejected, or TimedOut. See Received Payment Statuses.
amountintegerThe amount (cents) of the RTP received payment.
descriptionstringPayment description / remittance information.
counterpartyReal-Time CounterpartyThe party on the other end of the transaction. For RTP received payments, this is always the originator (in ISO20022 terminology this is referred to as the Debtor).
returnReason OptionalstringPresent when status is Returned. See RTP return reasons.
rejectReason OptionalstringPresent when status is Rejected. See RTP reject reasons.
tagsobjectSee Tags.

Relationships

NameTypeDescription
accountJSON:API RelationshipThe Deposit Account of the customer.
customerOptional, JSON:API RelationshipThe Customer the deposit account belongs to, business or individual.
receivePaymentTransactionOptional, JSON:API RelationshipThe Real-Time Payment Transaction created when the RTP is completed.
Example RealtimeReceivedPayment resource:
{
"type": "realtimeReceivedPayment",
"id": "30176752",
"attributes": {
"createdAt": "2026-07-10T22:43:34.385Z",
"status": "Completed",
"amount": 6911520,
"description": "Invoice 4821",
"counterparty": {
"name": "WFG NATL TITLE CO OF",
"routingNumber": "121000248",
"accountNumber": "9876543210"
},
"tags": {}
},
"relationships": {
"account": {
"data": {
"type": "account",
"id": "2150353"
}
},
"customer": {
"data": {
"type": "customer",
"id": "1802611"
}
},
"receivePaymentTransaction": {
"data": {
"type": "transaction",
"id": "9547"
}
}
}
}

Real-Time Payment Transaction

RealtimePaymentTransaction is a JSON:API resource, top-level fields:

NameTypeDescription
idstringIdentifier of the transaction resource.
typestringType of the transaction resource. The value is always realtimePaymentTransaction.
attributesJSON ObjectJSON object representing the transaction data.
relationshipsJSON:API RelationshipsDescribes relationships between the transaction resource and other resources (account, customer, received payment).

Attributes

NameTypeDescription
createdAtRFC3339 Date stringThe date the transaction was created. Common to all transaction types.
directionstringThe direction in which the funds flow. Common to all transaction types.
amountintegerThe amount (cents) of the transaction. Common to all transaction types.
balanceintegerThe account balance (cents) after the transaction. Common to all transaction types.
summarystringSummary of the transaction. Formatted as RTP from {counterparty.name}.
tagsobjectSee Tags.

Relationships

NameTypeDescription
accountJSON:API RelationshipThe Deposit Account of the customer.
customerOptional, JSON:API RelationshipThe Customer the deposit account belongs to. This relationship is only available if the account belongs to a single customer, business or individual.
customersOptional, Array of JSON:API RelationshipThe list of Customers the deposit account belongs to. This relationship is only available if the account belongs to multiple individual customers.
receivedPaymentJSON:API RelationshipThe Realtime Received Payment the transaction belongs to.
Example RealtimePaymentTransaction resource:
{
"type": "realtimePaymentTransaction",
"id": "9547",
"attributes": {
"createdAt": "2026-07-10T22:43:34.385Z",
"direction": "Credit",
"amount": 6911520,
"balance": 6911520,
"summary": "RTP from WFG NATL TITLE CO OF",
"tags": {
"discountCode": "VIP30"
}
},
"relationships": {
"account": {
"data": {
"type": "depositAccount",
"id": "2150353"
}
},
"customer": {
"data": {
"type": "customer",
"id": "1802611"
}
},
"receivedPayment": {
"data": {
"type": "receivedPayment",
"id": "30176752"
}
}
}
}