API

잔액 충전 (카드 결제)

작성일 2026.03.11 | 수정일 2026.03.11

POST/cash/v1/balance

등록된 결제수단(해외 카드)을 사용하여 잔액을 충전합니다.
충전이 성공하면 SMS/이메일 알림이 발송되고, 거래명세서가 자동 발급됩니다. 최소 10,000원에서 최대 10,000,000원까지 충전이 가능합니다.

Body Params

Name	Type	Required	Description
amount	number	*	충전할 금액 (원). 최소 10,000원 ~ 최대 10,000,000원.
paymentId	string	*	결제에 사용할 결제수단 ID. 결제수단 목록 조회 API로 확인할 수 있습니다.

Response

Name	Type	Required	Description
historyId	string	*	충전 내역 고유 ID. 거래명세서 발급이나 세금계산서 발행 시 사용됩니다.
accountId	string	*	계정 고유 ID
oldBalance	number	*	충전 전 잔액
newBalance	number	*	충전 후 잔액
oldPoint	number	*	충전 전 포인트
newPoint	number	*	충전 후 포인트
balanceAmount	number	*	잔액 변동 금액
pointAmount	number	*	포인트 변동 금액 (추가 포인트 적립이 있을 경우)
type	string	*	변동 타입. 항상 'RECHARGE'.
rechargeMethod	string	*	충전 수단. 항상 'STRIPE'.
memo	string	*	충전 메모 (예: '[VISA] 1234 으로 결제됨')
dateCreated	string	*	충전 일시 (ISO 8601)

Structure

Request

{
  "amount": 50000,
  "paymentId": "1234567890123456789"
}

Response

{
  "historyId": "64a1b2c3d4e5f6789abcdef0",
  "accountId": "12345678901234",
  "oldBalance": 100000,
  "newBalance": 150000,
  "oldPoint": 3000,
  "newPoint": 3000,
  "balanceAmount": 50000,
  "pointAmount": 0,
  "type": "RECHARGE",
  "rechargeMethod": "STRIPE",
  "memo": "[VISA] 1234 12/25 으로 결제됨",
  "dateCreated": "2024-07-01T12:00:00.000Z"
}