API

결제수단 등록

작성일 2026.03.11 | 수정일 2026.03.11

POST/cash/v1/payment

새로운 해외 카드를 결제수단으로 등록합니다. Stripe를 통해 카드 유효성을 검증하고 고객(Customer)으로 등록합니다.

Body Params

Name	Type	Required	Description
cardNumber	string	*	카드 번호 (최대 24자). 공백이나 하이픈 없이 숫자만 입력합니다.
cvc	string	*	카드 CVC/CVV 번호 (최대 14자)
expYear	number	*	카드 유효기간 - 연도 (2자리). 현재 연도 이상이어야 합니다. 예: 25
expMonth	number	*	카드 유효기간 - 월 (1~12)
description	string		결제수단 설명. 미입력 시 '[카드브랜드] 끝4자리 월/년' 형식으로 자동 생성됩니다.

Name	Type	Required	Description
paymentId	string	*	생성된 결제수단 고유 ID
description	string	*	결제수단 설명
expDate	string	*	카드 유효기간 (형식: 'YYYY/MM')

Request

{
  "cardNumber": "4242424242424242",
  "cvc": "123",
  "expYear": 26,
  "expMonth": 12,
  "description": "회사 법인카드"
}

Response

{
  "paymentId": "1234567890123456789",
  "description": "회사 법인카드",
  "expDate": "2026/12"
}