Managed cards

Card settlement

Sent each time a settlement is processed on a managed card — the point at which money actually moves between the cardholder and the merchant.

A settlement carries the authCode of the authorization it clears, so it can be matched back to the Card authorization event. Settlement amounts can differ from the authorized amount.

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/settlements/watch.

postWebhook/managed_cards/settlements/watch

Headers

call-refstring

A call reference generated by the caller and unique to the caller to provide correlation between the caller and system with a maximum length of 255

published-timestampinteger required

The timestamp, expressed in Epoch timestamp using millisecond precision, when this event was published.

signaturestring required

The signature to verify the authenticity of this request. This is the base64 hash (HmacSHA256) of the published-timestamp using your API key.

signature-v2string required

The signature to verify the authenticity of this request. This is the base64 hash (HmacSHA256) of the call-ref + payload + published-timestamp using your API key.

Payload

type'AUTHORISATION' | 'SETTLEMENT' | 'REFUND' | 'ORIGINAL_CREDIT' required

Type of event recorded against a CardPayment. The reversal flag on each event distinguishes a reversal from the original action.

idstring required
subtype'sale_purchases' | 'cash_withdrawals' | 'sales_with_cashback' | 'mail_or_telephone_orders' | 'account_funding' required

Card-scheme network classification of the underlying transaction being settled.

reversalboolean

True when this event reverses a prior settlement; funds return to the card. False for originals.

settlementState'PENDING' | 'COMPLETED' required

Processing state of a settlement event at the scheme.

authCodestring

Issuer authorization code (ISO 8583 DE 38) echoed from the originating authorization.

timestampinteger required

When this settlement event occurred, Epoch milliseconds.

processedTimestampinteger

When this event was processed by the platform, Epoch milliseconds.

cardPaymentIdstring required

Id of the parent CardPayment this event belongs to.

Example payload

{
  "id": "123456789",
  "transactionAmount": {
    "currency": "GBP",
    "amount": 1250
  },
  "billingAmount": {
    "currency": "GBP",
    "amount": 1250
  },
  "exchangeRate": {
    "value": 1250,
    "scale": 2
  },
  "userAmount": {
    "currency": "GBP",
    "amount": 1250
  },
  "userExchangeRate": {
    "value": 1250,
    "scale": 2
  },
  "authCode": "123456",
  "timestamp": 1786118400000,
  "processedTimestamp": 1786118401250,
  "cardPaymentId": "123456789",
  "card": {
    "id": "234567890",
    "friendlyName": "Travel card",
    "nameOnCard": "Alex Smith",
    "cardNumberFirstSix": "453201",
    "cardNumberLastFour": "0366",
    "linkedUserId": "987654321",
    "parentManagedAccountId": "123456789"
  },
  "merchant": {
    "id": "MID123456",
    "name": "Coffee Corner",
    "nameOther": "Coffee Corner Ltd",
    "networkId": "NET123456",
    "categoryCode": "5812",
    "description": "Coffee shop",
    "street": "1 High Street",
    "city": "London",
    "state": "Greater London",
    "postalCode": "W1A 1AA",
    "country": "GB",
    "telephone": "+442079460000",
    "url": "https://www.coffeecorner.example",
    "contact": "info@coffeecorner.example",
    "reference": "ORD-20260803-0001",
    "logoUrl": "https://www.coffeecorner.example/logo.png"
  }
}

Response

Event received.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.