정산 관련하여 문의드립니다
안녕하세요.
결제 내역에 대한 정산 관련 개발을 하기 위해 문의 드립니다.
기존에 지급 대행 웹훅을 활용하여 개발하려 했는데, 지급 대행 웹훅에서 내려주는 데이터들이 결제 내역 단건들에 대해 매핑하는게 다소 어려워보여서 다른 방법을 찾고 있습니다.
현재 생각하는 방향은 Batch 작업으로
/v1/settlements API를 호출하여 정산 데이터를 가져와 결제 내역 건마다 정산처리를 해주려고 하는데, 맞는 처리인지, 더 나은 방향이 있는지 문의 드립니다.
https://docs.tosspayments.com/reference#%EC%A0%95%EC%82%B0-%EC%A1%B0%ED%9A%8C코어 API | 토스페이먼츠 개발자센터
토스페이먼츠 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
15 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
결제 내역에 대한 정산 관련 개발 이라는게 정확히 어떤 기능인지 알수 있을까요?
토스페이먼츠의 결제 승인 및 결제 취소 API를 활용하여 결제 기능을 개발하였는데요, 저희 쪽에서도 토스페이먼츠에서 받는 응답과 저희 쪽에서 설계 결제 시스템 도메인에 따라 내역들을 쌓아주고 있습니다.
쌓이는 결제 내역들에 대한 정산 및 지급대행 역할을 토스페이먼츠 측에서 해줄텐데, 저희 쪽에서도 정산이 완료되었는지와 제대로 정산되었는지에 대한 대사처리가 관련된 개발을 진행하려고 하는데, 보통 어떻게 개발하는 것을 권장하는지 여쭈어보았습니다 !
지금대행을 사용하시는 건가요? 실제로 지급은 저희가 자동으로 하는게 아니고 지급을 직접 요청해 주셔야 합니다.
저희 축에서 지급 요청서를 작성한 후, 토스 페이먼츠 측에서 지급을 수행해주시면, 저희 쪽에서도 관련 데이터를 따로 저장하려고 합니다. 결제건마다 저장해야 하는 요구사항이 있는데, 지급대행 웹훅은 그렇게 상세히 내려주지 않고 있는 것 같아서요.
그래서 정산 API(/v1/settlements)를 이와 같은 캐이스에 활용해도 되는지 묻고 싶습니다. 또, 정산 API가 아니더라도 활용할 수 있는 API가 있을까요?
정산API 는 결제가 발생했던 건들의 정산내역을 표현하구요
정산지급대행은 결제나 정산API 와 무관하게 누구에게 언제, 얼마만 명시하는 서비스에요
두가지가 이어지는 부분이 없습니다
정산 지급대행이 되면 지급이 되었다는 웹훅을 보내드립니다. 그 웹훅을 받아서 처리하시는걸 추천드립니다.
정산 API(/v1/settlements) 와 정산대사는 아무런 관계가 없어요.
이해했습니다.
그럼 정산 API에서 paidOutDate(정산 지급일)는 어떤걸 의미하는건가요 ??
/v1/settlements는 지급대행이 아닌 일반 가맹점에서
정산계좌로 정산금이 들어가는것을 대조하는 것이고
paidOutDate는 정산금이 들어간 날짜입니다.
정산지급대행과는 전혀 무관한 서비스입니다.
그렇다면 지급대행을 활용할 때는 각 결제 건에 대한 정산 완료 여부를 알 수 있는 방법이 따로 없을까요?? 웹훅으로는 그 정도로 상세하게 주고 있진 않는것 같아서요
코어 API | 토스페이먼츠 개발자센터
토스페이먼츠 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
이걸 쓰셔야 해요
결제 단건 단건마다 매핑은 불가능한가요?? 제가 이해하기로는 매핑을 위해서는 orderId나 paymentKey를 활용해야 할거 같은데 그러한 식별자들을 내려주진 않는거 같아서요
일단 , 결제랑은 완전히 별개에요
orderId, paymentKey는 결제에서 쓰이는거고 연관이 없어요
결제랑 완전히 별개라 매핑도 안됩니다
지급대행을 활용할때 각 결제건에 대한 정산 완료여부
--> 두가지 내용이 섞여있습니다
각 결제건에 대한 정산완료여부 : /v1/settlement/ 를 사용하시면 됩니다
지급대행에서의 활용 : 금액을 직접 계산하여 지급요청을 하셔야해요, 결제와 이어지지 않습니다. 당연히 연결되는 키값도 없구요