통합결제 / XPay 문의
안녕하세요 🙂
이해가 잘 안되서 질문이 너무 터무니없을수도있는점 미리 양해부탁드립니다.
업체에서 사용하던 기존 결제 모듈은 XPay였는데, 업체측에서 통합결제모듈로 버젼업?을 원하는 상황이고 자주쓰는? 카드 결제 관련해서는 이슈가 없는것으로 보이는데요 .
가상계좌에서 사용되는 에스크로 서비스의 배송등록 API라던지에 대해서는 XPay 사용가이드 밖에 찾지 못하였습니다.
가이드 URL : https://docs.google.com/document/d/11BmZFpwK_ViiCrjqTzAmVB6mAQUH0TKS3eOB9d4Yigs/edit#heading=h.6pkhfqmwo3a2
여기서 파생되는 질문이 세개가 되는데요.
1. 통합결제 API (코어API) 를 통해서 에스크로 관련 배송 정보 수정을 할수있는지?
2. 1번이 되지 않아 Xpay를 연동해야한다면 통합결제 SDK를 사용하면서 Xpay 에서 필요한기능 ( ex 배송정보 등록 , 계좌 유효성 체크 ) 를 사용할 수 있는지?
ㄴ 트랜잭션 키라던가 paymentKey가 공유가 가능해서 통합결제에서 가상계좌로 결제를 하고 , xpay로 배송완료 처리api를 호출하는 케이스
3. 통합 SDK를 사용하면서 XPay를 사용한다면 이건 계약이 어떻게 진행되는지?
XPay를 검색해보면 LG의 전자결제 서비스라고 뜨는데요 이게 토스페이먼츠와 무슨 상관이 있는지.. 도 궁금합니다.
계약이 따로 되어야하는건지 ; XPay에서는 왜 토스결제창이 뜨는지 .. ㅜ 다소 많은 질문이라 죄송합니다 ㅜ
계약이 따로 되어야하는건지 ; XPay에서는 왜 토스결제창이 뜨는지 .. ㅜ 다소 많은 질문이라 죄송합니다 ㅜ
Google Docs
XPAY[기타]에스크로_v.1.0.3
Xpay-기타-에스크로 Protocol and Core Function Specification Version 1.0.3 2022.09 목차 에스크로 서비스의 개요 3 연동 샘플 파일 구조 4 API를 통한 배송정보 등록 및 배송완료 등록 4 API URL 4 배송정보 등록 요청 파라미터 5 배송완료 등록 요청 파라미터 6 ▪ 배송정보 등록 및 배송완료 등록 응답 파라미터 6 처리결과 수신 7 처리결과 수신페이지 URL 등록 7 처리결과 전송 파라미터 7 Appendix. 발송택배사 ...
17 Replies
3/12 이후에 결제 연동을 해보신 분들을 찾습니다!🔎
제품 발전을 위해 설문에 참여해주세요! 추첨을 통해 선물을 드립니다. (1분 소요)
말씀해주신 에스크로 및 계좌유효성 검사는 xpay모듈로만 제공됩니다.
다만 우려하시는 것과 달리 통합결제SDK를 사용하시면서, 에스크로/유효성검사만 xpay를 사용하실 수 있습니다.
계약 관련된 문의는 아래 연락처로 해주시면 도와주실 거에요
토스페이먼츠 결제연동팀
오! 너무 다행이네요.
둘다 동시에 하나의 주문건으로 사용할수있다는 말씀으로 이해해도될까요?
ex) 통합결제에서 A라는 상품을 가상계좌로 결제 (with 에스크로 ) -> xPay를 통해 배송완료 처리 -> 통합결제 API에서 상태 확인가능
네 맞습니다
아 다만 에스크로관련 상태확인은
xpay모듈을 사용해주셔야해요
혹시 업체에서 버전 업을 원하는 사유가 별도로 있을까요?
따로 사유는 없으신걸로 보입니다.
이번에 고도화하시면서 같이 하시려고 하는거같아요
버젼업 하면 좋은점이 있을까요?
아, 혹시 Xpay 가 지원하는 대상에서 vue는 없는가요.. ? ㅜ
기존에 사용하고 계시면서, 브랜드페이나 결제위젯 등 새로운 기능들을 도입하지 않으시는 경우 별도로 버전업이 필요하진 않습니다
더불어 버전업하게 되는 경우 거래/정산대사도 새로 연동해주셔야합니다.
브랜드 페이같은경우는 기존에 Connect Pay로 사용하시고 계셨는데 , 해당 업체에서 연락해서 문의해본 결과 mId만 변경없으면 기존과 동일하게 사용할수있다고 답변을 받으셨다고 하시더라구요
혹시 업체명이나 mid 알수 있을까요? (확인 후 바로 지울 예정입니다)
xpay사용하시려면 java/php/asp 서버가 있어야 사용하실 수 있습니다.
java서버는 존재합니다 . 프론트를 vue로 구성하는데 지원대상에 jsp로 적혀있어서 문의드렸어요.
될거같은데 혹시나해서 적었습니다 😅
네네 vue는 프론트 도구라 xpay연동하시는데 문제 없습니다~
넵 ㅎ 혹시 버젼업된 코어API에서는 에스크로 관련해서 처리하는게 아무것도 없나요? 대체 할수있는것이라던가.. 요런게 궁금해서요.
다른분들 연동하실땐 이런 처리가 없으신건가요;;
다른분들도 에스크로는 별도로 xpay로 연동하시도록 안내하고 있습니다.
아하! 그렇군요
답변 감사합니다 🙂
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
xpay 는 토스페이먼츠의 전신인 LGU+ PG 의 제품명 이었습니다.
토스페이먼츠가 출범하면서 RESTful API 기반으로 새롭게 결제 모듈을 만들어서 서비스를 시작했구요
xpay 를 사용하시는 경우에도 계속 사용하시는데 문제는 없지만
아무래도 제품을 만든지 시간이 어느정도 지난 모듈이라서 업데이트가 활발하지는 않습니다.
https://docs.tosspayments.com 에서 확인하실 수 있는 API들은 xpay 제품과는 무관하고 토스페이먼츠에서 새롭게 만들은 제품입니다.(이하 신모듈)
둘다 토스페이먼츠에서 운영중인 제품이기 때문에 어떤 모듈이 좋다 나쁘다를 말씀드리기는 어렵습니다. 다만 이실장님이 설명주셨듯이 일부 기능들에 한해 신모듈에서는 지원이 어려운 경우가 있습니다. 에스크로도 신모듈에서 서비스될 예정이지만 시점을 확답드릴수 없는점은 양해부탁드립니다.
어떤 모듈을 사용하여 어떻게 연동할지 보통은 결제연동팀에서 추천드리지는 않습니다. 하지만 가맹점에서 하시고자 하는 서비스가 풀필먼트가 필요하고 에스크로를 꼭 사용하셔야 한다면 xpay 를 사용하시는것이 개발 공수를 줄이는데 도움을 줄 수 있습니다.
토스페이먼츠 연동 문서 홈 | 토스페이먼츠 개발자센터
토스페이먼츠 연동 문서입니다.
xpay 와 신모듈간 가장 큰 차이점은 키값입니다. xpay 에서는 가맹점에서 생성한 주문번호와 PG에서 van을 통한 승인시도 이후에 받으시는 tid 를 키로 사용하시게 되는데요, 신모듈에서는 인증완료와 함께 paymentKey 를 내려드립니다.
일반적으로 특정 거래를 trace 하실때 tid 가 있다면 PG-VAN을 통해 승인을 한번은 찍고 왔다고 판단할 수 있고. 해당 거래가 오류로 리턴되었다면 승인오류만 확인을 하시면 됩니다.
하지만 신모듈의 경우 paymentKey 가 키 값이기때문에 가맹점에서 승인요청을 했는지 안했는지 부터 trace 를 해야 정확한 오류를 찾으실 수 있습니다. (인증 이후에 승인을 안보내고 오류로 판단하신 경우입니다.)
이 내용이 있어서 xpay 를 사용하시다가 신모듈로 전환하시는 가맹점에서는 결제관련 테이블을 새롭게 구성하시는것을 추천드립니다.
이렇게 상이한 내용들이 있어서 xpay와 신모듈을 혼용하여 사용하시는것은 매우 난이도가 높은 작업입니다.
약간 더 자세하게 설명드리면 사용하시는 상점아이디가 여러개이고, 사업부서가 각각 다르고, 쇼핑몰도 여러개에 원장도 분리하여 운영중이시라면 별도로 구성하시면 되기에 크게 문제되는 상황은 없습니다.
가맹점에서 운영하시는 자체 Admin 이 있다면 키값개념이 달라짐에 따른 취소이슈가 발생하여 xpay 와 신모듈을 함께 사용하시기 어려울 것으로 생각됩니다.