Card Termination

This event is sent when a card’s remaining balance is returned to you. The event type is card.terminated. It’s sent when:

a card is terminated and still had a balance, or
a USD card failed verification (KYC) and the amount it was funded with is returned. See When verification fails.

data.object is the card, with status set to canceled and balance set to the amount returned. The amount is credited to your business’s USD settlement account.

A card’s balance is returned only once, so you receive one card.terminated per card. If the same event is delivered again, handle it idempotently using the card _id.

{
    "type": "card.terminated",
    "environment": "production",
    "business": "xxxxxxxxxxxxx",
    "data": {
        "object": {
            "_id": "63edff25e63a129196e34c62",
            "business": "xxxxxxxxxxxxx",
            "customer": "xxxxxxxxxxxxx",
            "account": "xxxxxxxxxxxxx",
            "fundingSource": "xxxxxxxxxxxxx",
            "type": "virtual",
            "brand": "MasterCard",
            "currency": "USD",
            "maskedPan": "519075*******3531",
            "last4": "3531",
            "expiryMonth": "11",
            "expiryYear": "2027",
            "status": "canceled",
            "balance": 12.34
        }
    }
}

Overview

Getting Started

Cards

Controls

Purchases

Webhooks

Cloud Card