지급대행요청 API 질문입니다.
(post) v1/payouts/sub-malls/settlements 에서
(post) v2/payouts 으로 변환하려고 합니다.
변환되는 것은
subMallId -> destination
transferSummary -> transactionDescription
payoutAmount -> amount
이 맞나요?
scheduleType 은 신규이고, 오후 3시 이전이면 Express를 쏘면 될것 같고, Scehduled 이면 payoutDate를 추가하면 될 것 같습니다.
refPayoutId 이 값은 어느걸 넣어야 하는걸까요???
refPayoutId 이 값이 뭔지를 잘 모르겠습니다.
12 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
문서를 보고 맞춰서 변환해 주시면 됩니다.
destination 은 서브몰 아이디가 아니라 저희가 채번한 셀러 ID 입니다.
v1 으로 등록하신 거라면 셀러 조회 API 로 셀러ID 를 확인하신후 요청해 주셔야 할거에요.
refPayoutId 는 응답으로 받고 싶으신 지급요청 ID 입니다.
v1과 다르게 v2 는 저희 ID 와 별개로 가맹점이 원하는 ID 도 같이 응답에 보내드리고 있습니다.
질문 1번
v1에서는지급대행요청을 하면, output으로 payoutKey 값을 주셨자나요?
refPayoutId 는 그걸로 보면 될까요?
v1에서 기존에 서브몰 등록할 때, id 만들어서 요청한 것처럼, v2에서는 지급대행 요청할때도 저희가 만들어서 요청하라는소리일까요?
질문 2번
서브몰 아이디가 아니라 셀러ID라고 하셨는데, v1으로 가입했던 서브몰들이 지금 셀러 관리에 들어가 있고, 그때 id값이랑셀러의 id값이 같은 것 같은데. 해당 값 말고 다르다는 이야기일까요?
답변1
아래 내용을 참고하시면 됩니다. 상점에서 생성하는 값이에요
https://docs.tosspayments.com/reference#%EC%A7%80%EA%B8%89%EB%8C%80%ED%96%89-%EC%9A%94%EC%B2%AD
코어 API | 토스페이먼츠 개발자센터
토스페이먼츠 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
답변2
v1 에서 사용되던 subMallId 값을 v2 에서는 사용하지 않고 셀러아이디를 사용합니다.
당사에서 v1 사용하시던 가맹점의 서브몰 정보들을 v2 에서 사용하실 수 있도록 마이그레이션 작업이 있었구요. (아무래도 다시 전부 등록하시려면 불편하실테니..)
마이그레이션 작업된 셀러아이디를 확인하시려면 조회를 하셔야 된다는 의미였어요
확인하셨던 셀러의 id 값을 스샷으로 전달주시면 내용을 더 확인해볼게요
답변2.에 대한 예시
예시를 몇개만 들자면,
v2_I_29810516_00uD33
v2_I_73002335_0005ps
저희가 v1/payouts/sub-malls API를 통해서 만들었던 셀러입니다.
죄송합니다.
refPayoutId
상점에서 직접 발급하는 지급대행 요청의 고유 식별자입니다. 연동 중에 참고할 수 있는 값입니다. 등록 이후에 수정할 수 없고, 같은 값을 다시 사용할 수 없습니다.
이게 뭔지 잘 모르겠습니다.
지급요청 할 때, 저희가 그냥 임의로 값을 만들어서 API를 요청하면 된다는 거일까요?
아니면 셀러마다 하나씩 있는건지 잘 이해를 못하겠습니다ㅠㅠ
네 지급 요청할때마다 지급건에 대한 ID 를 직접 만들어서 보내시면 됩니다.
그값을 응답으로 그대로 드릴거에요.
네 감사합니다. 만약에 50건을 한번에 발송해도, 각 지급건별로 1개씩, 총 50개의 ID를 만들어서 보내는게 맞는걸까요? 그냥 저희가 지급대행 건에 대해서 관리용으로 쓰라고 하나 만들어주신 개념으로 이해하면 될 것 같습니ㅣ다.
추가적으로,
v1에서 결과값으로 payoutKey 에 해당 하는것은
v2에서는 id로 보면 될 것으로 생각됩니다.
(웹훅을 통해서 확인등을 할때)
네 맞습니다. 가맹점이 관리하시는 ID 로 사용하시는 겁니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
아 지금 테스트해보면서 위의 말을 대충 이해했습니다.
저희가 셀러를 등록할 떄,
(post)v2/sellers
refSellerId : v2_I_54697884_003xb3 로 만들었습니다.
결과값으로,
id : seller_a01jaynd4ex3k03feng95g1ht67
이 값이 왔습니다.
수정할때는.
id : seller_a01jaynd4ex3k03feng95g1ht67
이값을 이용해야할것 같고,
아까 destination 도
seller_a01jaynd4ex3k03feng95g1ht67
이값을 이용해야 한다는 소리였군요..
근데 해당 값은 어떻게 조회해올수 있을까요?
이미 v1에서 만든 애들은 어디서 볼수 있는지.
혹은 refSellerId 로 조회하는 방법이 있는지.
셀러관리에서도 해당 값이 나오는것 같지는 아는데 어떻게 확인할수잇는지 궁금합니다.
우선
https://api.tosspayments.com/v2/sellers
에서 그냥 저희가 수동으로 변경하던가 하면 될 것 같긴 합니다..
https://api.tosspayments.com/v2/sellers 로 조회해서 refSellerId 를 검색해 보시면 될겁니다.
기존의 submallID 가 refSellerId 에 있을거에요.