정산 테스트
지급 대행 및 정산 테스트를 진행하려고 하는데, Mock 데이터 말고 실제 결제 진행 후에 해당 데이터에 대하여 지급대행 및 정산을 테스트 할 수 있는 방법이 있을까요??
18 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
실제 데이터는 라이브에서 진행해주셔야 합니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
그럼 실제로 돈이 오가는 부분은 따로 연락을 드려야 하는건가요 ? (테스트 기간 동안 결제된 부분들은 정산 후에도 모두 환불 처리 하는 등의 조치가 가능한지요 !)
결제하고 지급대행은 별개인데요.
지금 테스트 하시려는게 결제이신가요? 지급대행이신가요?
결제 테스트는 테스트키로 진행해주시면 되고,
지급대행은 계약이 된 이후에 해당 상점ID 로 테스트해보실 수 있어요.
결제는 구매자 - 가맹점 간의 결제이고, 결제건들은 정산주기에 맞춰서 가맹점에 정산이 되는거고요.
지급대행은 가맹점 - 가맹점의 각 셀러에게 지급 하는 서비스를 의미합니다. 가맹점의 돈통에 있는 금액을 셀러에게 토스페이먼츠가 지급대행 해주는 서비스입니다.
결제 이후 지급대행 하는 것까지의 과정을 테스트하려고 합니다.
저희 요구사항이 각 결제 건에 대하여 정산이 되었는지 확인해야 하는데요, 정산 데이터의 경우
/v1/settlements API를 통해 paidOutDate를 기준으로 가져오려고 합니다. (요 부분은 저번에 질문했을 때 답변 받은 부분 입니다.) 그래서 제가 생각한 플로우는 다음과 같습니다.
1. 결제가 이루어짐
2. 상점 관리자에서 지급 대행 요청서 작성 및 요청
3. 지급 대행 동작
4. /v1/settlements API를 통해 해당 orderId의 결제가 정산 되었는지 확인
위와 같은 플로우에 틀린 부분이 있을까요??
https://discord.com/channels/864296203746803753/1419940853631422566/1419982575023296584
저번에 답변 받은 부분인데, 각 결제 건과 지급 대행이 매핑 되지 않는다는 것은 이해했습니다만, 토스 내에서도 지급 대행 요청을 검토할 떄 정산이 이루어질거라 생각했습니다. 만약 아니라면 v1/settlements의 정산 관련 데이터는 어떻게 생성되는지 궁금합니다테스트쪽은 실제 정산이 되지는 않는대요. (최근 정산 대사를 테스트 환경에 제공하기는 함)
지급대행 테스트를 위해 테스트 상점ID 에 수기로 돈통에 금액을 채워드리고 있습니다.
그래서 정산대사는 v1/settlements 로 조회하시면 되고,
지급대행은 셀러 등록 이후에 지급 테스트 시점에 잔액이 없다는등 오류 메세지가 발생하면 저희쪽에 상점ID 말씀해주시면
테스트 MID 에 금액을 채워드릴 수 있습니다.
그럼 정산대사와 지급대행은 아무런 연관관계가 없는건가요 ??
정산 대사는 가맹점에서 발생한 결제건에 대한 가맹점에서 계산한 금액과 토스페이먼츠에서 계산한 정산 금액을 비교해 볼 수 있도록 제공 하는 것이고요.
즉 가맹점 <-> 토스페이먼츠 간 정산대사.
이렇게 끝나는거고요.
지급대행은 가맹점 계좌의 금액을 가맹점에게 정산해줘야 하는 작업을 "지급대행" 서비스를 대신 이용하여 진행하시는거라고 보시면 됩니다.
즉 이건 가맹점 <-> 셀러들 간의 지급입니다.
귀사 가맹점에 A셀러, B셀러, C셀러 가 있다면, 셀러를 등록하고 해당 셀러들에 지급하는거에요.
결제와는 관련이 없습니다.
결제서비스를 사용하지 않고, 이렇게 위에 지급대행 서비스만 사용하는 가맹점도 있습니다.
4번은 지급대행 요청에 대해 결과를 받고 싶으신거라면 웹훅으로 받으셔야 합니다.
이해했습니다. 정산 조회에서 응답으로 받는 Settlement 객체에 paidOutDate가 정산 지급일로 알고 있습니다. 이 정산 지급일도 지급대행과는 무관한 것인가요 ?
각 결제건과 매핑을 해야해서 웹훅으로는 힘들거 같습니다,, 말씀해주신것처럼 지급대행과 결제와 연관관계가 없어서요
네 무관합니다. Settlement 객체에 있는 내용은 저희가 정산 지급을 할수 있는 돈통에 돈을 넣어드리는 것과 관련이 있어요.
지급 요청한게 지급된게 맞는지는 Settlement 로는 알수가 없습니다.
웹훅이 아니면 지급 결과를 받아오실 방법이 없습니다.
지급대행과 결제와 연관관계 는 가맹점이 관리해주셔야 해요 저희가 드리는 값으로는 연관을 지으실수 없습니다.
넵, 제가 이해한게
Settlement를 통해 정산 여부를 확인할 수는 있으나 실제로 지급이 되었는지는 지급대행 웹훅을 통해 받아 올 수 있다. 하지만 지급대행이 각 결제건에 대해 지급되었는지는 연관관계가 없어서 알 수 없다.
요건데, 맞을까요 ??
정산 여부와 실제로 지급이 되었는지 는 아무 관계가 없습니다.
결제가 되면 저희와 계약한 가맹점의 정산 주기에 따라 토스페이먼츠 -> 가맹점 으로 정산금이 입금됩니다.Settlement 는 이걸 확인하는 API 에요.
결제가 여러건 발생해서 수수료 빼고 1억이 발생했다면 저희가 komment 님에게 매칭된 돈통에 1억을 넣어 둡니다. 이게 Settlement 에요.
이렇게 1억이 돈통에 있으면 이 1억을 각 셀러별로 얼마씩 줘야 하는지는 komment님이 계산해서 한건한건 API 나 상점관리자에서 요청해주셔야 합니다.
요청에 대해 성공 응답이 발생하지만 아직 요청주신 지급이 발생한건 아니구요. 이후에 지급 배치가 돌면서 지급이 일어나고 지급이 되었는지여부는 웹훅으로 받으실수 있습니다.
아니면 https://docs.tosspayments.com/reference#%EC%A7%80%EA%B8%89-%EC%9A%94%EC%B2%AD-%EB%AA%A9%EB%A1%9D-%EC%A1%B0%ED%9A%8C 이 API 를 써서 요청하신 지급건이 실제 지급되었는지를 확인하실수도 있구요.
코어 API | 토스페이먼츠 개발자센터
토스페이먼츠 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
이해했습니다.
그렇다면, 현재 테스트 환경에서 Settlement를 조회하면 Mock 데이터가 내려오는데요, 실제 결제를 하고 관련된 정산 대사에 대하여 테스트하려면 테스트 환경이 아닌 라이브 환경에서 테스트 해야할까요?
또, 라이브 환경에서 테스트를 한다면 실제 돈이 오갈텐데, 테스트 건에 대해서 수수료 등이 발생할까요 ?
네 맞습니다. 카드 결제의 경우 전부 취소하면 수수료 돌려드리니까 카드 거래로 테스트 해보시면 될것 같아요.
넵 자세한 답변 감사드립니다 !