Cards

🚧
This is an early access feature.
If you would like your account to be configured, please contact [email protected]

Card resource

Cards are the payment cards your cardholders will be able to use to pay. The PayMongo card is a Mastercard prepaid card that shares a balance with the PayMongo Wallet it is linked to. It will be accepted wherever Mastercard is accepted locally. At the moment, we can enable the issuing of virtual cards. Support for physical cards is in the works and will be released soon.

{
  "data": {
    "id": "card_M4muYCzoZS2b5ePj4xm6Ch5M",
    "type": "card",
    "attributes": {
      "card_program_id": "card_prog_9oFXn8TRKTA6ZXyketikZucw",
      "cardholder": {
        "id": "card_holder_MS2nwM6haJxYFgLzr5Qid4Jz",
        "address": {
          "line1": "126 Beier Circle",
          "line2": "Kaley Squares",
          "city": "Manila",
          "state": "PH-MNL",
          "postal_code": "1000",
          "country": "PH"
        },
        "email": "[email protected]",
        "first_name": "Juana",
        "last_name": "Schowalter",
        "phone": "+639171162239"
      },
      "last4": "2393",
      "livemode": true,
      "status": "pending",
      "type": "virtual",
      "wallet_account": {
        "account_number": "937863727712",
        "balance": 1999100
      },
      "created_at": "2025-07-07T08:07:53Z",
      "updated_at": "2025-07-07T08:07:53Z"
    }
  }
}

Parameter	Type	Description
card_program_id	string	The id of the card program containing the card.
cardholder.id	string	The id of the cardholder owning the card.
cardholder.address	object	Address of the cardholder owning the card.
cardholder.email	string	Email address of the cardholder owning the card.
cardholder.first_name	string	First name of the cardholder owning the card.
cardholder.last_name	string	Last name of the cardholder owning the card.
cardholder.phone	string	Phone number of the cardholder owning the card.
last4	string	Last 4 digits of the card number.
livemode	string	The value is true if the resource exists in live mode or false if the resource exists in test mode.
status	string	Status of the card. See card statuses below for more details.
type	string	"physical" or "virtual"
wallet_account.account_number	string	Account number of the PayMongo Wallet associated with the card.
wallet_account.balance	number	Current balance of the PayMongo Wallet associated with the card.
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.