API

충전 내역 조회

작성일 2026.03.11 | 수정일 2026.03.11

GET/cash/v1/recharge-history

Query

startKey— 이전 응답의 nextKey를 전달하여 다음 페이지 조회

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

dateCreated— 생성일 필터. 지원 연산자 gte, lte, gt, lt

type— 변동 타입 필터. 아래 변동 타입표 참조.

groupId— 메시지 그룹 ID 필터

rechargeMethod— 충전 수단 필터. 아래 충전 수단표 참조.

serviceMethod— 서비스 수단 필터. 현재 MT(메시지 발송)만 지원됩니다.

balanceRecharge — 잔액 충전 내역 포함 여부 (기본값: true)

balanceDeduct— 잔액 차감 내역 포함 여부 (기본값: true)

pointRecharge— 포인트 충전 내역 포함 여부 (기본값: true)

pointDeduct— 포인트 차감 내역 포함 여부 (기본값: true)

masterAccountId— 마스터 계정 ID

targetAccountId— 조회 대상 하위 계정 ID

chat

지원 연사자를 사용하실 경우 Query Operator 가이드를 참조하세요

충전(결제)으로 인해 발생한 내역만을 조회하는 API입니다.
잔액 변동내역 API와 데이터 구조는 동일하지만, 충전 거래만 필터링하여 제공합니다.

Query

변동 타입

Name	Description
RECHARGE	결제에 의한 충전
REWARD	관리자가 시스템 문제에 대한 보상으로 지급
MANUAL	관리자가 임의로 지급
SYSTEM	시스템에서 자동으로 지급
TRANSFER	사용자 간의 잔액 이체
APP-PROFIT	앱 수익금
SERVICE-CHARGE	서비스 사용에 따른 차감 (메시지 발송 등)
WITHDRAW	출금

충전 수단

Name	Description
STRIPE	Stripe 해외 카드 결제
CARD	국내 카드 결제
ACCOUNT-TRANSFER	계좌이체
EXCLUSIVE-ACCOUNT-TRANSFER	전용 계좌 이체
REALTIME-ACCOUNT-TRANSFER	실시간 계좌이체
VIRTUAL-ACCOUNT-TRANSFER	가상계좌
PHONE	핸드폰 소액 결제
GIFTCARD	상품권

Response

Name	Type	Required	Description
startKey	string\|null	*	현재 조회의 시작 키
nextKey	string\|null	*	다음 페이지 조회를 위한 키. null이면 더 이상 데이터가 없습니다.
limit	number	*	요청한 조회 건수
historyList	array	*	충전 내역 목록
historyId	string	*	충전 내역 고유 ID
accountId	string	*	계정 고유 ID
oldBalance	number	*	변동 전 잔액
newBalance	number	*	변동 후 잔액
oldPoint	number	*	변동 전 포인트
newPoint	number	*	변동 후 포인트
balanceAmount	number	*	잔액 변동 금액. 양수면 충전, 음수면 차감.
pointAmount	number	*	포인트 변동 금액. 양수면 충전, 음수면 차감.
paymentAmount	number	*	실제 결제 금액
type	string	*	변동 타입 (RECHARGE, REWARD, MANUAL, SYSTEM, TRANSFER, APP-PROFIT, SERVICE-CHARGE, WITHDRAW)
groupId	string\|null	*	연관된 메시지 그룹 ID
memo	string\|null	*	변동 사유 메모
rechargeMethod	string\|null		충전 수단 (type이 RECHARGE인 경우에만 존재)
serviceMethod	string\|null		서비스 수단 (type이 SERVICE-CHARGE인 경우에만 존재). 현재 MT(메시지 발송)만 지원.
chargedMethod	string\|null		충전 방식 (AUTO 또는 MANUAL)
paymentMethod	string\|null		결제 시 사용된 카드 정보
masterAccountId	string\|null		마스터 계정 ID (하위 계정 거래 시)
dateCreated	string	*	변동 일시 (ISO 8601)

Structure

Response

{
  "startKey": null,
  "nextKey": "64a1b2c3d4e5f6789abcdef0",
  "limit": 20,
  "historyList": [
    {
      "historyId": "64a1b2c3d4e5f6789abcdef1",
      "accountId": "12345678901234",
      "oldBalance": 100000,
      "newBalance": 150000,
      "oldPoint": 3000,
      "newPoint": 3000,
      "balanceAmount": 50000,
      "pointAmount": 0,
      "paymentAmount": 50000,
      "type": "RECHARGE",
      "groupId": null,
      "memo": "[VISA] 1234 12/25 으로 결제됨",
      "rechargeMethod": "STRIPE",
      "serviceMethod": null,
      "chargedMethod": "MANUAL",
      "paymentMethod": "VISA **** 1234",
      "masterAccountId": null,
      "dateCreated": "2024-07-01T12:00:00.000Z"
    }
  ]
}