페이나우비즈 거래내역 조회 api 관련 하여 문의드립니다.
오프라인으로 paynowbiz를 통한 결제건의 경우 거래내역을 불러오기 위한 api를 호출할 때,
아래의 url로 http 요청을 통해서 거래내역을 가져왔습니다.
https://paynowbiz.uplus.co.kr/2/pg.medic
파라미터(servicecode: getAPPL (일별거래내역)
,mertid: 페이나우비즈상점아이디
,startdt
,enddt
,hmac)
그런데 아래와 같이 pg거래내역 호출을 통해서도 가능한것 같아서 문의 드립니다.
페이나우비즈상점아이디를 mertid 값으로 넣으면 페이나우비즈 거래내역도 같이 나오는게 맞을까요?
https://pgweb.tosspayments.com/pg/wmp/outerpage/trxdown.jsp?mertid=페이나우비즈상점아이디&servicecode=TRX&trxdate=날짜&key=키
40 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
같이 나올수는 있습니다만 누락되는 거래건이 있을수 있어 가이드 하지 않습니다.
정보의 정합성을 저희가 보장하지 않습니다
메일로도 문의를 드린적이 있었는데요, 기존에 paynowbiz 거래내역을 호출 api
에서 servicecode: getAPPL(일별거래내역)으로 호출하게 되면 최종 거래된 내역으로만 가져오는 이슈가 있었어요
예를 들면 23년06월01에 결제건과 취소건 2개가 존재한다면 최종 취소처리한 내역만 가져오는 케이스 입니다.
따라서 기존 api 말고 (아마도 유플러스일때 만들어졌었던 api) 토스에서 신규로 구축한 api를 호출해야 될거 같습니다.
그렇게 되면 신규 api 에서도 paynowbiz 거래와 일반 pg 거래를 가져오는 api는 별도로 구축되어 있나요?
아니면 하나의 api에서 상점아이디로 구분이 가능한 방식일까요?
신모듈 API와 구모듈 API는 어떤 경우에도 동기화 되지 않는거로 알고있습니다.
따라서 페이나우비즈는 기존에 전달받으신 그 PaynowBiz v1 API만 가능합니다.
페이나우비즈 거래는 페이나우비즈 API 통해서 대사 하시는 것을 추천 드립니다.
* 23년06월01에 결제건과 취소건 2개가 존재한다면 최종 취소처리한 내역만 가져오는 케이스
이와 관련해서 저희 쪽 메일로 전달한 적이 있다는 말씀 이실까요?
네네 , 날짜는 예시로 드린거고 실제 문의 드렸던 거래의 날짜는 23년01월27일 자 거래 였습니다.
아래와 같이 답변 받았었습니다.
"안녕하세요
토스페이먼츠 입니다
지금 이용하고 계신 servicecode = getAPPL 은 일별결제내역을 조회할수 있는
서비스입니다.
금일 결제후 금일취소가 되던, 과거에 결제가 되고 금일 취소가 되던 최종상태값만 보여드리고 있습니다."
신모듈 API와 구모듈 API 가 동기화 되지 않는다는 것이 어떤 말씀이신지 잘 이해가 안되네요.
그리고 페이나우비즈 거래내역 호출은 아래의 정보로만 호출하고 있습니다.
#LGUPLUS(paynowbiz)
site.lguplus.mert.id=AESTURA365
site.lguplus.url=https://paynowbiz.uplus.co.kr/2/pg.medic
지금 말씀하시는 기존 API 와 토스에서 신규로 구축한 API 를 어떻게 이해하고 있으신지 설명 해주시면 좋을것 같습니다.
그리고
https://github.com/PaynowBiz/v1
여기에 명시된 API 보고 있으신것 맞는지도 확인 해주시면 좋을것 같습니다.
위의 API는 호출하고 있지 않습니다. url이 다르네요
https://upaynowapi.tosspayments.com/2/v1/
기존 API 와 토스에서 신규로 구축한 API
이건 저희가 어떻게 이해하면 될지 설명 부탁 드립니다
PG 관련하여 토스측에서 유플러스의 PG 인수하기 전부터 저희 몰에서는 해당 api를 호출하고 있었습니다.
그래서 기존 API라고 말씀드렸던 부분이고요
토스로 바뀌고 나서 위 API가 신규로 구축된걸로 알고 있습니다.
xpay와 신모듈 얘기하시는게 아닌가 싶습니다
동일한 url입니다
우선 저희가 원하는 것은 servicecode =getAPPL로 호출하게 되면 최종상태값만 보여줘서 문제가 되니
결제,취소 등 전체 거래내역을 추출하는 것입니다.
동일한 url이라고 하셨는데 기존 url로 호출할때 servicecode만 바꿔서 호출하면 되는 걸까요?
기존 거래내역 조회를 위한 url 호출 정보입니다. servicecode = getAPPL 로 하였습니다.
site.lguplus.url=https://paynowbiz.uplus.co.kr/2/pg.medic
StringBuffer param = new StringBuffer();
param.append("servicecode="+servicecode);
param.append("&mertid="+mertid);
param.append("&startdt="+startdt);
param.append("&enddt="+enddt);
param.append("&hmac="+hmac);
우선 중간 정리 하겠습니다.
말씀 하시는 구 API 는, 예전에 전달 받으신 대사 방식을 뜻 하고,
신규 API 는 여러가지 복합적으로 섞여 있는듯 합니다.
그래서
구 API - 지금 사용하고 있으신 API 로 우선 정의 하겠습니다.
제가 공유드린 github 에 명시된 API 스펙을 보시면, 이해하신대로 서비스코드를 변경해서 요청해보실 수 있는데요.
예전에는 SHA256 해시 후 Base64 인코딩 한 hmac 전달하는 방식을 사용하는 오래된 방식이었다면, github 에 명시된 방식은 4번에 명시된 방법으로 진행 하시면 됩니다.
자세한 설명은 박의원 님께서 도움 주실 예정 입니다.
안녕하세요. 내용을 좀 정리해드릴께요
* 현재 이용중이신 https://paynowbiz.uplus.co.kr/2/pg.medic 는 더이상 기능추가/변경이 되지 않는 (구)LG유플러스 스마트팜 서비스에서 이용되는 대사서비스입니다. 이것은 말씀하신대로, 트랜잭션 기준이 아닌 최종 상태 기준으로 출력하기 때문에 , 호출시점 및 거래상태에 따라 거래데이터 상태가 변경되는 이슈가 있습니다.
* xpay용 거래대사 (https://pgweb.tosspayments.com) 로 현재 페이나우비즈 거래는 조회되고, 결제일/취소일 기준으로 각각 데이터를 수집할수 있습니다만, 사용을 권장하지 않습니다. (사유 : 페이나우비즈 거래원장과 xpay 거래원장이 분리되어 있습니다. 동기화에 문제가 있을경우, 실제 결제는 났는데 pgweb 에서 거래수집이 되지 않는 문제가 있습니다.)
요약하면
pgweb 을 쓰면 -> 원하는대로 거래수집은 되는데 , 거래건이 빠질수 있음
현재이용중인 paynowbiz를 쓰면 -> 거래는 안빠지는데 원하는 형태가 아님
일것 같습니다.
https://github.com/PaynowBiz/v1 에 있는 API가 최신 페이나우비즈 전용 거래조회 API 입니다. 이것을 쓰면 위 두 이슈가 해결될것 같습니다.
위 API와 관련해서, 혹시 샘플이 필요하실경우
https://drive.google.com/drive/u/0/folders/1Y6vCSLtWPv-Dna1TyXo_wPAveHfsT_EH 샘플을 웹서버에 올려 확인해보시면 될것 같습니다. (api에 셋팅하는 certkey 및 암호키는 , techsupport@tosspayments.com 으로, 사용하는 mid와 함께 요청주시면 전달드리겠습니다)
박의원님 상세히 설명해주셔서 감사합니다. 이해 되었습니다.
최신 API로 조회하는 것으로 변경하겠습니다.
다만 일상기록님이 말씀해주신대로 SHA256(mertid + mertkey) 으로 hmac을 전달하는 방식으로 사용을 했었는데
최신 API를 사용하기 위해서 기존 mertkey와는 별개로 certkey 및 apikey를 새로 발급받아야 되는것이 맞나요?
또한 servicecode는 "payments"로 호출하면 결제 및 취소 거래를 모두 수집하는 것이 맞을까요?
기존에 이용하시던 MID를 techsupport@tosspayments.com 로 회신부탁드립니다. (따로 신규발급할 필요는 없을텐데..다시 체크해보겠습니다)
거래조회는 payments 이 맞습니다. 이외에도 취소, 정산조회도 지원이 되며, 샘플페이지의 index.html 을 참고부탁드립니다
네, 감사합니다. 회신드리겠습니다
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
페이나우비즈거래내역 조회 api 호출 관련하여 문의가 있어 다시 글 남깁니다.
위에서 언급하신 것처럼 servicecode payments(거래내역조회), settlements(정산내역조회)
2가지를 테스트 해보았는데요. 거래내역조회의 경우 최종상태값만 가져오는 api인것 같습니다. (테스트하여 확인)
따라서 정산내역조회 api 를 통해서 결제/취소 모두 가져오는 것을 확인하였습니다.
다만 문제가 되는것이 정산내역조회 api의 경우
paydate결제일(YYYY-MM-DD) 과 reqdate카드매입/취소 요청일(YYYY-MM-DD)
모두 년/월/일 까지만 가져와서 시/분/초 값을 가져올 수가 없는데요.
시/분/초 값은 필수로 가져와야 하는 데이터라서 문의 남깁니다.
한가지 더 문의 남깁니다. 페이나우비즈 api 는 스테이징이나 DEV 환경이 별도로 구성되어 있지 않나요?
1) payments 거래내역조회에서 셋팅한 MID와 request 정보 를 회신주시면 , 재확인해서 회신드리겠습니다.
2) 정산내역 API는 정산관련 데이터를 출력하는 것인데, 분초단위의 매입/정산처리시간은 응답하지 않습니다. 정산은 보통 일단위로 이루어지는데 시분초단위까지 필요하신 사유를 좀 더 구체적으로 회신해주실수 있으실까요?
3) 네 페이나우 비즈는 별도로 테스트 환경을 지원하지 않습니다. (결제용 APP도 함께 개발용으로 설치를 해야 하는데, 이 부분이 지원이 어렵습니다. 결제용 APP은 단말기와 함께 여신협회 인증사항이다 보니, 외부에 앱 소스를 개발용으로 오픈하기가 어렵습니다)
1) AESTURA365 가 MID 이고 키값을 여기에 남겨도 되나요? (https://upaynowapi.tosspayments.com/2/v1/AESTURA365/settlements)
2) 현업에서 해당 데이터를 가지고 정산하는 방식이라 제가 답변드리기는 어려울 것 같습니다. 일단 이 문제는 현업 담당자분께 공유 하겠습니다.
다만, 필요시 다시 요청 드려야 될 것 같습니다.
3) 페이나우 비즈 테스트 환경을 지원하지 않는다면 테스트 할 수 있는 방식이 따로 있을 텐데 예를 들면 상점 ID를 테스트용으로 제공하고 연동하는 방식이라던지 등 입니다.
다른 대책을 마련해주셔야 될 것 같습니다.
말씀하신 정보면 충분합니다. 추가로 키는 남겨주시지 않아도 됩니다.
일전에 메일 주셨던 주소로, 실결제용 테스트 MID 및 키정보를 회신드리겠습니다. 실결제는 발생하지만 가맹점 실 거래로는 잡히지 않을것입니다.
첫번째 거래조회부분은 저희 개발쪽에도 확인을 해보고, 메일로 추가회신드리겠습니다.
1) 번에 대해서 추가적으로 말씀드리면 23년 1월 27일자 거래로 확인하시면 더욱 좋을것 같습니다.
해당 일자로 거래내역조회 api와 정산내역조회 api를 동일하게 호출하여 데이터를 비교해보시면
거래내역조회의 경우 최종취소된 거래에 대해서는 최초 결제한 내역이 포함되어 있지 않습니다.
따라서 어쩔수 없이 정산내역조회 api를 써야 되는 상황이라서 현재 문제가 되는 부분입니다.
두번째로 테스트 MID 및 키정보로 호출하되 url은 기존 upaynowapi.~를 호출하면 되는 것이 맞을까요?
네 1번 부분 확인중입니다.
조금전 테스트 계정정보 전달드렸습니다. certkey 및 암호키도 함께 전달드렸으니, 기존의 API에서 mid , certkey, appkey만 변경하시면 됩니다.
네~ 테스트 계정정보 확인하겠습니다.
감사합니다.
혹시 보내주신 테스트 상점 아이디는 개별 아이디가 맞을까요?
저희 시스템에서만 사용할 수 있는게 맞는지 확인 부탁드립니다.
아뇨 테스트를 원하시는 다른 가맹점이 사용하실수도 있는점 감안해 주시기 바랍니다.
기존 정산내역조회 api에 년/월/일로 나오는 데이터를 시/분/초 추가하는게 어려운 작업인가요?
아니면 별도로 컬럼추가하는 것도 어려울까요?
정산내역이라는게 일자를 기준으로 하고 있기 때문에 시/분/초는 제공하고 있지 않습니다.
박의원님 답변 부탁드립니다.
기존 거래내역조회 api 를 호출하게 되면 최종거래상태의 내역만 뽑아서 누락되는 건이 발생하게 되는데
정산내역조회api를 호출하자니 결제일시/취소일시의 "시/분/초"는 제공하지 않는다고 하시는데
그럼 누락된 건의 결제시간 / 취소시간은 받을 수 없다는 결론 밖에 안나옵니다.
안된다고 하시면 저희 몰쪽 정산 관련 담당하시는 분께 지원불가로 전달드리도록 하겠습니다.
@jonghwan.park
우선 메일로 문의주신 내용은 메일로 회신드렸습니다.
정산대사에서 분초를 추가하는것은 어려울것 같습니다. (정산쪽 테이블에 승인일자까지만 저장합니다)
메일로 답변드렸습니다만, 일단 신규 API를 개발검토 요청드린 상태입니다.
현재는 말씀주신대로, 정산조회에서 결제시간/ 취소시간은 제공이 어려울것 같습니다.
일단 페이나우비즈 전용 API의 기능추가를 검토중입니다만, 최초 문의주셨던 pgweb 을 통한 거래대사에서, 거래누락건이 발생할 소지가 있는지 추가로 체크해보겠습니다. (거래누락이 발생하지 않는다면, xpay pgweb용 거래대사를 메일로 가이드 드리겠습니다)
답변 감사드립니다. 검토 후 결과 회신 부탁드립니다.
감사합니다.
메일로 검토 결과 회신드렸습니다.
현재 정산조회 API에서 결제시간/취소시간 파라미터를 추가하는것으로 개발예정입니다. 개발완료일정 fix되는대로 메일로 추가 회신드리겠습니다
확인하였습니다. 감사합니다.
현재 페이나우비즈 거래내역 API 호출시 동일 값으로 개발과 운영에서 호출했을때의 결과 값이 다른 이슈가 있는데요, 해당 관련해서 메일 보냈습니다.
6월 말 정산작업이 완료되어야 하는 문제라 긴급한 이슈입니다.
확인부탁드립니다.
감사합니다.
관련하여 답변 드렸습니다.
정산 마감 시간 이슈로 인한 원인으로 확인 되었습니다.
빠른 답변 감사드립니다.