Stripe 시작하기

학습 내용

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

Stripe 연동은 2단계로 설정하시면 돼요. 먼저 Klaviyo에서 연동을 활성화하여 Stripe를 연결하시면 돼요. 그런 다음 Stripe에서 웹후크를 설정하면 특정 Stripe 데이터를 Klaviyo로 실시간 동기화할 수 있어요.

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

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

Klaviyo에서 Stripe 연동 활성화

1. Klaviyo에서 연동 탭을 선택합니다.
2. 앱 살펴보기를 선택하고 Stripe을 검색한 다음 카드를 클릭하세요.
3. 그런 다음 설치를 클릭합니다.
4. Stripe에 연결을 클릭해 주세요. 그러면 Stripe 웹사이트로 이동해요. 필요하면 로그인해 주세요.
5. Klaviyo에 연결할 Stripe 계정을 선택하고 연결을 클릭해 주세요.
   

6. Klaviyo로 돌아가서 서명 비밀 키를 입력해 Stripe 웹후크를 인증하도록 선택할 수 있어요(권장). 이는 Stripe의 Developers > Webhooks 에서 확인할 수 있으며, 연동에 추가 보안 계층을 더해 줍니다.
   

7. 이 페이지에서 웹후크 URL을 복사하세요. 다음 섹션에서 Stripe 계정에 붙여넣게 됩니다.
8. 설정 완료를 클릭하세요.

Stripe 웹후크 설정

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

1. 새 탭에서 Stripe를 열고, Developers 탭으로 이동해 주세요.
2. 웹후크를 선택하고 엔드포인트 추가를 클릭하세요.
   

3. 다음 필드를 입력하세요:
   • 엔드포인트 URL
     Klaviyo에서 방금 복사한 URL을 붙여넣어 주세요.
   • 버전
     최신 API 버전을 선택하세요.
   • 전송할 이벤트
     Klaviyo에서는 청구 및 인보이스 데이터 포인트가 필요해요. 전송할 이벤트 드롭다운에서 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
4. 모든 청구 및 인보이스 이벤트를 선택한 후 엔드포인트 추가를 선택합니다.
   

5. 웹후크가 활성화되었다는 확인을 받게 돼요.
   

6. Stripe 연동이 이제 활성화되었습니다.

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

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

1. Klaviyo에서 애널리틱스 드롭다운을 클릭하고 지표를 선택하세요.
2. Stripe의 결제 성공 지표를 찾아 활동 피드 아이콘을 클릭하세요.
   

3. 연동에서 데이터 동기화를 시작했다면, Stripe를 통해 발행된 인보이스가 여기에 표시돼요. 연동이 완전히 동기화되면 Klaviyo 계정에서 Stripe 연동 옆에 초록색 테두리가 표시돼요. Klaviyo는 Stripe 데이터를 모두 가져와요. 이를 확인하려면 특정 날짜의 성공한 결제 수를 Stripe 인터페이스의 수치와 비교해 일치하는지 확인하면 돼요.
4. 예를 들어 성공적으로 결제됨 지표의 차트 제목을 클릭하세요. 이 차트는 기본적으로 최근 30일간의 데이터를 보여줘요. 어제의 데이터 포인트 위에 마우스를 올리거나 차트 아래의 데이터 표에서 어제 결제가 몇 건이었는지 확인해 보세요. 그 숫자를 Stripe에 저장된 값과 비교하면 정확히 일치하는 것을 확인할 수 있어요.
5. 데이터가 일치하지 않는다면, 대부분의 경우 Klaviyo 계정의 시간대가 Stripe 계정의 시간대와 일치하지 않는 것이 원인이에요. Klaviyo에서 시간대 설정을 확인하려면:
   • 왼쪽 하단에서 계정 이름을 클릭합니다.
   • 설정 > 조직을 선택한 다음 클릭하세요.
   • 아래로 스크롤하여 시간대로 이동해요.

Stripe 지표

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

• 결제 실패
• 발행된 인보이스
• 결제 환불
• '결제 성공'

결제 실패

이 지표는 Stripe를 통해 결제된 결제가 실패로 표시될 때마다 기록돼요. 이 지표를 사용해 결제 실패 고객을 타기팅하여 미납 잔액이 있음을 알릴 수 있어요. 다음 기준에 따라 결제 실패 이벤트를 필터링하고 타기팅할 수 있어요:

• AttemptCount
  이 인보이스에서 사용자에게 결제를 시도한 횟수입니다.
• 통화
  청구서 결제에 실패한 통화(예: USD, GBP).
• 인보이스
  Stripe에서 이 결제 실패에 연결된 인보이스예요.
• 사유
  Stripe에서 이 결제가 실패한 사유입니다. 예: 카드가 만료되었습니다, 카드가 거절되었습니다.

발행된 인보이스

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

결제 환불

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

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

'결제 성공'

이 지표는 고객이 Stripe를 통해 인보이스를 성공적으로 결제할 때마다 기록돼요. 이 이벤트에는 고객, 해당 인보이스, 그리고 인보이스에 포함된 제품에 대한 데이터가 포함돼요. 이 지표를 사용해 고객이 결제한 후 자동 인보이스를 보내거나, 이메일 플로우에서 고객이 웹사이트에서 활동했지만 제품 또는 서비스에 대한 결제를 하지 않았을 때를 확인할 수 있어요. 그런 다음 해당 사용자에게 웹사이트에서 구매하도록 할인 혜택을 제공하는 이메일을 보낼 수 있어요.

다음 기준에 따라 결제 성공(Successfully Paid) 이벤트를 필터링하고 타기팅할 수 있어요:

• 통화
  결제된 청구서의 통화(예: USD, GBP).
• 인보이스
  Stripe에서 이 결제와 연결된 인보이스입니다.

고객 데이터

Klaviyo는 이메일 주소로 각 개인을 고유하게 식별해요. Stripe가 새 이메일 주소로 고객 데이터를 동기화하면 Klaviyo는 고객의 이메일 주소와 관련 Stripe 지표로 구성된 새 프로필을 생성해요. 신용카드 만료일은 고객 프로필에 사용자 지정 속성으로 저장돼요.

Klaviyo에서 Stripe 데이터 사용

모든 Stripe 지표 또는 메타데이터를 사용해 Klaviyo에서 플로우를 트리거할 수 있어요.

자동화된 인보이스

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

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

이메일 템플릿에 동적 데이터를 삽입하는 방법에 대한 자세한 내용은 템플릿 태그 및 변수 구문에 관한 문서를 참조하세요.

Stripe 결제 실패 플로우

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

문제 해결

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

Stripe 이벤트가 Klaviyo에 동기화되지 않는 가장 흔한 이유는 이벤트에 연결된 이메일 주소가 없기 때문입니다. Klaviyo는 이메일 주소를 사용해 사람을 고유하게 식별하므로 이메일 주소와 연결되지 않은 사람에 대해서는 프로필을 만들 수 없습니다. 마찬가지로 이메일 주소와 연결되지 않은 이벤트는 Klaviyo가 프로필에 연결할 수 없습니다.

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

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

결과

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

추가 자료