❤️
Padiwise
  • Introductions
  • Getting Started
    • Quickstart
    • Authentication
  • Compliance
  • Errors
  • Pricing
  • Account Information
  • Value Added Services
    • Bills Overview
    • Data Bundle
    • Cable TV
    • Airtime Topup
    • Validation
    • Smm Services
    • SMS Gateway API
  • COLLECTIONS
    • Collection Overview
    • Create Virtual Account
    • Webhook
  • DISBURSEMENT
    • Disbursement Overview
    • Get All Bank List
    • Create Transfer Recipients
    • Single Transfer
  • VIRTUAL CARDS
    • Cards Overview
    • Exchange Rate
    • Create Virtual Card
    • Get Cards
    • Get Card Details
    • Get Card Transactions
    • Fund Card
    • Withdraw Card
  • Help & Support
    • Changelog
Powered by GitBook
On this page
  1. VIRTUAL CARDS

Get Card Details

Sensitive fields like card number and CVV are returned securely for one-time use. Never cache or store these details on the client.

PreviousGet CardsNextGet Card Transactions

Last updated 14 days ago

Returns detailed information for a specific virtual card using its unique cardId. Data includes the full masked card number, CVV, expiry, current balance, currency, and card status (e.g., active, blocked). This is useful for viewing card details before a transaction or for internal monitoring.

Before you begin!

Sensitive fields like card number and CVV are returned securely for one-time use. Never cache or store these details on the client.

POST {{ BASE }}/get-card/{cardid}

--header 'Accept: application/json'
--header 'Authorization: Bearer {{  access_token }}'

Below are the request body parameters

Request Body

Name
Type
Description

cardid

String

The unique ID of the virtual card (from Padiwise)

Response Body

{
  "success": true,
  "message": "Card details successfully fetched.",
  "status_code": 200,
    "data": {
      "type": "virtual",
      "brand": "visa",
      "number": "1234 56•• •••• 7890",
      "expiryMonth": "12",
      "expiryYear": "2028",
      "cvv": "•••",
      "status": "active",
      "balance": 42.55,
      "billingAddress": {
        "line1": "123 Main Street",
        "city": "Lagos",
        "state": "LA",
        "postalCode": "100001",
        "country": "NG"
      }
  }
}

🎉