CounterpartyIncomingPayment webhook topic
· One min read
CounterpartyIncomingPayment webhook topic
Funding you receive from a counterparty over bank rails now fires a webhook. Subscribe to the new CounterpartyIncomingPayment topic to reconcile deposits into a counterparty's account without polling the counterparty balance.
The event is sent after the payment has been recorded, so the counterparty balance already reflects it when the webhook arrives.
Included payload
| Field | Description |
|---|---|
counterpartyId | The counterparty whose account received the payment |
merchantId | The merchant that owns the counterparty |
amount | Payment amount in cents |
currency | ISO 4217 currency code |
direction | credit for funds received, debit for funds withdrawn |
method | The bank rail, for example ach or wire |
asOfDate | Bank settlement date, as YYYY-MM-DD |
externalIncomingPaymentId | Payment identifier at the banking provider, for reconciliation against your bank records |
If you subscribe with the "*" wildcard, you are already receiving this topic — make sure your handler tolerates it.