Cards

Card resource

Cards are payment cards your cardholders can use to pay. The PayMongo card is a Mastercard prepaid card that shares a balance with the PayMongo Wallet it is linked to. PayMongo cards are accepted wherever Mastercard is accepted locally. Currently, PayMongo supports issuing virtual cards. Support for physical cards is in development.

{
    "data": {
        "id": "card_id",
        "account_number": "1122334455",
        "cardholder": "ch_id",
        "card_program": "card_prog_id",
        "name": "First Last",
        "currency": "php",
        "type": "virtual",
        "status": "active",
        "last4": "1122",
        "exp_month": 6,
        "exp_year": 2031,
        "livemode": true,
        "created_at": "2026-06-22T10:49:44.843825838Z",
        "updated_at": "2026-06-22T10:49:44.843825838Z"
    }
}

Parameter	Type	Description
id	string	ID of the card.
account_number	string	PayMongo Wallet account number
cardholder	string	ID of the cardholder owning the card.
card_program	string	ID of the card program containing the card.
name	string	Name of the card.
currency	string	Billing currency of the card.
type	string	`physical` or `virtual`
status	string	Status of the card. See card statuses below for more details.
last4	string	Last 4 digits of the card number.
exp_month	number	Month of the card expiry.
exp_year	number	Year of the card expiry.
livemode	boolean	The value is `true` if the resource exists in live mode or `false` if the resource exists in test mode.
created_at	timestamp	Date when the card was created.
updated_at	timestamp	Date when the card was updated.

Card statuses

Status	Description
pending	Initial status of all cards upon creation. A "pending" card cannot transact.
active	Status of a card upon successful activation. An "active" card can transact.
locked	The card has been locked upon suspicion of loss or theft.
suspended	The card has been locked upon suspicion of fraud. This is a terminal status.
cancelled	The card has been cancelled and can no longer transact. This is a terminal status.