가상계좌 부분취소/전체 취소 응답
가상계좌를 발급 후 정상 입금이 이루어진 후에 부분 취소나 전체 취소를 할 때 응답값(메뉴얼에 있는 응답)을 보니까
paymentKey값이 취소 url 호출할 때 전송하는 paymentKey와 응답의 paymentKey가 다르던데 최초 정상 결제한 값과 비교할 수 있는 값은 전달이 안 되는건가요?
30 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
paymentKey 는 변경되지 않습니다. 참고하신 부분을 스크린샷으로 올려주실 수 있을실까요?

응답에 있는 paymentKey 값이 요청에 넣은 값과 다르게 예시가 되어 있습니다
그렇군요
실제로는 같은 값이 내려갑니다
네 감사합니다
한 가지 더 질문 드립니다.
응답에 있는 주문 번호(orderId)는 상점, 즉 저희가 보낸 값인가요? 원 주문번호에 o-를 붙여서 토스에서 보내는 값인가요? 주문번호 취소를 요청할 때는 주문번호를 보내지 않습니다만.....
네 가맹점에서 결제시에 보내신 값입니다.
저희가 결제 취소나 부분 취소할 경우에 마이너스 매출을 등록을 하고 싶은데, 가상 계좌를 발급받지 않고 환불 받을 사람의 계좌 정보를 입력할 수도 있나요?
토스 결제 관리 목록을 보니 마이너스 금액으로 입력이 되던데요
가상계좌를 발급받지 않고 환불받을 사람의 계좌 정보를...
입력하실 수 있는 퍼널이 없으실거에요 API로도 없구요
환불계좌정보는 환불시에만 전달주셔야 합니다.
직접 관리하시는 방법은 있습니다.
가상계좌 발급시에 환불계좌를 함께 받으셔서 자체 관리를 하시면 되는데요
이경우에는 유효성 체크를 별도로 하셔야해요
환불시에는 토스페이 결제 목록에 마이너스로 입력 되고 있던데, 테스트 결제 목록에는 부분취소로 상태만 변경이 되던데 다른건가요?
토스페이 결제목록에 마이너스는 발생했던 금액만큼 표시된걸 말씀주신거죠?
네
취소시에 표기만 그렇게 되는것이에요, 보신 화면은 상점관리자일까요?
네..저희 회사에서 여려 계정으로 토스페이를 사용하고 있습니다
마이너스라고 표기되는 내용은 카드결제도 동일합니다.
마이너스 매출이라기보다는 원거래가 취소되었음을 알려드리고 있어요
아..그럼 테스트 결제 목록과 실제 운영 목록이 다르시다는 말씀으로 이해하면 되나요?
테스트결제는 테스트키로 진행하신 내용일까요?
네
테스트키로 진행하신 내용은 라이브 상점관리자에 표시가 되지 않고있어요
별도의 테스트 결제내역 페이지에서 확인 가능합니다.
아..네 그건 알고 있습니다.
실제 운영되는 결제 내역 화면이, 테스트에서 제공하는 화면과 달라서 질문드리는 겁니다
넵 맞습니다. 테스트 제공화면과 운영에서 제공되는 화면이 별개이고 완전 다릅니다
아..네 답변 감사합니다
넵, 좋은 서비스 만드시길바랍니다.
👍
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
아..질문 하나만 더 하겠습니다.
취소 요청 보낼 때 header 값 중에 Idempotency-Key 이런 것이 있는데 취소 api 실행할 때는 나오지는 않습니다.
이 파라미터는 무엇인가요?
멱등키 값 헤더입니다.
https://discord.com/channels/864296203746803753/877547393938251848/1044791354800210050
https://docs.tosspayments.com/reference/using-api/idempotency-key
멱등키 | 토스페이먼츠 개발자센터
멱등키를 사용해서 중복 요청을 방지하고 안전하게 API 요청을 보내는 방법을 알아봅니다. 멱등키를 사용하면 민감한 API 요청이 반복적으로 일어나는 문제를 막을 수 있고, 네트워크 이슈나 타임아웃 문제로 응답을 받지 못했을 때도 안전하게 같은 요청을 다시 보낼 수 있습니다.
멱등성 로직을 구현하실때 필요하신 값인데요
필수값은 아닙니다.(빼고 사용하셔도 되요)
자세한 내용은 여기에서 확인가능하십니다.
https://docs.tosspayments.com/reference/using-api/idempotency-key
멱등키 | 토스페이먼츠 개발자센터
멱등키를 사용해서 중복 요청을 방지하고 안전하게 API 요청을 보내는 방법을 알아봅니다. 멱등키를 사용하면 민감한 API 요청이 반복적으로 일어나는 문제를 막을 수 있고, 네트워크 이슈나 타임아웃 문제로 응답을 받지 못했을 때도 안전하게 같은 요청을 다시 보낼 수 있습니다.
취소 API를 운영하실때 사용될 수 있는데요
부분취소가 여러번 발생할 수 있는 상황에 멱등키를 넣으셔서
각 부분취소를 구분하고 중복으로 처리되지 않게 막는 용도로 사용가능합니다.
아..멱등키 내용은 읽어 보았는데 그렇게 사용하면 되는건 생각을 못했습니다.
감사합니다.