가

지급대행 API에 대한 문의

안녕하세요. 현재 자사에서는 v1 버전의 정산 지급대행 API를 사용하고 있으며, 아래와 같은 문의사항이 있습니다.

MID :

cookat

cookat

v2 API 사용 가능 여부

v2 버전의 API를 사용할 수 있는지 확인 부탁드립니다.
만약 가능하다면, v1과 v2 중 원하는 버전을 선택하여 혼용하여 사용하는 것도 가능한지 궁금합니다.

2.잔액 조회 응답 필드 관련

v1 버전의 "지급 가능한 잔액 조회 API" 응답 중 balance 값이, v2 버전의 잔액 조회 응답의 availableAmount 값과 동일한 개념인지 확인 부탁드립니다.

감사합니다.

토

토스페이먼츠 BOT•7/31/25, 1:51 AM

⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다

오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.

- 주문번호(orderId) : - 문의 내용 :

(img를 함께 첨부해주시면 도움이됩니다)

* 계약관련 내용은 1544-7772로 문의주세요. * 주말/공휴일에는 답변이 늦을 수 있어요.

Kimoon Lee•7/31/25, 2:47 AM

v1, v2 중에 골라서 사용하셔야 합니다. 정상 응답이 오는것 처럼 보이더라도 내부데이터에 이상이 있을 가능성이 있습니다.

Kimoon Lee•7/31/25, 2:47 AM

네 동일한 값입니다.

가

가펠OP•7/31/25, 3:24 AM

@Kimoon Lee 님 답변 감사합니다. 추가로 다음 사항에 대해 문의드립니다.

토스페이먼츠 상점관리 사이트에서 수기 정산 요청 시에는 요청일과 지급일이 같아도 지급 요청이 가능한 것으로 알고 있습니다.
그러나 API(v1)를 이용하여 정산 지급대행 요청 시, 요청일과 지급일이 같은 경우 아래와 같은 에러가 반환됩니다.

이에 대해 아래 사항을 확인 부탁드립니다.

API를 이용한 지급 요청 시에는 당일 지급 요청이 불가능한 것인지 궁금합니다.
만약 불가능하다면, 불가능한 사유(정산 로직/정책 차이 등) 를 확인 부탁드립니다.

감사합니다.

김

김차장•7/31/25, 3:28 AM

v1 은 불가합니다. 당일 지급 기능을 갖고있지 않아요.
v1제품에 기능이 없어요

가

가펠OP•7/31/25, 4:34 AM

@김차장 님 답변 감사합니다.
그렇다면 v2 API를 이용 시에는 당일 지급이 가능한가요?

Kimoon Lee•7/31/25, 4:36 AM

네 v2 에서는 제공됩니다.

토

토스페이먼츠 BOT•7/31/25, 5:53 AM

❤️ 기술문의 경험이 어떠셨나요?!

간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.