구독 결제 실패 자동 재시도 세팅 순서 4단계

Pipedeck 실제 화면

작성자

카테고리:

구독 결제 실패 자동 재시도 설정 방법을 찾는 사람은 대개 같은 순간을 겪었을 것이다. 정기결제 실패 알림이 와 있고, 이번 달 매출이 빠졌고, 고객이 해지 버튼을 누르기 전에 뭔가 해야 한다는 생각만 든다.

나는 AILEEGO라는 이름으로 AI 자동화 서비스를 직접 만들고 굴린다. 정기결제를 처음 붙일 때 떠올린 기본형은 실패 메일 한 통이었다. 실패했다고 알려주면 고객이 알아서 카드를 바꾸겠지 싶었다. 돌아보면 그 구조는 카드를 바꿀 기회를 한 번만 주는 설계였다. 해지가 얼마나 늘었는지는 측정 기준을 세우지 않아서 말할 수 없다.

이 글은 실패 원인 분류, 웹훅 대사, 중복 방지, 재시도 간격, 이용권 상태, 알림 문구를 한 흐름으로 묶는다. 재시도 횟수 하나만 정하면 끝나는 문제가 아니고, 그 횟수를 안전하게 돌리는 장치까지 같이 있어야 한다.

1단계. 실패 코드를 3분류로 나눈다

재시도 전략은 실패 원인에 따라 달라야 한다. 한도 초과와 유효기간 만료를 똑같이 다시 긁으면 같은 거절만 반복되고, 분실 카드로 승인을 계속 시도하는 꼴이 되기도 한다. 결제사마다 코드 이름이 다르다. 아래 표는 Stripe 코드 이름을 예로 든 분류다.

분류 대표 코드 예시 재시도 고객 안내
즉시 재시도 processing_error 같은 일시 장애 짧은 간격으로 한 번 안내 없이 처리, 또 실패하면 간격 재시도로 이동
간격 재시도 insufficient_funds, do_not_honor, card_declined 간격을 두고 여러 번 재시도 예정일과 카드 변경 링크 고지
고객 조치 필요 expired_card, authentication_required, lost_card, stolen_card 자동 재시도 안 함 카드 변경 요청, 분실·도난 코드는 카드 변경만 요청

분류 기준은 코드 이름보다 결제사가 재시도를 허용하느냐다. 이 구분을 뭉뚱그리면 안 된다는 게 분류표를 따로 만든 이유다.

실패 로그를 코드별로 집계해 보려고 했는데, 로그가 아직 충분히 쌓이지 않아 어떤 코드가 많은지 비율은 적지 못하겠다. 집계 쿼리부터 먼저 짜 두는 쪽을 권한다. 비율을 알아야 어떤 분류를 먼저 다듬을지 정해지기 때문이다.

국내 카드는 승인 거절 코드를 PG마다 다르게 돌려준다고 들었다. 같은 한도 초과라도 어떤 PG는 재시도 가능으로, 어떤 곳은 고객 조치로 넘긴다는 얘기다. 나는 아직 실제 응답을 확인하지 않았다. 위 표는 Stripe 기준이니, 쓰는 PG 문서에서 코드별 응답부터 확인하라.

2단계. 웹훅 대사와 중복 방지를 먼저 켠다

재시도 스케줄보다 먼저 만들 것이 두 가지 있다. 웹훅이 빠졌을 때 상태를 맞추는 대사 배치, 그리고 같은 청구가 두 번 나가지 않게 막는 장치다. 재시도 워커를 먼저 붙이면 중복이 나간 뒤에야 막게 된다.

웹훅은 서버 다운, 타임아웃, 서명 검증 실패 때문에 빠질 수 있다. 결제 성공 웹훅이 빠지면 DB에는 여전히 실패로 남고, 재시도가 돌아서 고객에게 또 청구되는 상황이 생긴다. 웹훅을 믿지 말고 조회하라는 말은 맞는데, 실제로는 이렇게 돌린다.

  1. 매일 새벽, 상태가 아직 확정되지 않은 청구 건을 DB에서 뽑는다.
  2. 건마다 결제사 조회 API로 현재 상태를 가져온다.
  3. 결제사 상태와 DB 상태가 다르면 결제사 값을 기준으로 상태를 갱신한다.
  4. 조회가 실패하면 간격을 늘려 다시 조회하고, 계속 실패한 건은 수동 확인 대기열로 넘기면서 알림을 보낸다.

이 배치는 크론으로 돌린다. 지금 서버에는 크론이 70개 돌고 있다(2026년 10월 6일 기준). 실행 시간이 겹치면 같은 건을 두 워커가 동시에 조회할 수 있으니 잠금 처리를 같이 넣어야 한다.

중복 방지는 청구 시도 단위로 멱등성 키를 만드는 데서 시작한다. 상태 전환은 조건부 업데이트로 한 번만 통과시킨다.


# 청구 직전: 대기 상태인 건만 선점한다
row = db.fetchone(
    "UPDATE invoices SET status='charging', attempt_no=attempt_no+1 "
    "WHERE id=%s AND status='retry_pending' AND next_retry_at<=now() "
    "RETURNING attempt_no",
    [invoice_id],
)
if row is None:
    return  # 다른 워커가 먼저 집었거나 상태가 이미 바뀜

idem_key = f"charge:{invoice_id}:{row[0]}"
result = pg.charge(customer_id, amount, idempotency_key=idem_key)

워커가 두 번 떠도 두 번째 워커는 UPDATE 결과가 0건이라 빠진다. 다만 이건 설계 얘기다. 워커를 일부러 두 번 띄워 중복이 막히는지 재현해 본 적은 없다. 결제사 멱등성 키의 보관 기간도 문서마다 달라서 확인이 필요하다.

Pipedeck 실제 화면

3단계. 재시도 간격과 이용권 상태를 정한다

기준안은 최초 실패 뒤 1일, 3일, 5일, 7일 차에 재시도하고, 네 번 모두 실패하면 정지 쪽으로 넘어가는 구성이다. 이 숫자는 측정값이 아니라 출발점이다. 서비스 성격과 고객의 카드 잔액 채움 주기에 맞춰 늘리거나 줄이면 된다. 처음에는 매일 재시도하는 안도 검토했는데, 같은 거절 코드가 반복되면 하루 간격은 의미가 적다고 보고 간격을 벌렸다.


RETRY_POLICY = {
    "insufficient_funds": [1, 3, 5, 7],  # 일 단위 오프셋, 기준안
    "do_not_honor":       [1, 3, 5, 7],
    "processing_error":   [1],           # 시간 단위가 아니라 일 단위로 쓰면 안 됨, 아래 참고
    "expired_card":       [],            # 자동 재시도 없음, 카드 변경 대기
    "lost_card":          [],
    "stolen_card":        [],
}

processing_error만 시간 단위라서 일 단위 배열에 넣으면 틀린 설정이 된다. 실제 코드에서는 단위를 따로 두어야 한다. 나도 이 부분을 한 번 헷갈릴 뻔했다.

재시도 시각은 고객별 가입 시각을 기준으로 조금씩 흩는다. 모든 고객이 같은 시각에 재시도하면 같은 시간대의 승인 문제에 연속으로 걸릴 수 있어서다. 어느 시간대가 승인률이 높은지는 아직 데이터가 없다.

이용권 상태는 네 단계로 나눠 둔다.

상태 전환 조건 고객에게 보이는 화면
전체 이용 첫 실패 후 유예기간 중 이용 가능, 상단 배너로 카드 변경 안내
읽기 전용 유예기간 종료, 재시도 진행 중 조회와 다운로드만 가능, 저장과 생성 차단
신규 기능 차단 재시도 마지막 실패 전 기존 기능만 유지, 신규 기능 잠금 안내
정지 최종 실패 확정 로그인과 결제 화면만 열림, 데이터 보관 안내

유예기간을 길게 잡으면 이탈은 줄지만 미수금이 쌓인다. 짧게 잡으면 고객이 갑자기 막혔다고 느낀다. 나는 월결제와 연간결제의 유예기간을 다르게 두는 쪽으로 생각했다. 연간결제는 한 해 치를 이미 받은 상태에서 갱신만 실패한 경우라서 제한을 늦추는 쪽이 자연스럽다고 판단했다. 다만 이 기준이 고객 반응을 실제로 줄였는지는 검증하지 못했다. 정지 후 데이터 보관 기간은 약관 문구와 맞춰야 하니 숫자는 약관에서 정하라.

Pipedeck 실제 화면

4단계. 알림은 단계마다 한 번만 보낸다

알림은 세 번 나간다. 문구는 아래처럼 시작해 보라. 중괄호 부분만 채우면 된다.

1차(실패 직후): {서비스명}입니다. {결제일} 정기결제가 카드사에서 거절되었습니다(사유: {사유 안내}). 카드 정보를 바꾸시면 바로 다시 결제합니다. 카드 변경하기: {링크}

2차(재시도 예정): {서비스명}입니다. 아직 결제가 완료되지 않았습니다. {재시도 예정일}에 자동으로 한 번 더 결제를 시도합니다. 그 전에 카드를 바꿔 두시면 이용에는 영향이 없습니다. 카드 변경하기: {링크}

최종(정지 예고): {서비스명}입니다. 여러 차례 결제를 시도했지만 완료되지 않아 {정지일}부터 이용이 제한됩니다. 데이터는 {보관 기한}까지 보관합니다. 카드를 등록하시면 바로 복구됩니다. 카드 등록하기: {링크}

알림은 청구 건과 단계 조합을 키로 잡아 한 번만 나가게 한다. 재시도가 돌 때마다 같은 메일이 다시 나가면 고객은 스팸처럼 받아들인다. 문구를 바꾼 뒤 카드 변경 클릭이 늘었는지 확인하려면 클릭 이벤트를 따로 저장해야 한다. 지금은 그 저장이 없어서 문구 전후를 비교할 데이터가 없다.

이 방식이 맞지 않는 경우와 아직 못 막는 것

  • 약관에 재시도 횟수와 정지 고지 기간이 없다면 정지 자동화부터 멈추고 약관을 먼저 고쳐야 한다. 고지 의무가 어디까지인지는 법률 자문으로 확인할 일이다.
  • 해외 카드 비중이 높은 서비스는 인증 요구 코드가 많이 나와서 고객 조치 분류가 대부분을 차지할 수 있다. 그러면 자동 재시도 효과가 국내 카드보다 작다. 우리 고객의 카드 구성은 아직 집계하지 않았다.
  • 결제사 측에서 생긴 중복 승인은 멱등성 키로 다 막히지 않는다. 키 보관 기간이 지나면 같은 키도 새 요청으로 처리될 수 있다.
  • 운영자가 손으로 상태를 바꾸는 실수는 코드로 막기 어렵다. 수동 변경은 감사 로그를 남기고, 상태 전환 규칙을 우회하지 못하게 해야 한다.
Pipedeck 실제 화면

오늘 바로 설정하는 순서

  1. 결제사 문서에서 실패 코드 목록을 뽑아 3분류 표를 채운다.
  2. 야간 대사 배치, 멱등성 키, 조건부 선점 쿼리를 먼저 켠다.
  3. 재시도 스케줄 기준안을 넣고 재시도 시각을 고객별로 흩는다.
  4. 이용권 네 단계와 알림 세 종을 붙이고, 알림은 단계당 한 번만 나가게 한다.

1주일 뒤에 볼 지표는 재시도 회수율, 카드 변경 클릭률, 해지율이다. 지금 운영 중인 설정 중 무엇을 바꿀지는 측정이 쌓인 뒤에 적겠다. 지금은 재시도 간격이 맞는지도 확신이 없다.


글쓴이 정보

아일리고입니다. 자동화를 만들고 굴리며 겪은 일을 여기에 적습니다. 숏폼 영상은 ClipSquare 를 씁니다.