들어가며

데이트팝에는 사용자가 다녀온 데이트 코스를 글로 남기는 팝로그가 있습니다. 2026년 1월부터는 팝로그 글에 담긴 매장 링크를 통해 다른 사람이 구매하면, 글을 쓴 사용자(팝로거)에게 구매 금액의 일부를 리워드로 드리는 어필리에이트(제휴 마케팅) 프로그램을 운영하고 있습니다.

기능만 보면 링크를 만들고, 클릭을 세고, 구매가 들어오면 리워드를 쌓으면 됩니다. 그런데 데이트팝의 상품은 결제한 뒤 매장에서 이용할 때 따로 '사용 완료'로 처리되고, 그 전에 환불될 수도 있습니다. 구매 한 건을 따라가 보면 결제 승인, 사용 완료, 환불이 각각 다른 서버에서 다른 시점에 처리됩니다. 리워드는 이 세 사건이 어떤 순서로 오든 같은 결과가 나와야 했습니다.

이 글에서는 어필리에이트 기능을 어떻게 나눠서 만들었는지, 그리고 비동기로 나뉜 처리들의 결과를 어떻게 맞췄는지 정리해 보려고 합니다.


1. 전체 흐름

팝로그 글 저장
앱 메인 서버

링크 생성 요청
비동기 작업 (실패 시 재시도)

매장별 어필리에이트 링크
링크 도메인 서버

링크 클릭 → 매장 페이지
웹이 링크 코드를 7일 보관

웹 결제
결제 서버: 결제 id + 링크 코드 저장

구매 전환 기록
비동기 작업: 실적, 구매 시점 리워드율

사용 완료 → 리워드 적립
저장된 리워드율로 계산

매일 정산 집계
팝로거별 월 리워드 합산

되돌리기
사용 취소 → 리워드만 차감
환불 완료 → 실적까지 차감

  1. 팝로거가 글을 저장하면 글에 담긴 매장마다 어필리에이트 링크가 만들어집니다.
  2. 다른 사용자가 링크를 누르면 매장 페이지로 이동하고, 링크 코드가 7일 동안 유지됩니다.
  3. 그 사이 웹에서 결제하면 결제에 코드가 함께 저장되고, 링크별로 쌓이는 구매 수와 금액(이하 실적)에 반영됩니다.
  4. 결제가 사용 완료되면 리워드가 쌓입니다.
  5. 매일 새벽 그 달의 리워드를 팝로거별로 합산해 정산 데이터를 만듭니다.

구매를 어느 링크의 몫으로 볼지(귀속)는 웹으로 들어와 7일 안에 마지막으로 누른 링크를 기준으로 합니다. 앱 안에서 탐색하다 구매한 경우는 대상에서 뺐습니다. 개발 당시에는 앱으로 넘어가는 딥링크가 없었기 때문이고, 앱 구매까지 귀속하려면 후속 개발이 필요합니다.

링크 생성과 클릭은 링크 도메인 서버가 맡습니다. 구매 전환 기록과 정산은 비동기 작업 서버가 만들고, 환불 차감과 사용 완료 리워드 적립은 각 요청을 받은 서버가 바로 처리합니다. 링크 도메인 서버의 리다이렉트와 웹의 링크 코드 보관은 팀원이 만든 기반이고, 저는 그 위에 어필리에이트 기능을 얹었습니다.


2. 처음 만들 때 정한 것들

링크가 없어도 글은 저장되게

링크는 링크 도메인 서버라는 별도 서비스에서 만듭니다. 처음에는 글 저장 API 안에서 링크 도메인 서버를 바로 호출했는데, 그러면 링크 도메인 서버에 문제가 생겼을 때 글 저장까지 실패합니다.

팝로거 입장에서는 링크보다 글이 먼저입니다. 그래서 글은 먼저 저장하고, 링크 생성은 비동기 작업으로 요청하도록 바꿨습니다. 이 작업은 실패하면 간격을 늘려 가며 다시 시도하고, 그래도 링크가 없는 글은 나중에 링크를 만들어 주면 된다고 판단했습니다. 글을 수정하거나 비활성화할 때도 같은 작업으로 링크를 만들거나 끕니다.

결제에서 코드를 꺼내 따로 저장

결제 요청에는 원래 여러 값을 담는 custom_data(JSON)가 있고, 링크 코드도 그 안에 들어왔습니다. JSON 안의 값은 인덱스를 쓸 수 없어서 "이 링크로 들어온 결제"를 찾으려면 결제 테이블을 훑어야 했습니다.

결제 시점에 코드를 꺼내 결제 id와 함께 별도 테이블에 저장하도록 해서, 결제와 링크 코드를 바로 이어서 찾을 수 있게 했습니다. 링크를 거쳐 들어온 구매 한 건의 기록(이하 구매 전환 기록)은 이와 별개로, 결제 승인 후 결제 서버가 요청하면 비동기 작업 서버가 만듭니다.

실적은 구매 때, 리워드는 사용 완료 때

결제가 승인되면 실적만 반영하고, 리워드는 실제로 사용 완료됐을 때 쌓습니다. 사용하지 않고 환불되는 결제가 있기 때문에, 리워드를 먼저 주고 나중에 회수하는 일을 줄이려는 선택이었습니다.

되돌리는 쪽도 시점에 맞춰 나눴습니다. 사용 취소는 리워드만 빼고, 환불 완료는 실적까지 모두 뺍니다.

이렇게 나누면서 구매 한 건의 리워드에 영향을 주는 시점이 결제 승인, 사용 완료, 환불 세 개가 됐습니다. 다음 장은 이 세 시점의 순서에 관한 이야기입니다.


3. 순서가 바뀌어도 결과가 같도록

구매 전환 기록은 비동기로 만들어지는 반면, 환불과 사용 완료는 각자의 서버에서 바로 처리됩니다. 그래서 결제 직후 환불하거나 바로 사용 완료하면, 구매 전환 기록이 생기기 전에 다음 단계가 먼저 도착할 수 있습니다.

운영 데이터를 점검하다 이런 순서가 실제로 생긴다는 것을 확인했습니다. 순서를 강제하려면 결제, 사용, 환불을 처리하는 서버들을 한 흐름으로 묶어야 해서, 어떤 순서로 오든 결과가 맞춰지는 쪽을 택했습니다. 이를 위해 매일 새벽 도는 보정 배치를 두고, 한 달에 한 번은 전체 기간을 다시 확인합니다. 보정 배치는 dry_run으로 대상만 먼저 볼 수 있고, 한 건 처리에 실패해도 나머지는 계속 처리합니다.

사용 완료가 먼저 오거나 다른 경로로 온 경우

환불이 먼저 온 경우

① 환불
뺄 전환 기록이 아직 없음

② 전환 기록 생성
환불된 결제의 실적이 남음

매일 보정 배치 (최근 7일)
취소된 결제의 전환 삭제, 실적 차감

사용 완료
연결된 경로에서

리워드 적립 함수 하나
행 잠금 + 리워드 0원인 건만
여러 번 호출돼도 결과가 같음

전환 기록 생성
이미 사용 완료면

매일 보정 배치 (최근 14일)
리워드 0원인 건

환불이 먼저 온 경우

환불을 처리할 때 구매 전환 기록이 아직 없으면 뺄 실적이 없어서 그냥 지나갑니다. 그 뒤에 전환 기록이 만들어지면, 환불된 결제의 실적이 남게 됩니다.

보정 배치가 최근 7일 동안 만들어진 전환 기록을 보고, 결제가 이미 취소된 건이 있으면 전환 기록을 삭제 처리하고 실적에서 뺍니다.

사용 완료가 먼저 오거나 다른 경로로 온 경우

사용 완료가 먼저 오면, 적립할 구매 전환 기록이 없어서 리워드 적립이 그냥 지나갑니다.

여기에 경로 문제도 있었습니다. 데이트팝에는 사장님 사용 처리, 레거시 API, 주문 처리처럼 결제를 사용 완료로 바꾸는 경로가 여러 개 있는데, 경로마다 적립을 따로 연결하는 구조라 경로가 늘 때마다 빠질 위험이 있었습니다. 모든 경로를 찾아 하나씩 연결하는 대신, 어떤 경로로 사용 완료가 됐든 리워드가 쌓이도록 바꿨습니다.

  • 리워드 적립을 함수 하나로 모았습니다. 사용 완료됐고 리워드가 아직 0원인 전환만 행 잠금(select_for_update)으로 잡고 적립하기 때문에, 여러 번 호출돼도 결과가 같습니다.
  • 구매 전환 기록을 만들 때 결제가 이미 사용 완료 상태라면 그 자리에서 바로 적립합니다.
  • 그 밖의 경우는 보정 배치가 최근 14일치를 확인해 적립합니다. 구매하고 사용하기까지는 환불보다 시간이 더 걸릴 수 있어서 기간을 더 길게 잡았습니다.
  • 과거 건도 같은 배치를 전체 기간으로 한 번 돌려 확인했습니다.

4. 리워드율은 구매할 때 정한다

리워드율은 매장 설정에 따라 달라지고, 운영 중에 바뀌기도 합니다. 처음에는 사용 완료 시점에 매장 설정으로 리워드율을 다시 계산했는데, 그러면 구매하고 사용하기 전에 설정이 바뀐 경우 구매 당시 상품 화면에 표시된 리워드율과 다른 비율로 지급됩니다.

구매 전환 기록을 만들 때 그 시점의 리워드율을 함께 저장하고, 지급은 저장된 값으로 하도록 바꿨습니다. 기존 데이터는 백필했고, 저장된 값이 없는 과거 건만 예전 방식으로 계산합니다.

스냅샷을 넣은 뒤에 리워드율 판단 경로를 다시 점검했습니다. 같은 판단을 하는 곳이 구매 전환 기록, 상품 상세 표시, 매장 목록 표시, 지급까지 네 곳이었는데, 지급 경로만 리워드율 고정 설정(매장 상황과 관계없이 기본 리워드율을 유지하는 옵션)을 확인하지 않고 있었습니다. 이 설정을 쓰는 매장이 생기기 전에 발견해, 나머지 세 곳과 같은 함수를 쓰도록 맞췄습니다.


5. 글이 보이지 않으면 리워드도 없다

팝로그 어필리에이트는 글이 노출되는 것으로 매장을 홍보하는 프로그램입니다. 그래서 팀에서는 글이 숨김 상태가 되거나 삭제되면, 링크로 구매가 들어와도 리워드를 주지 않기로 정했습니다. 사내 어드민에서 정산을 비활성화한 글도 같은 지급 단계에서 걸러집니다.

숨길 때마다 링크를 끄고, 다시 보이게 할 때 켜는 방법도 생각했습니다. 하지만 팝로거는 링크를 직접 끌 수도 있어서, 그렇게 하면 팝로거가 끈 링크와 숨김 때문에 꺼진 링크를 구분할 수 없었습니다. 그래서 링크는 그대로 두고, 리워드를 줄 때 글이 보이는 상태인지 판단하도록 했습니다. 숨김을 풀면 따로 저장하지 않아도 다시 리워드 대상이 됩니다.

지급을 막는 변경이라, 배포 전에 운영 데이터에서 새로 막히는 전환이 없는 것을 먼저 확인했습니다.


마치며

어필리에이트를 만들고 운영하면서 정리한 원칙은 네 가지입니다.

  1. 금액이 정해지는 시점은 한 번으로 고정합니다. 나중에 다시 계산하면 그 사이 바뀐 설정이 섞입니다.
  2. 비동기로 나뉜 처리는 순서가 바뀔 수 있다고 보고, 순서와 관계없이 결과를 맞춰 주는 보정 배치를 같이 둡니다.
  3. 같은 판단을 여러 곳에서 하면 한 곳이 빠지기 쉽습니다. 판단 함수를 하나로 두고 모든 경로가 그 함수를 부르게 합니다.
  4. 지급을 막는 변경은 운영 데이터에서 새로 막히는 건을 먼저 셉니다.

남은 일도 있습니다. 비활성 글 판단과 리워드 계산 규칙이 앱 메인 서버와 비동기 작업 서버에 같은 내용으로 두 벌 있어서, 공통 모듈로 모으려고 합니다. 앱 딥링크로 들어온 구매를 귀속할지도 다음 과제입니다.

구매는 한 번이지만 리워드가 움직이는 순간은 세 번이었습니다. 그 세 번이 어떤 순서로 오더라도 팝로거가 받는 리워드는 하나로 남도록 만드는 것이 이번 작업의 대부분이었습니다.