Skip to main content
카드는 카드 소지자에게 할당할 수 있으며, 지출 통제를 위해 지출 한도를 설정할 수 있습니다. Cards API를 사용하여 카드를 발급하고, 계정 또는 사용자의 카드를 조회하고, 카드 번호와 CVC 같은 활성 카드 세부 정보를 조회하고, 카드로 이루어진 거래를 조회할 수 있습니다.

엔드포인트

속성

string
필수
카드 ID이며, 접두사는 icrd_입니다.
object | null
필수
청구지 주소입니다.

속성

string | null
필수
청구지 도시입니다.
string | null
필수
청구지 국가 코드입니다.
string | null
필수
도로명 주소 1행입니다.
string | null
필수
도로명 주소 2행입니다.
string | null
필수
청구지 우편번호입니다.
string | null
필수
청구지 지역 또는 주입니다.
string | null
필수
카드가 취소된 시점입니다.
string | null
필수
카드가 생성된 시점입니다.
string[] | null
필수
카드가 추가된 디지털 지갑입니다. List Cards, Update Card 및 웹훅 페이로드는 null을 반환하며, 지갑 정보를 가져올 수 없는 경우 Retrieve Card도 마찬가지입니다.사용 가능한 옵션: apple_pay, google_pay
string | null
필수
카드 만료 월입니다.
string | null
필수
카드 만료 연도입니다.
boolean
필수
발급사가 카드를 발급하면 true입니다. 카드 소지자의 온보딩이나 검토를 기다리는 초대 카드 또는 발급사가 거절한 카드는 false이며, 발급될 때까지 카드 번호가 없습니다.
string | null
필수
카드 번호의 마지막 네 자리입니다. 대기 중인 초대 카드는 null입니다.
object | null
필수
지출 한도 설정입니다.

속성

number
필수
한도 금액(달러)입니다.
string
필수
한도 금액이 적용되는 기간입니다. per_transaction은 개별 승인 건마다 한도를 적용하며, transaction_limit으로 설정한 한도가 이 값으로 보고됩니다.사용 가능한 옵션: daily, weekly, monthly, one_time, per_transaction
string | null
필수
카드 표시 이름입니다.
string
필수
object | null
민감한 카드 세부 정보입니다. 활성 카드에 대한 GET /cards/:id에서만 제공되며, 카드가 비활성 상태이거나 세부 정보를 가져올 수 없는 경우 null입니다.

속성

string
필수
전체 카드 번호입니다.
string
필수
카드 보안 코드입니다.
string | null
필수
카드에 인쇄된 카드 소지자 이름입니다.
string | null
필수
카드 PIN입니다. 카드가 할당된 사용자로 인증된 요청에서만 반환되며, 계정 API 키를 포함한 다른 모든 호출자에게는 null입니다.
integer | null
필수
최근 30일간의 총 지출액(센트)입니다.
string | null
필수
카드 상태입니다. denied는 발급사가 카드 소지자를 거절했다는 의미로, 카드는 발급되지 않습니다.사용 가능한 옵션: active, frozen, canceled, invited, denied
string | null
필수
카드 유형입니다.사용 가능한 옵션: virtual, physical
string | null
필수
할당된 경우 카드 소지자 사용자 ID이며, 접두사는 user_입니다.
Card