지급대행 잔액조회 문의드립니다.
api 가이드에 나온내용이 이해가 잘 안돼서 문의드립니다.
1. 전반적으로
1. 잔액이 2가지로 나오고 있어서 availableAmount, pendingAmount를 상세히 알고 싶습니다.
2. pendingAmount의 금액이 어떻게 나오는지 상점관리자에서 못찾겠습니다.
3. 지급대행 잔액의 원부는 어디서 볼 수 있을까요? 잔액으로 등록된 금액의 원부를 보고 싶은데 어디서 볼지 모르겠습니다.
4. 잔액 입금 금액은 토스 수수료가 계산되고 입금되나요?
mid : themancnsw
상점관리자 - [잔액관리]
지급가능 잔액(현재)
212,268 원
지급대기 금액
0 원
지급가능 잔액(예정)
212,268
잔액조회 api 가이드
pendingAmount object
셀러에게 지급할 수 없는 잔액 정보입니다.
발생한 매출이 정산 주기 2일 전에 pendingAmount 금액으로 업데이트됩니다.
토스페이먼츠 정산 주기가 지난 금액은 availableAmount로 전환됩니다.
availableAmount object
셀러에게 지급할 수 있는 잔액 정보입니다.
잔액조회 응답 https://api.tosspayments.com/v2/balances
{
"version": "2022-11-16",
"traceId": "f8892834e51c72398d90e31150cd4aca",
"entityBody": {
//지급할 수 있는 잔액정보
"availableAmount": {
"currency": "KRW",
"value": 212268.000000
},
//지급할 수 없는 잔액정보
"pendingAmount": {
"currency": "KRW",
"value": 473384.000000
}
},
"entityType": "balance",
"error": null
}

12 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
결제 이후 정산이 발생하면 가상의 돈통에 하위 셀러에게 지급가능한 금액이 누적되어 적재됩니다. 이때 바로 셀러에게 지급가능한 금액을 availableAmount 라고하고 정산은 받았지만 지급에 사용할 수 없는 금액이 pendingAmount 이에요
pendingAmount 를 지급대기 금액으로 보시면 됩니다
지급대행의 원부는 정산API 를 연동하셔야해요
https://docs.tosspayments.com/reference#%EC%A0%95%EC%82%B0-%EC%A1%B0%ED%9A%8C
코어 API | 토스페이먼츠 개발자센터
토스페이먼츠 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
잔액입금금액이라는 것은 없는데요, 지급대행의 입금을 의미한거면 수수료와 무관합니다.
PG수수료는 별도 계산되어 정산이 되고
받은 정산대금으로 지급대행을 했다면 지급대행으로 요청한 금액이 그대로 입금됩니다(셀러에게)
네 이했습니다.
그런데 결제 후 -> 정산주기 -> 가상돈통입금 이 상태는 알겠는데
'정산은 받았지만 지급에 사용할 수 없는 금액' 이 부분이 이해가 잘 안됩니다.
정책적인 부분이라 자세한것은 저도 잘 모르지만..
"가정산" 금액 정도로 이해하시면 될거같구요
리스크관리 차원에서 하는 업무입니다
그럼 pendingAmount이부분은 무시해도 되는걸까요?
지금 바로 지급이 나가야하는 금액이 얼마인지 파악하려면 무시해도 되는데요
가까운 미래시점에 얼마정도의 지금가능한 금액이 확보되는지를 확인하려면 활용해야죠
아 그럼 pendingAmount금액은 아직 지금전상태 인 가정산이라는거네요?
시간이 지나면 가정산에서 정산대상이 되는거고 그때 availableAmount 여기로 업데이트 된다는거고요?
그럼 말씀해주신대로라면
availableAmount + pendingAmount = 총 정산금액
이게 나오겠네요?
네 맞습니다
결제가 계속 발생할거고 정산금도 계속 쌓인다고 생각해서 로직 만드셔야해요
가정산은 제가 임의로 부른용어구요
문서를 보시면 이해가 빠르실거에요
https://docs.tosspayments.com/reference#%EA%B0%9D%EC%B2%B4-%EC%83%81%EC%84%B8-5
코어 API | 토스페이먼츠 개발자센터
토스페이먼츠 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
지급대행하기 | 토스페이먼츠 개발자센터
지급대행은 오픈마켓을 운영하는 사업자 대신 토스페이먼츠가 셀러(입점 판매자)에게 대금 지급을 대행 해주는 서비스예요.