API

결제수단 목록 조회

작성일 2026.03.11 | 수정일 2026.03.11

GET/cash/v1/payment

Query

offset— 조회 시작 위치 (기본값: 0)

limit— 조회 건수 (기본값: 20, 최소: 1)

등록된 결제수단 목록을 조회합니다.
카드 번호 전체는 반환되지 않으며, 카드 설명(마스킹된 카드번호 등), 유효기간, 자동 충전 우선순위 등의 정보가 포함됩니다.

Response

Name	Type	Required	Description
payments	array	*	결제수단 목록
_id	string	*	결제수단 고유 ID (paymentId)
description	string	*	결제수단 설명 (예: '[VISA] 1234 12/25')
autoRecharge	number	*	자동 충전 우선순위. 0이면 자동 충전 미사용, 1 이상이면 숫자가 낮을수록 우선순위가 높습니다.
expDate	string	*	카드 유효기간 (형식: 'YYYY/MM')
dateCreated	string	*	등록 일시 (ISO 8601)
dateUpdated	string	*	최종 수정 일시 (ISO 8601)

Structure

Response

{
  "payments": [
    {
      "_id": "1234567890123456789",
      "description": "[VISA] 1234 12/25",
      "autoRecharge": 1,
      "expDate": "2025/12",
      "dateCreated": "2024-01-10T08:00:00.000Z",
      "dateUpdated": "2024-06-15T10:00:00.000Z"
    },
    {
      "_id": "9876543210987654321",
      "description": "[MASTERCARD] 5678 06/26",
      "autoRecharge": 0,
      "expDate": "2026/06",
      "dateCreated": "2024-03-20T14:00:00.000Z",
      "dateUpdated": "2024-03-20T14:00:00.000Z"
    }
  ]
}