멱등성

어떤 문제를 줄여주나요?

서버가 취소 요청을 처리했는데 네트워크 문제로 응답만 못 받을 수 있어요. 이때 새 요청으로 보내면 다른 취소로 처리될 위험이 있어요. 멱등키는 PG가 같은 작업임을 알아볼 수 있도록 하는 식별값이에요.

재시도 예시

한 주문에서 1만원을 부분 취소하는 작업에 키 A를 붙였다고 가정해 볼게요. 응답을 받지 못해 같은 작업을 다시 요청한다면 지원 정책에 따라 같은 키 A와 같은 내용을 사용해요. 이후 별도로 5천원을 더 환불하는 작업에는 새 키를 써야 해요.

주문번호와의 차이

주문번호는 주문을 구분하고, 멱등키는 한 번 실행하려는 작업을 구분해요. 한 주문에서 서로 다른 부분 취소가 여러 번 생길 수 있으므로 두 값을 무조건 같은 것으로 만들면 안 돼요.

멱등키만 넣으면 항상 안전한가요?

PG가 지원하는 API·기간 안에서 같은 요청을 보낼 때의 보장이에요. 키 유효기간이 지난 요청이나 본문이 달라진 요청은 해당 문서의 처리 규칙을 확인하세요. 가맹점 서버에서도 작업 기록과 중복 출고 방지가 필요해요.