QA 진행하기

프로모션 연동을 마쳤다면 아래 항목을 꼼꼼히 점검해 주세요.

항목	내용
사전 체크	계약/정산 승인, 비즈 월렛 잔액, 프로모션 승인/활성, mTLS 적용, 테스트 계정 준비(x-toss-user-key 전달) 여부를 확인해주세요.
정상 지급 플로우	get-key → execute-promotion → execution-result 순서로 호출해 최종 SUCCESS가 되는지 확인해주세요.
혜택탭 노출	미션명이 12자 이내 “~하기” 형식인지, 지급 금액/이동 URL이 정확히 노출·동작하는지 확인해주세요.
중복 지급 방지	빠른 연속 클릭/새로고침에도 1회만 지급되고 나머지는 차단/무시되는지 확인해주세요.
KEY 유효시간	KEY(1시간 유효) 만료되면 다시 재시도해주세요.
사용자 식별 헤더	x-toss-user-key 누락/변조 시 권한 오류 처리와 로그인/재시도 안내가 노출되는지 확인해주세요.
예산 소진	예산 초과 시 지급이 차단되고 안내 문구 및 혜택탭 미노출이 적용되는지 확인해주세요.
종료일 경과	종료일 이후 지급이 차단되고 종료 안내가 노출되는지 확인해주세요.
한도 정책	1회/일일 한도 초과 시 차단 및 안내가 동작하는지 확인해주세요.
코드/KEY 오류	잘못된 promotionCode/위·변조된 KEY 사용 시 실패 처리 및 재시도 안내가 노출되는지 확인해주세요.
네트워크/타임아웃	실패 시 지수 백오프로 재시도하고 중복 지급 없이 복구 후 성공하는지 확인해주세요.
서버 장애 대응	5xx/에러코드 발생 시 안전한 사용자 안내 및 자동 재시도 또는 “나중에 받기” 흐름이 제공되는지 확인해주세요.
로깅/대사	userKey/promotionCode/amount/txId/status 등 필수 필드가 로그에 남고 대사가 가능한지 확인해주세요.
동시성 제어	멀티탭/다중 클릭 동시 호출에도 단 1건만 유효 처리되는지 확인해주세요.