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"
    }
}
ParameterTypeDescription
idstringID of the card.
account_numberstringPayMongo Wallet account number
cardholderstringID of the cardholder owning the card.
card_programstringID of the card program containing the card.
namestringName of the card.
currencystringBilling currency of the card.
typestringphysical or virtual
statusstringStatus of the card. See card statuses below for more details.
last4stringLast 4 digits of the card number.
exp_monthnumberMonth of the card expiry.
exp_yearnumberYear of the card expiry.
livemodebooleanThe value is true if the resource exists in live mode or false if the resource exists in test mode.
created_attimestampDate when the card was created.
updated_attimestampDate when the card was updated.

Card statuses

StatusDescription
pendingInitial status of all cards upon creation. A "pending" card cannot transact.
activeStatus of a card upon successful activation. An "active" card can transact.
lockedThe card has been locked upon suspicion of loss or theft.
suspendedThe card has been locked upon suspicion of fraud. This is a terminal status.
cancelledThe card has been cancelled and can no longer transact. This is a terminal status.