# 콜백 실패 문제 해결

> Offerwall 보상에 대한 Offerwall 콜백 실패 문제 해결 가이드를 검토하십시오.

콜백 실패가 증가하거나 사용자가 Offerwall 보상을 받지 않는 경우, 이 문제는 종종 엔드포인트 설정, 네트워크 접근성, 페이로드 처리, HTTP 메서드 불일치와 관련이 있습니다.
다음 문제 해결 가이드를 검토하여 오류의 근본 원인을 식별 결정.

## 콜백 URL 및 메서드 설정 확인##verify-callback-url-and-method-configuration

콜백 실패의 가장 일반적인 원인은 잘못된 URL이거나 요청이 서버에서 예상하는 방식과 일치하지 않는 것입니다. 다음 사항을 확인하려면 대시보드 설정을 확인하십시오.

* **활성 URL**: 유효한 콜백 URL이 구성되어 실수로 제거되거나 `NO_CALLBACK`로 설정되지 않았는지 확인합니다.
* **HTTP 메서드(GET 대 POST)**: 콜백 GET(기본값) 또는 POST 요청으로 전송되도록 설정되어 있는지 확인합니다.
  * GET 또는 POST 중 하나로 구성된 경우, 선택한 메서드를 수신하고 올바르게 파싱 엔드포인트가 명시적으로 구성되었는지 확인합니다.
  * POST로 구성된 경우 서버가 요청 바디 올바르게 읽고 있는지 확인합니다.
* **형식**: URL에 유효한 체계(`https://`), 호스트 및 경로가 없거나 잘못된 형식의쿼리 문자열이 있는지 확인합니다.
* **환경**: 스테이징 또는 테스트 엔드포인트가 아닌 프로덕션 환경 대한 URL 포인트를 확인합니다.
* **파라미터**: 모든 필수 파라미터와 매크로가 URL 구조, 구조체 있는지 확인합니다.

## 네트워크, 전송 및 보안 규칙 확인##check-network-transport-and-security-rules

Offerwall 서버가 엔드포인트에 도달률 수 없는 경우 콜백이 실패할 수 있습니다. 서버 및 네트워크 상태를 확인하여 다음 사항을 확인하십시오.

* **방화벽 및 WAF**: 웹 애플리케이션 방화벽(WAF) 또는 보안 설정을 확인합니다. Offerwall 콜백 IP 주소가 allowlist에 등록되어 있고 트래픽 실수로 차단되지 않았는지 확인합니다.
* **인증서**: 엔드포인트에 유효하고 만료되지 않은 SSL/TLS 인증서 제공되는지 확인합니다.
* **시간 초과 및 도달 가능성**: DNS 해상도 오류, 연결 시간 초과 또는 간헐적인 엔드포인트 유효성 확인
* **속도 제한**: 속도 제한이 활성화되어 있는 경우, 사용 가능한 영역이 큰 콜백이 트리거 블록인지 확인합니다. 서버가 갑작스러운 트래픽 스파이크를 처리할 수 있는지 확인합니다.

## HTTP 리스폰스 코드 분석##analyze-http-response-codes

Offerwall은 200의 OK 응답을 예상합니다. 서버가 다른 HTTP 상태 코드를 반환하면 장애가 기록되고 재시도 가능합니다. 서버 로그에 다음과 같은 일반적인 오류 코드가 있는지 확인합니다.

* **3xx (다이렉트)**: 리디렉션을 피합니다. 마이그레이션은 Offerwall 대시보드에서 바로 업데이트되어야 합니다. 콜백 송신기는 예기치 않게 리디렉션되면 페이로드를 끌 수 있습니다.
* **400(잘못된 요청)**: 잘못된 형식의 요청을 나타냅니다. 파라미터 누락, 형식 불일치 또는 잘못된 데이터 유형으로 인해 서버가 페이로드를 거부하는지 확인합니다.
* **401/403(인증 안 함/차단됨)**: 인증 실패를 나타냅니다. 인증 토큰, 서명 또는 IP allowlist가 최신 상태인지 확인합니다. 최근에 비밀을 변경한 경우 Offerwall이 업데이트되었는지 확인합니다.
* **404 (찾을 수 없음)**: 엔드포인트 경로 올바르지 않거나 삭제되었습니다. 콜백 URL을 업데이트하지 않고 최근에 서버 마이그레이션이 수행되었는지 확인합니다.
* **405 (메서드 허용 안 함)**: 서버가 HTTP 메서드를 거부하고 있습니다. 이는 거의 항상 콜백 POST로 전송되지만 서버가 GET을 예상하거나 그 반대일 때 발생합니다.
* **409( 충돌)**: 종종 중복된 거래 거부 로직으로 인해 발생합니다. 이드포텐시 로직이 너무 적극적이지 않도록 합니다(예: 유효한 재시도 거부).
* **429(요청이 너무 많음)**: 서버가 Offerwall을 조절하고 있습니다. 속도 제한을 조정하여 트래픽 폭발을 수용하십시오.
* **5xx(서버 오류)**: 서버의 백엔드 불안정성, 서비스 다운타임 또는 애플리케이션 크래시를 나타냅니다.

## 페이로드 및 파라미터 무결성 검증##validate-payload-and-parameter-integrity

콜백이 서버에 도달하지만 사용자가 여전히 보상형 광고 받지 않는 경우 서버가 콜백 콘텐츠 거부할 수 있습니다.

* **서명 일치**: 서명 인증 필요한 경우 해싱 로직이 Offerwall의 예상 포맷과 일치하는지 확인합니다.
* **매크로 해상도**: 사용자 ID, 거래 ID 및 보상 금액이 올바르게 해석되고 문자열로 처리되지 않는지 확인합니다(예: 실제 사용자 ID 대신 `[USER_ID]` 읽기).
* **다운스트림 처리**: 200 OK를 반환했지만 유저는 보상이 없는 상태로 남아 있으면 다운스트림 프로세싱을 조사하십시오. 콜백 확인이 실제 사용자 보상 이벤트와 일치하는지 확인합니다.

## 최근 변경 사항 검토##review-recent-changes

콜백 오류가 갑자기 발생하면 내부 엔지니어링 로그와 비교하여 오류의 정확한 시간을 크로스 레퍼런스합니다. 다음 질문을 고려하십시오.

* 최근에 제품 릴리스나 설정 업데이트를 푸시?
* 서버 비밀 또는 인증 토큰을 교환했나요?
* 엔드포인트를 마이그레이션하거나 서버 인프라를 업데이트하거나 허용되는 HTTP 메서드를 변경하셨습니까?

## 추가 지원##additional-support

이전의 모든 문제 해결 가이드를 확인했지만 콜백 실패가 계속 발생하는 경우 세일즈 담당자 지원 담당자에게 문의하여 다음 정보를 제공하십시오.

* 오류에 영향을 받는 특정 앱 ID
* 실패가 관찰된 정확한 시간
* 실패한 사용자 ID 또는 거래 ID 샘플링
* 오류 중에 캡처된 모든 관련 서버 로그 또는 HTTP 응답 본문