Card Updated

This event is sent when a card’s details or status change. The event type is card.updated. data.object is the card as it is after the change.

USD card verification

A new USD virtual card can be created with status pending while the card partner verifies the customer (KYC). You receive card.updated with the result:

Case	`status`	What else changes
Verification passed	`active`	The card details (`maskedPan`, `last4`, `expiryMonth`, `expiryYear`) are filled in. The card can now be used and funded.
Verification still in progress	`pending`	Nothing else. Wait for the next `card.updated`.
Verification failed or the card was canceled	`canceled`	`cancellationReason` explains why when a reason is provided.

A canceled card can’t be used, funded or reactivated. When a card fails verification, fix the customer’s details using cancellationReason (see USD card requirements), then create a new card.

{
    "type": "card.updated",
    "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": "30",
            "status": "active"
        }
    }
}

{
    "type": "card.updated",
    "environment": "production",
    "business": "xxxxxxxxxxxxx",
    "data": {
        "object": {
            "_id": "63edff25e63a129196e34c62",
            "business": "xxxxxxxxxxxxx",
            "customer": "xxxxxxxxxxxxx",
            "type": "virtual",
            "brand": "Visa",
            "currency": "USD",
            "status": "canceled",
            "cancellationReason": "ID document could not be verified"
        }
    }
}

Overview

Getting Started

Cards

Controls

Purchases

Webhooks

Cloud Card

USD card verification

​USD card verification

USD card verification