API

자동 충전 결제수단 우선순위 설정

작성일 2026.03.11 | 수정일 2026.03.11

PUT/cash/v1/payment

자동 충전에 사용할 결제수단의 우선순위와 자동 충전 기준 금액, 목표 금액을 설정합니다. 해외 카드(Stripe)와 국내 카드(Billing Key) 모두 지원합니다.

Body Params

Name	Type	Required	Description
paymentIds	string[]	*	자동 충전에 사용할 결제수단 ID 목록. 배열의 순서가 우선순위입니다 (앞쪽이 높은 우선순위). 중복 불가. 국내카드 ID는 'PY01PM'으로 시작합니다.
minimumCash	number	*	자동 충전 기준 금액 (원). 보유 잔액이 이 금액 이하로 떨어지면 자동 충전됩니다. 최소 200원 ~ 최대 10,000,000원.
rechargeTo	number	*	자동 충전 목표 금액 (원). 자동 충전 시 이 금액까지 충전됩니다. 최소 10,000원 ~ 최대 10,000,000원.

Name	Type	Required	Description
paymentIds	string[]	*	설정된 결제수단 ID 목록 (우선순위 순서)
minimumCash	number	*	설정된 자동 충전 기준 금액
rechargeTo	number	*	설정된 자동 충전 목표 금액

Request

{
  "paymentIds": [
    "1234567890123456789",
    "PY01PM9876543210"
  ],
  "minimumCash": 10000,
  "rechargeTo": 50000
}

Response

{
  "paymentIds": [
    "1234567890123456789",
    "PY01PM9876543210"
  ],
  "minimumCash": 10000,
  "rechargeTo": 50000
}