😄Q402 결제 실패, 어디서 막혔는지 구분하는 법

AI 에이전트가 결제에 실패했다고 해서 전부 같은 문제는 아님

Q402에서는 결제가 막히는 원인과 처리 단계에 따라 대응 방법이 달라짐

🔴 주요 케이스 정리
1. 로컬 제한에 걸린 경우
: 결제 금액 한도, 수신 주소 허용 목록 등 로컬 설정에서 차단

2. 사용자 승인 필요
: 결제 미리보기를 사용자에게 보여주고 명시적인 승인 후 재요청해야 함

3. 샌드박스 모드
: 실제 결제 없이 가짜 txHash가 반환될 수 있음. txHash만 보고 결제 성공으로 판단하면 안 됨

4. 정책 엔진에서 차단
: 수신 주소 제한, 거래 가능 시간, 지출 한도, 별도 승인 요건 등에 따라 릴레이 단계에서 거절

5. 정산 단계에서 차단
: 수신 에이전트 정보가 일치하지 않거나, 설정한 가격·시간 조건이 충족되지 않은 경우

6. 실패가 아닌 응답
: 네트워크 타임아웃, 처리 대기, 일부 결제만 완료된 경우는 실제 실패와 구분해야 함

「 출처 」