Program Details - Cards API

The Programdetails API provides detailed information about a specific card program using its Program ID. This API helps retrieve various details such as card type, fees, limits, supported operations, and KYC requirements.

Request

Path Params

programid

string <uuid>

required

Example:

76ddcaab-55c4-46e0-8d80-e7d097bfc1b3

Header Params

Content-Type

string

optional

Default:

application/json

Authorization

string

optional

Default:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Responses

🟢200OK

text/plain

Success

Body

programId

string <uuid>

optional

bin

integer <int32> | null

optional

name

string | null

optional

currency

string | null

optional

type

string | null

optional

consumptionMethod

string | null

optional

cardFee

number <double> | null

optional

cardOpeningFee

number <double> | null

optional

firstRechargeAmount

number <double> | null

optional

cancellationFeeMin

number <double> | null

optional

cancellationFeeMax

number <double> | null

optional

freightFee

number <double> | null

optional

rechargeFeeMin

number <double> | null

optional

rechargeFeeMax

number <double> | null

optional

transactionFee

number <double> | null

optional

atmWithdrawalFee

number <double> | null

optional

maintenanceFee

number <double> | null

optional

atmBalanceInquiryFee

number <double> | null

optional

monthlyRechargeLimit

number <double> | null

optional

dailyRechargeLimit

number <double> | null

optional

singleRechargeLimit

number <double> | null

optional

perPaymentLimit

number <double> | null

optional

atmDailyWithdrawalLimit

number <double> | null

optional

spendingLimit

number <double> | null

optional

reviewTime

string | null

optional

cardState

string | null

optional

note

string | null

optional

remarks

string | null

optional

supportedOperationTypes

string | null

optional

cardImage

string | null

optional

supportedPlatforms

string | null

optional

kycRequiredWhileApplyCard

boolean | null

optional

kycRequirements

string | null

optional

needPhotoForActiveCard

boolean | null

optional

needPhotoForOperateCard

boolean | null

optional

Example

{
    "programId": "9ed506e4-9ea7-b1ec-aa90-3a16adaabf4d",
    "bin": 76532,
    "name": "MeshCard",
    "currency": "USD",
    "type": "Virtual",
    "consumptionMethod": "Debit",
    "cardFee": 15,
    "cardOpeningFee": 10,
    "firstRechargeAmount": 10,
    "cancellationFeeMin": 0,
    "cancellationFeeMax": 0,
    "freightFee": 0,
    "rechargeFeeMin": 10,
    "rechargeFeeMax": 10000,
    "transactionFee": 0,
    "atmWithdrawalFee": 0,
    "maintenanceFee": 0,
    "atmBalanceInquiryFee": 20,
    "monthlyRechargeLimit": 0,
    "dailyRechargeLimit": 0,
    "singleRechargeLimit": 0,
    "perPaymentLimit": 0,
    "atmDailyWithdrawalLimit": 0,
    "spendingLimit": 0,
    "reviewTime": "Within 24 hours",
    "cardState": "Active",
    "note": null,
    "remarks": null,
    "supportedOperationTypes": "freeze, unfreeze,cancel",
    "cardImage": "ImageUrl",
    "supportedPlatforms": "",
    "kycRequiredWhileApplyCard": true,
    "kycRequirements": "nokyc",
    "needPhotoForActiveCard": false,
    "needPhotoForOperateCard": false
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

🔴501501