💻
Docs
  • Introduction
  • VIRTUAL CARD
    • Page Integration
      • Quick Page Integration
      • Login-free Page Integration
      • About The Sign
      • Explanation of Return Codes
    • API Integration
      • Things Need To Know
      • About The Sign
      • API For Fetching Usable Card Segments
      • API For Retrieve Enumerations Of The States In The United States
      • API For Creating Virtual Card
      • API For Virtual Card Deposit (recharge)
      • API For Obtaining Card Details
      • API For Updating Virtual Card (update cardholder address)
      • API For Card Refund
      • API For Deleting Card
      • API For Querying Order History
      • Successful card opening callback
      • Fail card opening callback (COPY)
      • Risk Control webhook
      • Error Code
  • Physical card
    • Page Integration
      • Page customization
    • API Integration
      • Create Cardholder
      • Modify Cardholder Information
      • Cardholder Document Upload
      • Cardholder Query
      • Bank Card Application
      • Bank Card Application Result Query
      • Bank Card Activation
      • Bank Card Top-up
      • Bank Card Top-up Order Query
      • Bank Card Query
      • Bank Card Transaction Details Query
      • Bank Card Replacement
      • Bank Card Unloss
      • Bank Card Password Retrieval
      • Bank Card Authorized Transaction Details
      • Partner Account Balance Inquiry
      • Partner Top-up Account Information Inquiry
      • Cardholder Audit Result Notification
      • Bank Card Transaction Notification
  • KYC Sharing API
    • Integration Options
    • Signature Description
    • API
      • Submit basic information
      • Upload photo
      • Submit for approval
      • Query Approval Results
      • Approval Results[Webhook]
Powered by GitBook
On this page
  • Description
  • Request URL
  • Request Method
  • Request Parameter
  • Request Example
  • Response Parameter
  • Response Example
  1. VIRTUAL CARD
  2. API Integration

API For Obtaining Card Details

Description

Obtain card details

Request URL

/open/api/card/info

Request Method

POST

Request Parameter

Parameter
Mandatory
Type
Description

cardId

Y

string

Virtual Card ID

Request Example

{
    "cardId": "c_xxxxxxxxxxx"
}

Response Parameter

Parameter
Type
Description

+cardHolder

object

Cardholder Information

â””firstName

string

Cardholder's surname

â””lastName

string

Cardholder Name

â””street

string

Street

â””city

string

City

â””state

string

State

â””country

string

Country

â””zipCode

string

Zipcode

+card

object

Card information

â””userId

string

User ID

â””cardHolderId

string

Cardholder ID

â””cardId

string

Card ID

â””customerId

string

Custom Customer ID

â””cardSeqNo

string

CARD series number

â””deposit

integer

Deposit, 1000 represents $10.00

â””consume

integer

Consumption, 1000 represents $10.00

â””balance

integer

Balance, 1000 represents $10.00

â””cvc

string

Cvc virtual card verification code, also known as cvv in VISA cards

â””number

string

Card number

â””cardBin

string

Card section (top 6 digits of card number)

â””last4

string

Last four digits

â””status

string

INIT: Card opening INIT CREATE CARD: Create Virtual Card INIT CREATE CARD HOLDER: Create Cardholder INIT ACTIVE CARD: Activate Card CREATE CARD FAILED REFUND: Card creation failed, full refund ACTIVE: Activated FREEZE: Frozen CANCELLING: Deleting card CANCELED: Deleted DELETED: Permanently delete EXPIRED: Expired

â””statusText

string

Card Status Text

â””expYear

integer

Card expiration year

â””expMonth

integer

Card Expiration Month

â””gmtCreate

string

Card opening time

tags

array

Card Label List

â””

string

Card Label

Response Example

{
    "success": true,
    "error":false,
    "msg": "success",
    "code": 0,
    "model": {
        "cardHolder": {
            "firstName": "Milton",
            "lastName": "Schmitt",
            "address": {
                "street": "1010 Pine St LOT 12-E",
                "city": "Vienna",
                "state": "GA",
                "country": "US",
                "zipCode": "31092"
            }
        },
        "card": {
            "userId": "u_xxxxxxxx",
             "cutomerId": "user_id_123",
            "cardHolderId": "ch_xxxxxxxxxx",
            "holderName": "Milton Schmitt",
            "cardId": "c_xxxxxxxxxx",
            "cardSeqNo": "CXXXXXXXX",
            "deposit": 1000,
            "consume": 0,
            "balance": 1000,
            "cvc": "123",
            "number": "40000099900XXXXX",
            "cardBin": "400000",
            "last4": "9360",
            "status": "ACTIVE",
            "statusText": "已激活",
            "expYear": 2025,
            "expMonth": 2,
            "gmtCreate": 1646648710000
        },
        "tags": [
            "test"
        ]
    },
    "traceId": 1646651433202
}

Last updated 1 year ago