현금영수증 발급내역 조회
현금영수증 발급 진행도중 데이터 유실로 PaymentsKey 를 확인할 수 없는 상황이 되었을 때
버전문제로 /v1/cash-receipts 를 사용할 수 없는 경우
현금영수증 발급내역을 확인 할 수 있는 방법 문의드립니다.
위 건에대한 답변으로 결제내역조회 API를 통해 가능하다는 답변이 있었으나 /v1/transactions에서는 카드, 가상계좌 거래내역만 확인될 뿐 현금영수증 발급내역은 조회되지 않습니다.
v1/transactions API 외에 현금영수증 내역조회를 할 수 있는 API가 있다면 알려주시기 바랍니다.
답변 부탁드립니다.
감사합니다.
25 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
안녕하세요
1. 우선, 현금영수증 발급 도중 데이터 유실로 paymentKey 를 확인할 수 없다는 말씀이 어떤 내용인지 이해가 안되었어요. 현금영수증은 상점에서 무조건 자체발급을 진행하겠다, 라는 계약을 진행하지 않는다면 별도로 발급요청은 필요 없습니다.
* 자체발급 진행 계약을 진행 하신다면, 거래와는 상관없이 현금영수증을 발급할 수 있도록 현금영수증 발급 API 를 제공 하고 있는데, 여기에서는 paymentKey 는 필요 없습니다.
2. 버전문제로 현금영수증 발급을 사용할 수 없다는 말씀도 어떤 말씀 이신지 이해가 안되었어요. 현금영수증 API 를 사용한다면, 발급시에 필수 값은 금액, 가맹점에서 설정한 발급 구분자, 가맹점에서 생성한 발급 구분 명칭, 개인식별번호, 현금영수증 종류 인데요. 이 내용은 버전에 따라서 달라지지 않아요. 어떤 부분에서 버전에 따라 사용할 수 없다, 라고 이해 하셨을까요?
3. 거래를 완료하고 현금영수증을 조회하고 싶다면, 결제조회를 통해서 해당 거래의 상세 내용을 조회 해볼 수 있어요. transactions 가 아니라, GET v1/payments/{paymentKey} 부분이에요.
4. 날짜를 기준으로 발급요청한 현금영수증을 일괄 조회하는 API 는 아래 링크에서 확인 하실 수 있어요
https://docs.tosspayments.com/reference#%ED%98%84%EA%B8%88%EC%98%81%EC%88%98%EC%A6%9D-%EC%A1%B0%ED%9A%8C
몇가지 질의주신 사항이 이해가 되지 않아서, 아래와 같이 최종 정리 해드릴게요.
* 현재 계약한 상점의 현금영수증 발급 청약이 어떻게 되어있는지 확인 해주시고
* 자동 발급이 아니라 별도 발급이 필요한 경우에만 현금영수증 API 를 참조 해주세요.
* 자동 발급된 현금영수증 URL 확인은 결제조회, 또는 현금영수증 조회 API 를 활용해보실 수 있어요.
코어 API | 토스페이먼츠 개발자센터
토스페이먼츠 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
현금영수증 관련 정책적인 문의는 1544-7772 로 문의 주시면 더 자세한 답변을 들으실 수 있어요
일단 1번 현금영수증 발급 이후 paymentkey 를 확인할 수 없는상태에서 toss 상점페이지에서는 현금영수증 발급내역이 확인되는 상황입니다.
paymentKey 는 현금영수증 별도 발급이면 전달 드리지 않아요
따라서 저희는 이후 발생할지 모르는 현금영수증 발행 취소건에 대비해 해당 현금영수증 발행에 해당하는 paymentkey를 확인해야되는 상황이고
말씀하시는 별도발급이라는게 무슨말씀이신지..
지금 문의주시는건 자동 발급인가요? 별도 발급인가요?
API를 통해 발행된 현금영수증입니다
그것이 별도 발급입니다
자동발급은 결제가 일어나면, 저희가 발급을 도와드리는 것이고,
이경우는 현금영수증 발급 API 는 참조하실 필요 없어요
현재 문의주시는 상점의 현금영수증 발급 계약은 어떻게 되어 있으신가요?
저는 개발자라서 계약관련 사항은 정확하게 확인이 어렵습니다만..
용어상 문제가 있긴한데
API문서를 보면 현금영수증 취소거래 시 receiptkey를 전달해야하는거 아닌가요?
다시한번 정리드리면
* 상점 계약 상태에 따라서 토스페이먼츠가 현금영수증을 자동을 발급을 도와 드리고
* 거래가 취소되면 발급된 현금영수증 취소도 토스페이먼츠가 해드려요
지금 문의주시는 현금영수증 API 는
* 상점 계약에서 현금영수증 자동발급이 아니라, 가맹점에서 자체 발급할시에만 참조 하시면 되고
* receiptKey 는 거래와 상관없는 값이에요
상점계약을 먼저 확인 해주시고,
토스페이먼츠에서 발급을 도와드리는 자동발급 계약 상태라면, 현금영수증 API 는 참조하지 않으셔도 되어요
자동발급상태는 아닙니다
그렇다면 현금영수증 API를 참조해야되는 상황인거죠?
💡 정보 제출
현재 discord 오류로 '게시글 분할보기' 화면에서, 팝업 제출이 안되요 😢
(우측상단 '더보기 > 전체보기로 열기' click 후 팝업을 열어주세요)
이곳으로 상점 ID 를 전달 주시겠어요?
어떤 계약 상태인지 확인 해볼게요
k입니다
계약상태 자동발급으로 사용하고 계시네요
자동발급이라구요?
네
그럼 가상계좌에 금액이 입금됨과 동시에
토스에서 현금영수증 발행을 하신다는건가요?
네 맞아요
별도 발급으로 계약 변경이 필요하실 경우에는, 1544-7772 문의 해주시면 되고,
혹시 추가 설명이 필요하시면 질문 주시면 답변 드릴게요
네 알겠습니다 감사합니다
감사합니다 좋은 하루 되세요
혹시 현금영수증 발행 건 order_id 단위 데이터 확인이 가능하신가요?
다른 쓰레드에서 질문 주셔서 이 쓰레드는 close 하겠습니다
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.