API For Obtaining Card Details

Brief description

Get card details

Request URL

/open/api/card/info

Request method

POST

Parameters

Parameter name	Required	Type	Description
cardId	Yes	string	Card ID
currency	No	string	Currency: USD, EUR, CHF

Request example

{
    cardId: c_xxxxxxxxxxx
}

Return parameter description

Parameter name	Type	Description
success	boolean	Success flag
error	boolean	Failure flag
msg	string	Return processing message
code	integer	Return code
+model	object	Return data object data
+cardHolder	object
└firstName	string	Cardholder last name
└lastName	string	Cardholder name
└street	string	Street
└city	string	City
└state	string	State
└country	string	Country
└zipCode	string	Zip code
+contacts	object
+depositBank	object
+card	object	Card information
└userId	string	User id
└customerId	string	Custom customer id
└cardHolderId	string	Cardholder id
└holderName	string	Cardholder name
└cardId	string	Virtual card id
└link	string	Card details information link(redirect to issue bank link, 24 hours)
└cardSeqNo	string	Virtual card serial number
└deposit	integer	Deposit accumulation
└consume	integer	Consumption accumulation
└balance	integer	Card balance (equal to deposit accumulation - consumption accumulation)
└cvc	string
└number	string	Card number
└cardBin	string	Card segment (first 6 digits of the card number)
└last4	string	Last four digits
└status	string	INIT: Card opening ACTIVE: Activated FREEZE: Frozen EXPIRED: Expired
└expYear	integer	Card expiration year
└expMonth	integer	Card expiration month
└gmtCreate	string	Card opening time
+tags	array	Card tag list

Contacts detailed parameter description

Parameter name	Type	Description
id	String	Contact ID (e.g., EA-00012345)
name	String	Contact name
account	String	Contact account (anonymized)
fullAccount	integer	Contact's full account number
bank	String	Contact's bank
country	String	Country where the contact's bank is located
lastPaymentDate	String	Last payment date (timestamp)

DepositBank detailed parameter description

Parameter name	Type	Description
account	String	Bank account number
bank	String	Name of the bank
BIC	String	Bank Identification Code (BIC)
payee	String	Name of the bank
country	String	Country of the bank
postalCode	String	Postal code of the bank
street	String	Street of the bank
city	String	City of the bank

Return example

{
    "code": "0",
    "msg": "success",
    "model": {
        "cardHolder": {
            "firstName": "Alice",
            "lastName": "Jack",
            "street": "Zhangyan Village 40",
            "city": null,
            "state": null,
            "country": "DE",
            "zipCode": "062150",
            "contacts": {
                "CHF": [
                    {
                        "id": "EC-0000001",
                        "name": "Jake",
                        "account": "•••• 0001",
                        "fullAccount": "...",
                        "bank": "PostFinance",
                        "country": "CH",
                        "lastPaymentDate": 1700093537000
                    }
                ],
                "EUR": [
                    {
                        "id": "EC-0000002",
                        "name": "Marc",
                        "account": "•••• 1234",
                        "fullAccount": "...",
                        "bank": "PostFinance",
                        "country": "ES",
                        "lastPaymentDate": 1700093537000
                    }
                ],
                "USD": [

                ]
            },
            "depositBank": {
                "CHF": {
                    "account": "CH08830510s00000465251",
                    "bank": "SR Saphirstein AG",
                    "BIC": "SAHHCHZ2",
                    "payee": "Yxxx Wxxxx",
                    "country": "CHN",
                    "postalCode": "062150",
                    "street": "Zhangyan Village 40",
                    "city": "Xian County"
                },
                "EUR": {
                    "account": "CH0883sd0510000000000000",
                    "bank": "SR Saphirstein AG",
                    "BIC": "SAHHCHZ2",
                    "payee": "Yxxxx Wxxxxxxx",
                    "country": "CHN",
                    "postalCode": "062150",
                    "street": "Zhangyan Village 40",
                    "city": "Xian County"
                },
                "GBP": {
                    "account": null,
                    "bank": null,
                    "BIC": null,
                    "payee": null,
                    "country": null,
                    "postalCode": null,
                    "street": null,
                    "city": null
                },
                "USD": {
                    "account": null,
                    "bank": null,
                    "BIC": null,
                    "payee": null,
                    "country": null,
                    "postalCode": null,
                    "street": null,
                    "city": null
                }
            }
        },
        "card": {
            "userId": "100417494499129131050",
            "customerId": "4652251",
            "cardHolderId": "503317494499129131050",
            "holderName": "Alice JACK",
            "cardId": "42323_USD24",
            "link": "https://***",
            "cardSeqNo": "42323_USD24",
            "deposit": null,
            "consume": null,
            "balance": 285,
            "cvc": "•••",
            "number": "•••• 7907",
            "cardBin": "•••• 7",
            "last4": "7807",
            "status": "ACTIVE",
            "expYear": null,
            "expMonth": null,
            "gmtCreate": "1749464251000",
            "vendorCardBinId": null,
            "monthlyFeeCard": false,
            "pendingMonthlyFee": null,
            "paidMonthlyFee": null
        },
        "tags": null
    },
    "traceId": "6847e844c76bff2a83ba29b826ea6ff1",
    "success": true,
    "error": false
}

Notes

For more error codes, please see the error code description on the home page