현금영수증 발행 API 사용 문의
안녕하세요 결제 연동완료하여 가상계좌 결제 테스트 진행중입니다.
결제승인 API 호출 결과로
cashReceipt property에 receiptUrl 정보가 포함되어 반환됩니다.
해당 url 실행시 '필수 파라미터가 누락되었습니다. (transactionId)' 라는 문구와 함께 현금영수증 정보가 조회 되지 않습니다.
현금영수증 발급 요청 API 실행에 성공 응답을 받은후 해당 영수증 Url을 실행해봐도 동일한 오류가 발생합니다.
개발자센터에 해당오류와 관련된 가이드를 찾지못해 문의글 남깁니다.
추가적으로 현금영수증 발급 요청 API 문서와 직접 실행해보기 링크에 표기되는 필수가 정보가 다릅니다.
필수값 정보와 customerIdentityNumber 와 registrationNumber 의 대한 설명도 추가로 요청드립니다.
12 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
우선, 테스트 환경에서는 URL 이 정상 동작하지 않습니다. 현금영수증 URL 접속하여 확인이 필요하실 경우에는 실제 운영환경에서 진행 하셔야 합니다. 로직 구성에만 활용해주시고, 실제 내용 검증은 운영환경에서 진행 부탁 드립니다.
registrationNumber, customerIdentityNumber 는 API 버전에 따라 달라집니다. 최신 버전의 API 를 사용한다면 customerIdentityNumber 를 사용하시면 됩니다.
우측에 보시면, API 버전이 명시되어 있고, 해당 버전 이후에는 이 파라미터를 쓰면 된다 라고 이해해주시면 됩니다.

❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
설명 감사합니다.
현금영수증 발급 요청 API 를 호출해야만 현금영수증 발급이 되는게 맞을까요~? 결제요청만 해도 현금영수증 url이 response 결과에 포함이 되어 여쭤봅니다~!
이는 상점 계약 상태에 따라 달라집니다.
현금영수증 자동발급 상태면 별도 발급 요청이 없어도 토스페이먼츠가 대신 발급하므로 현금영수증 API 호출이 없어도 됩니다.
이와 관련한 내용은 1544-7772 또는 홈페이지 채널톡을 통해서, 현재 상점의 현금영수증 발급 설정 확인 요청 하시고, 어떤 옵션이 있는지 문의하셔서 운영하시면 됩니다.
감사합니다!
토스 결제창(최신버전으로)을 가상계좌 연동을 하고 있습니다. 현금영수증 발급을 위해 customerIdentityNumber 필수 파라미터로 보내야 하는데 customerIdentityNumber 값은 제가 언제 어디서 확인을 해야 하는건가요??
다른 곳에서 답변 드렸습니다
다른 곳 어디 있나요
멘션 드렸습니다
멘션 받으면 빨간 숫자 1이 뜰텐데요
보이시나요?
확인 되셨을까요?
확인해보겠습니다