학습 내용

고객의 인보이스 및 결제 데이터를 기반으로 이메일을 개인화하고 타겟팅할 수 있도록 Stripe를 Klaviyo와 연동하는 방법을 알아보세요.

Stripe 연동은 2단계로 설정해요. 먼저 Stripe 계정을 Klaviyo에 연결해요. 그런 다음 Stripe에서 웹후크를 설정하고 Klaviyo에서 설정을 완료해, 인보이스 및 결제 데이터를 실시간으로 동기화해요.

Stripe에서 동기화하는 데이터 개요는 다음과 같아요:

  • 인보이스가 발행될 때와 각 인보이스에 포함된 항목
  • 사용자가 결제에 실패했거나 환불을 받았거나 결제에 성공했을 때의 결제 정보

Stripe 계정 연결

시작하기 전에, 활성화된 Stripe 계정이 있고 Klaviyo에서 연동을 관리할 권한이 있는지 확인해 주세요.

  1. Klaviyo에서 연동 탭을 선택합니다.
  2. 앱 살펴보기를 선택하고 Stripe을 검색한 다음 카드를 클릭하세요.
  3. 그런 다음 설치를 클릭합니다.
  4. Stripe에 연결을 클릭해 주세요. 그러면 Stripe 웹사이트로 이동해요. 필요하면 로그인해 주세요.
  5. Klaviyo에 연결할 Stripe 계정을 선택하고 연결을 클릭해 주세요.
  1. 웹후크 설정에서 웹후크 URL을 복사해 주세요. Stripe에서 웹후크를 만드는 동안 이 페이지를 열어 두세요.
The stripe integration configuration page.
The stripe integration configuration page.

Stripe 웹후크 설정

이제 Stripe 웹후크를 설정하겠습니다. 이를 통해 Stripe 데이터를 실시간으로 동기화할 수 있어요.

  1. Stripe를 새 탭에서 여세요. 아래 설정으로 웹후크 엔드포인트를 만들려면 Stripe의 안내를 사용하세요.
  2. 내 계정을 선택하고 스냅샷 페이로드 형식을 선택해 주세요.
Webhooks tab in Stripe showing endpoints section with add endpoint button
Webhooks tab in Stripe showing endpoints section with add endpoint button
  1. 엔드포인트에 다음 설정을 사용해 주세요:
    • 엔드포인트 URL
      Klaviyo에서 방금 복사한 URL을 붙여넣어 주세요.
    • API 버전
      최신 API 버전을 선택하세요.
    • 이벤트
      이 엔드포인트에 대해 모든 charge 및 invoice 이벤트를 선택해 주세요. 선택적으로 모든 charge.dispute 이벤트를 제외할 수 있어요. 다음 이벤트를 포함하세요:
      • charge.captured
      • charge.expired
      • charge.failed
      • charge.pending
      • charge.refunded
      • charge.succeeded
      • charge.updated
      • invoice.created
      • invoice.deleted
      • invoice.finalized
      • invoice.marked_uncollectible
      • invoice.payment_action_required
      • invoice.payment_failed
      • invoice.payment_succeeded
      • invoice.sent
      • invoice.upcoming
      • invoice.updated
      • invoice.voided
  2. Stripe에서 엔드포인트 생성과 활성화를 완료해 주세요.
Add a webhook endpoint with full list of events and Add endpoint with purple background
Add a webhook endpoint with full list of events and Add endpoint with purple background
  1. Stripe에서 엔드포인트가 활성화되어 있는지 확인해 주세요.
Stripe webhook page with status Enabled highlighted in green
Stripe webhook page with status Enabled highlighted in green
  1. Stripe 웹후크를 확인(권장)하려면 Stripe에서 방금 생성한 엔드포인트의 서명 비밀 키를 복사해 주세요. Klaviyo로 돌아가서 Stripe 웹후크 확인(권장) 아래의 서명 비밀 키에 붙여넣어 주세요. 이렇게 하면 연동에 보안이 한층 더 강화돼요.
  2. 설정 완료를 클릭하세요.

Stripe 연동이 이제 활성화되었고, 과거 데이터 동기화가 시작돼요.

Stripe에서 동기화된 데이터 보기

Klaviyo는 최대 5년치 청구서 및 결제 기록을 가져옵니다. 진행 상황을 확인하려면 연동에서 Stripe를 열고 데이터를 선택해 주세요. 합계를 비교하기 전에 과거 동기화가 완료될 때까지 기다려 주세요.

활성화된 연동을 확인하려면 다음을 확인해 주세요:

  1. Klaviyo에서 애널리틱스 드롭다운을 클릭하고 지표를 선택하세요.
  2. Stripe의 결제 성공 지표를 찾아 선택한 다음 활동 피드를 선택해 주세요.
Activity feed for Stripe Successfully Paid metric in Klaviyo
Activity feed for Stripe Successfully Paid metric in Klaviyo
  1. 피드에 결제 성공 이벤트가 표시되는지 확인해 주세요. 유효한 이메일 주소가 있는 결제만 Klaviyo에 동기화돼요.
  2. 예를 들어,Successfully Paid 지표의 차트 제목을 클릭해 보세요. 이 차트는 기본적으로 최근 30일간의 데이터를 표시해요. 어제 결제 수를 확인하려면 어제의 데이터 포인트에 마우스를 올리거나 차트 아래의 데이터 표를 확인해 보세요. 유효한 이메일 주소가 없는 결제도 고려하면서, 같은 날짜와 시간대의 Stripe 데이터와 그 숫자를 비교해 보세요.
  3. 총합이 다르면, 과거 데이터 동기화가 완료되었는지와 결제에 유효한 이메일 주소가 있는지 확인해 주세요. 또한 Klaviyo와 Stripe에서 사용 중인 시간대도 비교해 주세요. Klaviyo에서 시간대 설정을 확인하려면:
    • 왼쪽 하단에서 계정 이름을 클릭합니다.
    • 설정을 선택한 다음 일반 > 계정을 선택합니다.
    • 아래로 스크롤하여 시간대로 이동해요.

Stripe 지표

Stripe는 다음 지표를 Klaviyo에 동기화합니다:

  • 결제 실패
  • 발행된 인보이스
  • 결제 환불
  • '결제 성공'
Metrics tab in Klaviyo filtered by Stripe with metrics including failed payment and issued invoice
Metrics tab in Klaviyo filtered by Stripe with metrics including failed payment and issued invoice

결제 실패

이 지표는 Stripe를 통해 결제한 항목이 실패로 표시될 때마다 기록돼요. 이 지표를 사용해 결제에 실패한 고객을 타겟팅하고, 미납 잔액이 있다는 점을 안내할 수 있어요. 통화 및 사유 같은 세부 정보를 사용해 결제 실패 이벤트를 필터링하고 타겟팅할 수 있어요. 이 이벤트에는 다음 정보가 포함돼요:

  • AttemptCount
    연결된 인보이스에 대한 결제 시도 횟수예요. 결제가 인보이스에 연결된 경우 포함돼요.
  • 통화
    결제 실패에 사용된 통화예요. 예: USD, GBP.
  • 인보이스
    가능한 경우 Stripe에서 이 결제 실패와 연결된 인보이스예요.
  • 사유
    Stripe에서 이 결제가 실패한 사유입니다. 예: 카드가 만료되었습니다, 카드가 거절되었습니다.

발행된 인보이스

이 지표는 Stripe를 통해 고객에게 인보이스가 발행될 때마다 기록돼요. 이 지표를 사용해 청구서가 발행되었지만 결제하지 않았거나 결제에 실패한 고객을 세그먼트로 나눠 보세요. 다가오는 결제에 대해 고객에게 알리기 위해 플로우를 트리거하는 데도 사용할 수 있어요.

결제 환불

이 지표는 Stripe를 통해 결제를 환불할 때 이벤트를 기록합니다. 다음 기준에 따라 환불된 결제 이벤트를 필터링하고 타기팅할 수 있습니다:

  • 금액
    환불된 결제 금액입니다.

'결제 성공'

이 지표는 고객이 Stripe를 통해 결제를 성공적으로 완료할 때마다(인보이스에 연결되어 있는지 여부와 무관하게) 기록돼요. 이 이벤트에는 결제 데이터가 포함되며, 해당되는 경우 연결된 인보이스와 해당 인보이스의 라인 아이템도 포함돼요. 이 지표를 사용해 고객이 결제한 후 자동화된 인보이스 영수증을 보내거나, 이메일 플로우에서 웹사이트 활동 데이터와 함께 사용해 웹사이트에서 활성 상태였지만 제품 또는 서비스에 대한 결제는 하지 않은 고객을 식별할 수 있어요. 그런 다음 해당 사용자에게 웹사이트에서 구매하도록 유도하는 할인 혜택 이메일을 보낼 수 있어요.

통화를 기준으로 Successfully Paid 이벤트를 필터링하고 타겟팅할 수 있어요. 이 이벤트에는 다음 정보가 포함돼요:

  • 통화
    결제 통화(예: USD, GBP)예요.
  • 인보이스
    해당 결제가 Stripe에서 연결된 인보이스로, 있을 경우 표시돼요.

고객 데이터

이 연동에서 Klaviyo는 이메일 주소로 고객을 식별해요. Stripe가 새 이메일 주소로 고객 데이터를 동기화하면, Klaviyo는 고객의 이메일 주소와 연결된 Stripe 지표로 구성된 새 프로필을 생성해요. 결제에 카드 세부 정보가 포함되면 카드의 만료일이 고객 프로필의 Stripe Card Expiration Date 사용자 지정 속성에 저장돼요.

위에 나열된 Stripe 이벤트 중 하나가 발생해야 Klaviyo에서 프로필이 생성돼요.

Klaviyo에서 Stripe 데이터 사용

Stripe 지표를 사용해 플로우를 트리거하세요. 통화 필터 같은 트리거 필터로 플로우 범위를 좁히고, 트리거 이벤트의 데이터를 사용해 메시지를 개인화할 수 있어요.

자동화된 인보이스

Stripe의 결제 성공 지표에 의해 트리거되는 청구서 플로우를 설정하면, 고객이 결제를 완료한 후 청구서 영수증을 자동으로 발송할 수 있어요.

Flow in Klaviyo flow builder triggered by Successfully Paid
Flow in Klaviyo flow builder triggered by Successfully Paid

이 플로우는 Stripe 결제 속성을 참조하는 템플릿 태그를 사용해 동적 결제 세부 정보를 표시하는 이메일을 자동으로 채울 수 있어요.

이메일 템플릿에 동적 데이터를 삽입하는 방법에 관해 자세한 내용을 보시려면 이벤트 데이터를 사용하여 플로우 메시지를 개인화하기에 대한 도움말 문서를 참조하세요.

Stripe 결제 실패 플로우

Stripe Failed Payment 지표에 의해 트리거되는 자동화된 플로우를 사용해 결제 실패를 고객에게 알려 주세요.

Flow in Klaviyo flow builder triggered by Failed Payment
Flow in Klaviyo flow builder triggered by Failed Payment

문제 해결

Stripe 동기화에서 Klaviyo로 모든 활동이 표시되지 않아요.

Stripe 결제 또는 인보이스가 Klaviyo에 동기화되려면 유효한 이메일 주소가 있어야 해요. 결제의 경우 Stripe 고객의 이메일 주소를 확인해 주세요. 이메일이 없으면 Klaviyo에서 결제의 청구 세부정보에 있는 이메일을 사용해요. 인보이스의 경우 Klaviyo에서 인보이스의 고객 이메일을 사용하고, 이메일이 없으면 Stripe 고객의 이메일을 대신 사용해요. Klaviyo에서 선택한 이메일 주소가 누락되었거나 유효하지 않으면 이벤트가 동기화되지 않아요.

이름과 성 입력은 반드시 일관되거나 고유하지 않을 수 있으므로, 이 정보만으로는 프로필을 생성하지 않아요. 그렇게 하면 중복이 생기고 트래킹이 부정확해질 수 있어요.

이메일 주소가 연결되어 있는데도 Stripe 데이터가 Klaviyo로 동기화되지 않는다면 지원팀에 문의해 주세요.

결과

이제 Stripe를 Klaviyo와 통합했고 동기화된 데이터를 사용하는 방법을 알아봤어요.

추가 자료

  • Getting started with flows

    Learn how to use flows, also known as automations or drip campaigns, in Klaviyo for personalized and automated communications to your customers, and learn how to set your first flow live.

  • Getting started with segments

    Learn how to create and use segments in Klaviyo, which are a powerful tool for understanding your audience and sending targeted messages.

  • Understanding the types of information exchanged between Klaviyo and apps

    Learn about what types of data are exchanged between Klaviyo and external apps, and where that data is found in your Klaviyo account. When you integrate a third-party application with Klaviyo, the two platforms exchange information. Most data exchange with Klaviyo is one-way; data is pulled into your Klaviyo account so you can leverage a broad scope of your customers' data within Klaviyo.

이 도움말 문서가 유용했나요?
이 형식은 도움말 문서 피드백 용도로만 사용하세요. 지원 팀에 문의하는 방법.

Klaviyo에서 자세히 살펴보기

커뮤니티
동료, 파트너, Klaviyo 전문가와 연결되어 영감을 받고 인사이트를 공유하며, 모든 궁금한 사항에 대해 답을 얻으세요.
파트너
특정 작업을 도와주거나 지속적인 마케팅 관리를 위해 Klaviyo 인증 전문가를 고용하세요.
지원

계정을 통해 지원에 액세스하세요.

이메일 지원 (무료 체험 및 유료 계정) 연중무휴 24시간 사용 가능

채팅/가상 비서
사용 가능 여부는 위치 및 요금제 유형에 따라 다름