안녕하세요 가상계좌 연동 테스트 중 궁금한 부분 질문드립니다
1. 개발자 센터에서 가상계좌 테스트는 정상 승인 건에 대해서만 가능한지요?
혹 사용자가 금액을 잘못 입금한 경우나 기타 오류 사항에 대한 테스트도 진행해볼수 있을까요?
2. 가상계좌 방식으로 구매시 입금 완료 후 현금영수증 처리는 입력한 정보로 자동으로 처리되는걸까요?
현금영수증 발급 요청, 현금영수증 발급 취소 요청 에 대한 API 문서가 따로 있어서 혹 입금 처리 후 현금영수증 처리는 별도로 진행되는건지 문의드립니다.
3. 가상계좌 취소에 대한 문의입니다,
3-1. 가상계좌 취소 처리시에는 취소 api를 통해 환불 계좌 정보를 전달해야하는것으로 이해했습니다.
환불 계좌 정보를 가상계좌 주문 시점에 입력 받을수 있는 방법도 있을까요?
3-2. 환불 계좌 정보에 대한 유효성 검사가 이뤄집니다. 라는 내용 확인했는데요.
유효성 검사에 실패했을때 발생할수있는 상황도 궁금합니다.
3-3. 현금영수증 취소 처리에 대해서도 궁금합니다. 관련내용 답변 부탁드립니다! 감사합니다 🙂
3-3. 현금영수증 취소 처리에 대해서도 궁금합니다. 관련내용 답변 부탁드립니다! 감사합니다 🙂
13 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
1. 금액불일치시에 대한 입금통보 테스트는 지원되지 않습니다.
또한 운영환경에서도 금액불일치시에는 입금처리가 되지 않습니다 (수취조회시 과오납체크에 걸림) . 입금이 되지 않기 때문에 입금통보도 되지 않습니다.
2. 결제창에서 현금영수증을 신청시 입금과 동시에 토스페이먼츠에서 자동발급 처리 합니다.
현금영수증 API는 , PG를 통하지 않은 결제 (ex: 상점 계좌 직접입금 결제 또는 상점 자체 포인트 결제) 등에 대해 현금영수증 발급이 필요할 경우 현금영수증만 단독으로 발행가능하도록 API를 제공하고 있습니다.
3-1. 자체적으로 구현해주시면 될듯 합니다. 주문서 작성페이지에서 가상계좌 선택시 환불계좌를 미리 받아 놓으셨다가, 이후 구매자가 입금후 취소요청시 저장한 환불계좌를 불러오는 방식으로 연동하시면 될듯 합니다.
3-2. 가상계좌 환불시 입력한 계좌가 잘못되거나 입력한 예금주와 실제예금주 불일치시 환불실패로 응답합니다.
3-3 동일하기 취소 API를 이용하면 됩니다.
답변 감사드립니다!
답변 주신 내용 중 추가로 궁금한 부분이 있습니다
1. 또한 운영환경에서도 금액불일치시에는 입금처리가 되지 않습니다 (수취조회시 과오납체크에 걸림) . 입금이 되지 않기 때문에 입금통보도 되지 않습니다.
--> 그럼 가상계좌 방법으로 결제시 고객측 휴먼에러로 인한 이슈를 발생하지 않을까요?
3-2. 가상계좌 환불시 입력한 계좌가 잘못되거나 입력한 예금주와 실제예금주 불일치시 환불실패로 응답합니다.
--> 환불 실패 응답은 취소 요청 후 바로 피드백이 오나요?
3-3. paymeny_key 기준으로 취소 처리진행하는 아래 API 를 사용하면 결제 취소 현금 영수증 취소 모두 진행되는게 맞는지 문의드립니다!
https://api.tosspayments.com/v1/payments/{paymenykey}/cancel
1. 휴먼에러로 인한 이슈는 고객입 입금하면서 발생하므로 PG 에서는 알수가 없습니다. 보통 입금이 되지 않는다고 문의가 들어올겁니다.
3-2. 취소 API 에 대한 응답으로 바로 에러를 받으실수 있습니다. 만약 취소시에는 문제가 없었는데, 실제 입금하다가 문제가 발생한 경우는 별도로 저희가 상점쪽에 메일로 알려드리고 가이드를 드리고 있습니다(고객의 다른환불계좌를 확인해서 저희쪽에 알려주시면 됩니다)
3-3. 가상계좌 발급시에 현금영수증 발급을 같이 하셨다면 취소 API 를 이용하면 같이 취소 됩니다.
만일 현금영수증 API를 통해 발급한 건을 취소하고자 한다면,
현금영수증발급취소요청 API를 이용하시면 됩니다.
https://docs.tosspayments.com/reference#현금영수증-발급-취소-요청
코어 API | 토스페이먼츠 개발자센터
토스페이먼츠 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
답변 감사합니다!
그럼 가상계좌 가 주문발생만하고 미입금된 상태로 입금기한이 지났을때는 취소처리가 될까요? 아니면 미입금 상태로 유지될까요?
만약 토스에서 내려주는 상태가 바뀐다면 저희가 바뀐 상태를 인지할수있을까요?
입금기한이 지날경우, 자동취소가 되거나 상태가 변경되지는 않습니다. (입금대기상태), 상태변경이 되지 않기 때문에 별도의 웹훅전송도 발생하지 않습니다.
다만 구매자는 입금기한이 지난 가상계좌에 입금이 불가합니다.
https://docs.tosspayments.com/guides/learn/virtual-account-webhook#발급된-가상계좌의-상태-변화
가상계좌 웹훅 연동하기 | 토스페이먼츠 개발자센터
가상계좌를 연동한 뒤 웹훅으로 입금 알림을 받을 수 있는 방법을 알아봅니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
답변 감사합니다:)
엇! 추가로 가상계좌 환불 관련해 문의드리고 싶습니다
유효한 계좌로 결제 취소 요청이 되었다면 환불은 취소 요청 후 2일 후에 진행됩니다.
테스트로진행한 결제 취소 진행시
"status": "CANCELED", 로 바로 확인되는데요
고객의 계좌에 입금 완료와 관계없이 바로 취소처리될까요?
취소 API에서 status 는 CANCELED로 확인되고 있으나
refundStatus 는 NONE 인 이유도 궁금합니다.
"status": "CANCELED",
"requestedAt": "2023-08-11T10:44:37+09:00",
"approvedAt": "2023-08-14T08:41:23+09:00",
"useEscrow": false,
"cultureExpense": false,
"card": null,
"virtualAccount": {
"accountNumber": "X6516136518161",
"accountType": "일반",
"bank": "우리",
"bankCode": "20",
"customerName": "가상계좌",
"dueDate": "2023-08-18T10:44:37+09:00",
"expired": true,
"settlementStatus": "INCOMPLETED",
"refundStatus": "NONE",
"refundReceiveAccount": null
},
테스트 환경 이신것 같은데요.
결제 취소 요청이 정상 처리되면 CANCELED 로 전환 되고
https://docs.tosspayments.com/reference#paymentdetaildto-virtualaccountrefundstatus
이곳에 설명되어 있는대로, 실제 운영환경에서 처리 과정을 조회 하실 수 있다 라고 이해해 해주시면 됩니다.
코어 API | 토스페이먼츠 개발자센터
토스페이먼츠 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.
결제 상태가 취소로 전화되는 것과
고객이 돈을 받는것은 다른 프로세스다 라고 이해해 주시면 됩니다.
네! 감사합니다 그런데 거래영수증을 조회하려고 하니
필수 파라미터가 누락되었습니다. (transactionId) 라고 하는데요
테스트 건이라 그런걸까요/
네 맞습니다. 라이브 환경에서만 영수증 확인가능합니다.