OAuth로 Stripe를 연결하면 구독이 시작되거나, 체험 기간이 끝나 가거나, 인보이스 결제가 실패할 때 브랜드에 맞는 이메일을 보낼 수 있어요. Brew가 웹훅을 등록하고, 지원되는 이벤트를 자동화 트리거로 쓸 수 있게 해 줘요.
결제, 재시도, 환불, 구독 변경은 계속 Stripe가 담당해요. Brew는 이메일을 만들고 보내요.
invoice.payment_failed 이벤트로 트리거되는 이메일 한 통으로 시작하세요. 이후 리마인더를 보내려면, 애플리케이션이 Stripe에서 인보이스 상태를 새로 확인하도록 예약하세요. 인보이스가 여전히 미결제이고 고객이 계속 대상에 해당할 때만 별도의 Brew 사용자 지정 이벤트를 보내세요.
대기 단계가 지난 뒤에도 이벤트 필드에는 원래 이벤트 페이로드가 그대로 들어 있어요. contact.stripe_subscription_status 조건은 해당 노드가 실행되는 시점에 Brew 연락처에 있는 필드의 현재 값을 읽어요. Stripe를 조회하거나 특정 인보이스가 결제됐음을 증명하지는 않아요. 연락처 업데이트나 새 결제 이벤트가 이전 실행을 자동으로 취소하지도 않아요. 카드를 업데이트했다고 해서 결제가 된 것도 아니에요.
두 경로를 모두 테스트하세요. 인보이스가 아직 미결제이고 여전히 대상에 해당하는 고객은 리마인더를 받고, 예약된 확인 전에 결제한 고객은 받지 않아야 해요. 재시도는 문서에 나온 멱등성 규칙에 맞춰 테스트하세요.
Brew는 다음 이벤트 유형 22개를 지원해요:
고객 이벤트와 구독 이벤트는 결제 관련 정보로 Brew 연락처를 업데이트할 수 있어요. 사용할 수 있는 연락처 필드에는 stripe_subscription_status, stripe_subscription_plan, stripe_plan_amount_cents, stripe_trial_end, stripe_renews_at, stripe_cancel_at_period_end, stripe_delinquent가 있어요. 실제로 쓸 수 있는지는 Stripe 이벤트와 받은 데이터에 따라 달라요.
개인화 태그에는 선택한 이벤트에 선언된 페이로드 스키마를 사용하세요. 이벤트에 따라 firstName, lastName, amount, currency, status, invoiceNumber, previousPlan, newPlan, failureMessage 같은 필드가 있어요. 스키마가 센트 단위로 명시한 금액은 센트 단위예요.
Stripe 객체 식별자는 자동화 페이로드에서 제거돼요. 인보이스 ID나 구독 ID를 개인화 태그로 쓸 수 있다고 가정하지 마세요. Brew는 Stripe 고객 ID도 연락처에 저장하지 않아요.
이벤트별 ‘전체 이름 동기화’ 설정은 Stripe가 연락처 이름을 업데이트할 수 있는지를 정해요. 트리거를 켜거나 끄는 설정이 아니에요.
나중에 들어온 결제 이벤트가 이전 결제 실패로 시작된 실행을 자동으로 취소하지는 않아요. 리마인더 전에 애플리케이션에서 확인하도록 예약하고, 인보이스가 아직 미결제일 때만 새 이벤트를 보내세요.
이벤트 수신과 이메일 발송은 별개의 단계예요. 일치하는 자동화가 활성 상태인지 확인하고, 필터와 실행 기록을 살펴보고, 수신자가 발송 대상인지와 발신 도메인을 확인하세요. ‘전체 이름 동기화’ 설정은 이름 업데이트만 제어해요.
