부분환불 요청 시 중복 처리 방지 관련 문의
안녕하세요.
저희는 귀사의 결제모듈을 사용하는 홈페이지를 운영 중입니다.
최근 부분환불 처리 과정에서 중복 환불이 발생하는 장애가 있어 문의드립니다.
[장애 발생 개요]
사용자가 부분환불 요청을 1회만 수행했음에도 불구하고, 환불 요청이 0.0005초 간격으로 2회 전송되어, 실제로 부분환불이 두 번 이루어진 상황이 발생했습니다.
원인 분석 결과, WAS 서버 1회, 캐시 서버 1회로 총 두 번 환불 요청이 처리되었습니다.
이로 인해 동일한 거래에 대해 이중 환불이 발생하여 정산에 문제가 생겼습니다.
[현재 운영 환경]
웹 서버 구조: WAS 서버 + 캐시 서버 병행 사용
부분환불 요청은 서버 사이드에서 API 호출로 이루어짐
동일 요청이 병렬 혹은 중복으로 발생할 가능성 있음
[문의사항]
토스페이먼츠 API에서 동일 거래에 대한 중복 환불 요청을 자동으로 차단하는 기능이 있는지 확인 부탁드립니다.
중복 처리를 방지할 수 있는 권장 구현 방식이나 가이드가 있다면 공유 부탁드립니다.
요청 중복에 대한 재처리 방지 키(idempotency key)나 고유 요청 ID를 지정하는 방식이 API에서 지원되는지 확인 부탁드립니다.
향후 동일 문제가 재발하지 않도록 조치가 필요한 상황이므로,
토스페이먼츠 측의 기술적 대응 방안 또는 우회 가능한 구현 가이드를 꼭 부탁드립니다.
감사합니다.
저희는 귀사의 결제모듈을 사용하는 홈페이지를 운영 중입니다.
최근 부분환불 처리 과정에서 중복 환불이 발생하는 장애가 있어 문의드립니다.
[장애 발생 개요]
사용자가 부분환불 요청을 1회만 수행했음에도 불구하고, 환불 요청이 0.0005초 간격으로 2회 전송되어, 실제로 부분환불이 두 번 이루어진 상황이 발생했습니다.
원인 분석 결과, WAS 서버 1회, 캐시 서버 1회로 총 두 번 환불 요청이 처리되었습니다.
이로 인해 동일한 거래에 대해 이중 환불이 발생하여 정산에 문제가 생겼습니다.
[현재 운영 환경]
웹 서버 구조: WAS 서버 + 캐시 서버 병행 사용
부분환불 요청은 서버 사이드에서 API 호출로 이루어짐
동일 요청이 병렬 혹은 중복으로 발생할 가능성 있음
[문의사항]
토스페이먼츠 API에서 동일 거래에 대한 중복 환불 요청을 자동으로 차단하는 기능이 있는지 확인 부탁드립니다.
중복 처리를 방지할 수 있는 권장 구현 방식이나 가이드가 있다면 공유 부탁드립니다.
요청 중복에 대한 재처리 방지 키(idempotency key)나 고유 요청 ID를 지정하는 방식이 API에서 지원되는지 확인 부탁드립니다.
향후 동일 문제가 재발하지 않도록 조치가 필요한 상황이므로,
토스페이먼츠 측의 기술적 대응 방안 또는 우회 가능한 구현 가이드를 꼭 부탁드립니다.
감사합니다.
