영수증 관련 api 사용 문의
오프PG에서 출력되는 영수증과 같은 모양의 영수증을 웹에서 제공하기위한 작업중에 있습니다.
https://dashboard.tosspayments.com/receipt/sales-slip?transactionId=${TID} 위 영수증 url에서
'https://homepage-api-~~~~~~~~/dashboard/api/v1/receipts/sales-slip?transactionId=${TID}' api를 통해 화면을 그리고 있는데, 관련 문서를 찾지 못하고있습니다.
위 api와 연관된 문서가 있다면 전달 부탁드립니다!
19 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
URL 을 임의로 수정하여 영수증을 제공하는것은 불가 합니다.
오프 PG 영수증을 표시하시려는 건가요?
네 맞습니다. 하지만 오프PG영수증 또한 기본값으로 사용하는게 아니라, 커스텀되어있어서 영수증url과 내용이 다른 부분이 있습니다. 위 이유로 뷰를 새로 그리려고 하고있습니다.
지금은 영수증을 어떻게 사용하고 계신가요?
질문이 잘 이해가 되지않습니다.
오프PG 영수증의 사용처를 말씀하시는걸까요 ?
현재 영수증 링크는 어떻게 사용하고 있는지 설명해주시겠어요?
그리고 샘플 주문번호도 하나 주시면 어떤 정보인지 확인해볼 수 있을 것 같습니다.
현재 사용하고 있지 않습니다. 사용하기위한 작업중에 있습니다.
https://dashboard.tosspayments.com/receipt/sales-slip?transactionId=${TID} 이 url을 그대로 사용하려고 했다가, 오프PG에서 주는 영수증과 내용이 다른 부분이 있어, url을 그대로 사용하는것이 아니라 새로 그리려고 했고, 영수증을 그릴수 있는 데이터를 가진 api를 찾던중에 'https://homepage-api-~~~~~~~~/dashboard/api/v1/receipts/sales-slip?transactionId=${TID}' 이와 같은 api를 위 url에서 사용하기에 관련된 문서를 찾고있었습니다.
샘플 주문번호라면, 'POS_d20230607185038aUOR7' 이게 맞을까요?
네, 그렇다면 아래 XPay 공통스펙에 있는 9. 매출전표 링크 연동 방법 내용을 참고하시면 됩니다. 테스트로 위 샘플건 호출 시 정상적으로 호출 확인했습니다. 영수증은 이미지를 참고만 하시라고 일부만 잘랐습니다.
https://docs.google.com/document/d/1kyhcyXmaRuxZAlNJ_Oiuo2EoFVMlQbHZewZW40E6u2w
Google Docs
XPAY결제모듈공통사항_v.1.0.4
Xpay-결제모듈_공통사항 Protocol and Core Function Specification Version 1.0.4 2023.03 목차 1. 문서 개요 3 2. 결제창 UI 안내 4 3. 지원하는 개발환경 5 4. 시스템 요구사항 5 4.1 공통사항 5 4.2 TLS 1.2를 지원하기 위한 개발언어별 요구사항 5 4.3 하드웨어 및 OS 요구사항 5 5. 가맹점 결제 서버 보안 Check List 6 6. Xpay 결제를 위한 방화벽 설정 6 6.1 결제,취소,부분취소, 현금...

❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
감사합니다.
여기 나와있는 WEB_SERVER front가 배포된 도메인을 말하는걸까요 ?

해당 주소는 그대로 넣으시면 됩니다.
혹시 위 스크립트를 사용하려면 XPAY 모듈이 설치되어있어야 할까요 ?
아뇨 관계없습니다.
머트키를 이곳에 이렇게 올리시면 안됩니다.
우선 메시지 삭제 처리 하겠습니다.
거래 확인했고
잘못된 MID 사용하셨습니다.
POS_da-gym
이 MID 의 거래인것 같은데요 확인 부탁 드립니다.
그리고, 아까 올려주신 MID 의 mertkey 변경처리 해드려야 할것 같은데요.
포트원 (아임포트) 사용하고 계신가요?
머트키가 외부로 공개 될 경우
해당 MID 의 거래들을 조회 및 악용할 수 있습니다.
@해골병사
이곳은 공개된 곳이라 올려주신 MID, mertkey 가 누출되었으므로,
변경이 가능한 때에 mertkey 변경 처리 해드리려고 합니다.
잘 아시는 것처럼, MID mertkey 가 있으면 유플러스 XPay 모듈의 많은 기능들을 그대로 사용할 수 있는데요.
지금 포트원 (아임포트) 통해서 토스페이먼츠 서비스를 이용하고 계시는지를 확인 바랍니다.
포트원 통해서 XPay 를 사용하는 것과, 직접 XPay 를 연동하여 사용하시는 것에서 mertkey 변경하는 방식이 달라지므로 확인 해주셔야 합니다.
@해골병사 아직 이곳에 계실까요?
MID 정보는 전달 주셨으므로, 상점 계약 / 기술 담당자에게 메일 드리겠습니다.
우선 사용처 먼저 확인해보겠습니다.
사용처가 어떤 의미 이실까요?
MID: D4 의 mertKey 대해서 XPay를 직접 연동하는것으로 확인되었습니다.
이부분은 어떤내용의 메일일까요 ? MID 전달과 메일이 잘 이해가 되지않습니다.
아까 이곳으로 MID 하고 Mertkey 를 공개적으로 올려주셨는데요
MID 하고 Mertkey 가 있으면, XPay 의 기능들을 그대로 사용할수 있습니다.
그래서, 해당 MID 에 운영 / 기술 / 계약 담당자로 등록한 분들에게 메일을 전달 한다는 의미 였습니다.
직접 연동해서 사용하고 있다고 한다면, 토스페이먼츠 측에서 Mertkey 변경하는 시간과 동시에, 직접 연동한 서버 mall.conf 내 에서 mertkey 변경처리 작업진행 하시면 되고요
설명 부족한 부분이 있을까요?
메일로 커뮤니케이션이 어떠실까요?
가능한 빠르게 액션이 필요 합니다..