Skip to main content
POST
/
api
/
v1
/
cards
curl -X POST https://api.uncash.io/api/v1/cards \
  -H "Authorization: Bearer uc_your_api_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "bin_id": "6705952d3ec949063b9241a0",
    "name": "My Business Card",
    "planId": 1
  }'

{
  "success": true,
  "data": {
    "id": "123",
    "created_at": "2025-02-17T18:24:17.653Z",
    "updated_at": "2025-02-17T18:24:17.653Z",
    "currency": "USD",
    "EXP": "**/**",
    "masked_PAN": "4559 88** **** ****",
    "name": "My Business Card",
    "category": "Universal",
    "currency_short_name": "USD",
    "balance": 0,
    "deposit": 0,
    "spent": 0,
    "status": "Processing",
    "bin_id": "67ade1eef9f79c20b4e78899",
    "3ds": false,
    "address": "2381 Zanker Rd Ste 110, San Jose, CA, 95131, US"
  },
  "message": "Card created successfully",
  "timestamp": "2025-09-26T10:30:00.000Z"
}

​
Body Parameters

​
bin_id
string
required
BIN identifier for the card (get from /api/v1/bins)
​
name
string
required
Card nickname (1-255 characters)
​
planId
integer
required
Card plan ID (get from /api/v1/card-plans)
​
coupon_id
string
Optional coupon ID for discounts

​
Response

​
success
boolean
Indicates if the card was created successfully
​
data
object
​
message
string
Success message
curl -X POST https://api.uncash.io/api/v1/cards \
  -H "Authorization: Bearer uc_your_api_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "bin_id": "6705952d3ec949063b9241a0",
    "name": "My Business Card",
    "planId": 1
  }'

{
  "success": true,
  "data": {
    "id": "123",
    "created_at": "2025-02-17T18:24:17.653Z",
    "updated_at": "2025-02-17T18:24:17.653Z",
    "currency": "USD",
    "EXP": "**/**",
    "masked_PAN": "4559 88** **** ****",
    "name": "My Business Card",
    "category": "Universal",
    "currency_short_name": "USD",
    "balance": 0,
    "deposit": 0,
    "spent": 0,
    "status": "Processing",
    "bin_id": "67ade1eef9f79c20b4e78899",
    "3ds": false,
    "address": "2381 Zanker Rd Ste 110, San Jose, CA, 95131, US"
  },
  "message": "Card created successfully",
  "timestamp": "2025-09-26T10:30:00.000Z"
}
Wallet Deduction: The card creation fee is automatically deducted from your wallet balance. Ensure you have sufficient funds before creating a card.

​
Error Responses

{
  "success": false,
  "message": "Insufficient balance. Required: 5.00",
  "timestamp": "2025-08-03T10:00:00.000Z"
}