멱등 요청 관련 문의
안녕하세요. 멱등 요청 관련하여 문의드립니다.
현재 상점 백엔드에서 토스페이먼츠로 api 요청할 때 POST 메서드의 경우 문서(https://docs.tosspayments.com/reference/using-api/idempotency-key) 가이드에 따라 요청 헤더에 멱등키를 추가하여 보내고 있습니다. 멱등키의 경우 nanoid를 사용하여 300자를 넘지 않는 충분히 무작위적인 고유 값으로 생성하고 있으며, 15일 주기로 갱신되도록 구현해놨습니다.
이런 환경에서 같은 결제 건에 대해서 결제 승인 api를 멱등 요청 테스트를 진행해봤습니다. 테스트 결과 문서에 나와있는대로 같은 요청이 여러번 일어났으나 실제로 요청이 이루어지지 않고 첫 번째 요청 응답과 같은 응답을 받았습니다. 다만, 이후 다른 결제 건에 대해 정상적인 결제 승인 api 요청을 보냈으나, 해당 결제 건 또한 멱등 요청으로 인식되어 요청이 이루어지지 않음을 확인했습니다. 이에 대해 문서를 찾아보니 멱등키와 API 키, API 주소, HTTP 메서드 조합 기반으로 멱등성을 보장한다고 나와 있는데, 결제 승인 api의 경우 다른 결제 건임에도 모든 조합이 같아 멱등 요청으로 인식되는 것 같습니다.
이러한 문제를 해결하기 위해 멱등키를 세팅하는 팁이 있을까요?
멱등키 | 토스페이먼츠 개발자센터
멱등키를 사용해서 중복 요청을 방지하고 안전하게 API 요청을 보내는 방법을 알아봅니다. 멱등키를 사용하면 민감한 API 요청이 반복적으로 일어나는 문제를 막을 수 있고, 네트워크 이슈나 타임아웃 문제로 응답을 받지 못했을 때도 안전하게 같은 요청을 다시 보낼 수 있습니다.
7 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
멱등키와 API 키, API 주소, 메서드를 조합으로 멱등성을 보장 하므로
동일 멱등키로, 결제승인 API 주소에서 수행 되었으니
이해 하신대로, 키가 다르더라도 멱등키로 처음에 수행한 결과가 응답 되는 것이 맞습니다.
매우 단순하게
인증완료 된 이후 응답되는 Key 를 가지고 있으실 것이고,
승인시에 멱등키를 생성하여 승인 API 호출시에 넘기고 있으실 테니,
paymentKey 와 생성되는 멱등키를 1:1 매칭 시키고 새로운 키에서는 새로운 멱등키로서 수행하는 등의 액션을 진행 하시면 될듯 합니다. (이는 당연히 하고 계실듯 합니다)
멱등키를 15일 주기로 갱신하신다는게 잘 이해가 안되는데요.
15일동안 같은 멱등키를 쓰시는건가요?
네, 문서에 다음과 같은 내용이 있어서, 15일 주기로 멱등키를 갱신하면 되는 것으로 이해했습니다.
멱등키는 처음 요청에 사용한 날부터 15일 간 유효합니다. 처음 요청한 날부터 15일이 지났다면 새로운 멱등키로 요청하세요.음.. 이 내용은 토스페이먼츠에서의 멱등성 보장이 15일 이라는 의미이기 때문에
가능하다면 매 요청마다 멱등키를 갱신해서 보내주시는게 좋습니다
아, 이해했습니다. 그러면 매 요청마다 멱등키를 갱신해서 보내보도록 하겠습니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.