---
title: "Create Budget Card"
method: POST
path: "/open-api/v3/budget-card"
tags: ["Card"]
---

# Create Budget Card

`POST /open-api/v3/budget-card`

## Headers

- `Idempotency-Key` string, required

## Request body

- CreateBudgetCardReqDTO — Create Budget Card
  - `accountId` string, uuid, required — The UUID of the Account.
  - `binId` string, required — The Id of the bin.
  - `cardMode` 'PHYSICAL_CARD' | 'VIRTUAL_CARD', required — Card mode. Example: VIRTUAL_CARD
  - `useType` string — Custom use type. Example: Online advertising
  - `label` string — Custom card label or tag
  - `cardholderId` string, required — cardholder id
  - `physicalCardDesignId` string — Physical Card Design ID.
  - `ssn` string — If the card type is BB Card and the country is the United States, SSN is a mandatory parameter unless an SSN was already submitted during KYC or cardholder creation.
  - `referenceId` string, required — A unique identifier assigned by you for each card. This value must be unique per card request and will be used later to query or track the corresponding card.
  - `budgetId` string, uuid, required — The UUID of the Budget.

## Response `200`

OK

- CardResponse — card resources
  - `code` string — Return code
  - `message` string — Error message
  - `data` CardResource — Returned data
    - `id` string — Unique identifier of the card
    - `accountId` string — Account ID
    - `status` string — Card status. Values: INACTIVE,CONTROL,ACTIVE,PENDING,FROZEN
    - `currency` string — Currency code
    - `bin` string — Card BIN (Bank Identification Number)
    - `userName` string — User name
    - `createTime` string — Card creation time
    - `cardLastFour` string — Last four digits of the card number
    - `billingAddress` AddressResource — Card address
      - `addressLine1` string — First line of the address
      - `addressLine2` string — Second line of the address
      - `city` string — City
      - `country` string — Country
      - `postalCode` string — Postal code
      - `state` string — State
    - `label` string — Card label
    - `balanceId` string — Balance ID
    - `budgetId` string — Budget ID (Only for Budget Card)
    - `cardholderId` string — Cardholder ID
    - `referenceId` string — A unique identifier assigned by you for each card. This value must be unique per card request and will be used later to query or track the corresponding card.
    - `cardMode` 'PHYSICAL_CARD' | 'VIRTUAL_CARD' — Card mode. Example: VIRTUAL_CARD
    - `transactionLimits` TransactionLimitsResource[] — Limit information
      - `type` string — Type of card spending limit. The quota will reset at 00:00 (GMT+8). Values: DAY,WEEK,MONTH,QUARTER,YEAR,LIFETIME,TRANSACTION,NA
      - `value` string — Card spending limit amount
      - `currency` string — Currency code
    - `cardStatusChangeRecordList` CardStatusChangeRecordResource[] — card status change record list
      - `userId` string — user id
      - `accountId` string — account id
      - `cardId` string — card id
      - `operationTime` string — operation time, millisecond timestamp
      - `beforeStatus` string — before status
      - `afterStatus` string — after status
      - `reasonCode` string — reason code:7001:Created via merchant portal, 7002:Created via API, 1001:Closed via Open API, 1002:Closed via merchant portal, 1003:Closed due to risk policy violation, 1004:Closed by administrator, 1005:Closed due to BIN decommission, 1006:Closed due to account termination, 1007:Automatic deletion upon card expiration, 2001:Activated via Open API, 2002:Activated via merchant portal, 3001:Suspended via Open API, 3002:Suspended via merchant portal, 5001:Restricted by administrator, 6001:Unrestricted by administrator,
      - `reasonMessage` string — reason message
      - `requestUrl` string — request url

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/interlace/apis/core-resource.md) · [All operations](https://skmtc.net/interlace/apis/core-resource/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interlace/core-resource/versions/29c08a4da357/schema)