Skip to main content
Weavr API
Managed cards

Card payment update

Webhook/managed_cards/payments/watch

Sent each time a card payment (the aggregate of related authorizations, settlements, reversals, refunds, and original credits) is created or updated. The payload carries the full current state of the CardPayment, including its complete event history with running-total snapshots after each event.

Use this instead of subscribing to the per-event-type webhooks — Card authorization, Card settlement — when you want to track the overall card payment from a single webhook.

Enable and configure webhooks in the Embedder Portal; recent events are listed on its Webhook Logs page. Weavr sends this event to {Webhook URL}/managed_cards/payments/watch.

Payload

*
application/json

Sent on the /managed_cards/payments/watch webhook each time a card payment is created or updated. Unlike the per-event-type card webhooks (authorization, settlement, adjustment, ...), this carries the full current state of the CardPayment aggregate, including its complete events[] history — so a single subscription can track the overall card payment without also subscribing to the per-event-type webhooks.

A status-only update, sent when a hold is released without a new scheme message, adds no event: eventType is AUTHORISATION, events[] is unchanged and lastUpdatedTimestamp is the time of the status change. The same applies when an event already in events[] is processed later and changes the status (for example, a settlement recorded before it closed the hold), except that eventType is that event's type.

{}
ManagedCardPaymentEventManagedCardPaymentEvent · object · 2 fields

Responses

204No Content

Event received.