프로모션 API(execute-promotion) 간헐적 비정상 응답 문의

개발
1

이 글의 성격은 무엇인가요?

질문 / 문제 해결

내용을 설명해주세요

발생 일시

2026-02-23 (일) 20:11 ~ 20:23 KST (약 12분간)

현상

/api-partner/v1/apps-in-toss/promotion/execute-promotion 호출 시 JSON이 아닌 응답이 간헐적으로 반환되었습니다.

  • Cloudflare Workers에서 mTLS 인증서를 통해 호출
  • response.text()로 읽은 뒤 JSON.parse() 시 실패
  • 같은 시간대에 성공(58건)과 실패(8건)가 혼재
  • 실패 건은 모두 JSON 파싱 에러 (응답 본문이 JSON이 아님)

영향

  • 실패 건수: 8건
  • 영향 유저: 6명
  • 기회(used_count)는 정상 차감되었으나 포인트 미지급 발생
  • 수동으로 전량 재지급 완료

문의 사항

  1. 해당 시간대에 프로모션 API 서버 쪽에서 장애나 배포가 있었는지 확인 부탁드립니다.
  2. JSON이 아닌 응답이 반환될 수 있는 경우가 문서에 명시되어 있는지 궁금합니다. (502/503 HTML 에러 페이지 등)
  3. 이런 간헐적 에러에 대한 권장 재시도 정책이 있는지 알고 싶습니다. (현재 최대 2회 재시도, 1초/2초 간격으로 자체 구현했습니다)

appName (선택)

todays-fortune-cookie

이미지 첨부

스크린샷 2026-02-23 오후 9.21.20.png
스크린샷 2026-02-23 오후 9.21.20.png834×194 7.62 KB

2

안녕하세요

  1. 말씀해주신 정보로 확인 결과 총 47건 응답확인 되었으며, 모두 정상적으로 응답이 나간 것 으로 확인되었습니다.

기간 : 2026-02-23 (일) 20:11 ~ 20:23 KST (약 12분간)
대상 : /api-partner/v1/apps-in-toss/promotion/execute-promotion
건수 : 47건

  1. 현재는 Response 에 정의된 상태 이외의 응답은 내려가지 않습니다.(Json인 응답으로 반환되며, 이외의 정의는 없습니다.)

정상응답을 수신하시지 못하신 케이스에 대해 일단 해당 현상이 재현되는지, 재현된다면 응답에 대한 로깅을 통하여 Client Side 에서 원인 분석이 필요할것 같습니다.

가능하시다면 해당 케이스에 대해 로깅을 추가하여 어떤 응답인지, statusCode는 무엇인지 응답해더는 무엇인지 알수 있을까요?

  1. 권장하는 재시도 정책은 존재하지 않습니다만은 (현재 최대 2회 재시도, 1초/2초 간격으로 자체 구현했습니다) 정도로 충분하실것 같고, 필요하다면, 실패건에 대해서 일괄 배치 처리 로직이 있다면 더 좋을 것 같습니다.
    => 저희측의 문제로 인한 것 혹은 사용중이신 SaaS 업체의 문제로 인한 것이든 각 문제는 재발 가능할것이라 제안드려 봅니다.

감사합니다.

3

안녕하세요, 답변 감사합니다.

말씀해주신 대로 statusCode와 응답 본문을 로깅하고 있었는데, 2026-03-03(월)에
동일한 패턴의 장애가 재발하여 공유드립니다.

발생 일시: 2026-03-03 (월) 14:20 ~ 14:28 KST (약 8분간)

현상:

  • get-key 호출 시 HTTP 520 응답 수신
  • 같은 시간대에 성공 68건 / 실패 9건 혼재 (2/23 장애와 동일한 패턴)
  • 자동 재시도(최대 2회, 1초/2초 간격)도 모두 실패

로깅된 에러 상세:
HTTP 520
headers: [cache-control: private, max-age=0, no-store, no-cache,
must-revalidate, post-check=0, pre-check=0, content-length: 15, content-type:
text/plain; charset=UTF-8, server: cloudflare, x-frame-options: SAMEORIGIN]
body: error code: 520

응답의 server: cloudflare 헤더와 error code: 520 본문으로 보아, 토스 API 앞단 Cloudflare에서 원본 서버의 응답을 정상적으로 수신하지 못해 발생한 에러로 보입니다.

2/23에는 HTTP 상태 코드를 로깅하지 않아 JSON 파싱 실패로만 확인되었는데, 이후 상태 코드 로깅을 추가한 결과 이번에는 HTTP 520임을 확인했습니다. 2/23 건도 동일한 520 에러였을 가능성이 높다고 판단하고 있습니다. 혹시 특정
서버 인스턴스의 간헐적 불안정 가능성이 있는지 확인 부탁드립니다.

감사합니다.

4

안녕하세요 :slight_smile:
해당 시간대의 응답은 모두 200으로 준 것으로 확인하였습니다 :cry:
혹시 중간 레이어로 cf worker를 쓰시거나 하는게 있을까요 ? 앱인토스 서버측으로 부터 보낸 에러가 아닌 것 같아 확인을 부탁드려도될까요 ?

5

확인 감사합니다. 네, 중간에 Cloudflare Worker를 mTLS 프록시로 사용하고 있습니다. (env.TOSS_CERT.fetch()를 통해 mTLS 인증서 바인딩으로 호출)

토스 서버 쪽에서 모두 200을 응답해주셨다면, Worker의 mTLS fetch 과정에서 응답 수신 시 문제가 발생하여 Cloudflare가 520을 생성한 것으로 보입니다. 저희 쪽에서 Cloudflare Worker 로그를 추가로 확인해보겠습니다. 혼란을 드려 죄송합니다.

1개의 좋아요