Stripe 시작하기

학습 내용

고객의 인보이스 및 결제 데이터를 기반으로 이메일을 개인화하고 타겟팅하기 위해 Stripe와 Klaviyo를 통합하는 방법을 알아보세요.

Stripe 연동은 두 단계로 설정할 수 있습니다. 먼저 클라비요에서 통합을 활성화하여 Stripe을 연결합니다. 그런 다음 Stripe에서 웹훅을 설정하면 특정 Stripe 데이터를 클라비요에 실시간으로 동기화할 수 있습니다.

다음은 Stripe에서 동기화하는 데이터에 대한 개요입니다:

• 인보이스가 발행되는 시기 및 각 인보이스에 포함된 항목
• 사용자가 결제에 실패하거나 환불받거나 결제에 성공한 경우의 결제 정보

클라비요에서 Stripe 통합 활성화하기

1. 클라비요에서 왼쪽 하단 모서리에 있는 계정 이름을 클릭한 다음 연동을 선택합니다.
2. 연동 서비스 추가를 선택하고 Stripe을 검색한 다음 카드를 클릭합니다. 
3. 그런 다음 설치를 클릭합니다.
4. Stripe에 연결을 클릭합니다. 그러면 Stripe 웹사이트로 이동합니다. 필요한 경우 로그인합니다.
5. 클라비요에 연결하려는 Stripe 계정을 선택하고 연결을 클릭합니다. 
   
6. 클라비요로 돌아가서 서명 비밀번호를 입력하여 Stripe 웹훅을 인증하도록 선택할 수 있습니다(권장). 이 기능은 개발자 > 웹훅 아래의 Stripe에서 찾을 수 있으며 통합에 보안 수준을 한층 더 높여줍니다.
   
7. 이 페이지에서 웹훅 URL을 복사합니다. 다음 섹션에서 Stripe 계정에 붙여넣을 수 있습니다. 
8. 설정 완료를 클릭합니다.

Stripe 웹훅 설정

이제 Stripe 웹훅을 설정하여 Stripe 데이터를 실시간으로 동기화할 수 있도록 하겠습니다.

1. 새 탭에서 Stripe을 열고 개발자 탭으로 이동합니다.
2. 웹훅을 선택하고 엔드포인트 추가를 클릭합니다.
   
3. 다음 필드를 입력합니다:
   • 엔드포인트 URL
     클라비요에서 방금 복사한 URL을 붙여넣습니다.
   • 버전
     최신 API 버전을 선택합니다.
   • 전송할 이벤트
     클라비요에는 청구 및 인보이스 데이터 포인트가 필요합니다. 전송할 이벤트 드롭다운에서 모든 청구 및 인보이스 이벤트를 선택합니다. 선택적으로 모든 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_succeeded
     • invoice.sent
     • invoice.upcoming
     • invoice.updated
     • invoice.voided
4. 모든 청구 및 인보이스 이벤트를 선택한 후 엔드포인트 추가를 선택합니다.
   
5. 웹훅이 활성화되었다는 확인 메시지가 표시됩니다.
   
6. 이제 Stripe 연동이 활성화되었습니다.

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

활성화된 통합을 확인하려면 다음과 같이 하세요:

1. 클라비요에서 애널리틱스 드롭다운을 클릭하고 메트릭을 선택합니다.
2. Stripe의 성공적으로 결제됨 메트릭을 찾아 활동 피드 아이콘을 클릭합니다.
   
3. 통합에서 데이터 동기화를 시작한 경우 Stripe를 통해 발행된 송장이 여기에 채워지는 것을 볼 수 있습니다. 연동이 완전히 동기화되면 클라비요 계정에서 Stripe 연동 옆에 녹색 테두리가 표시됩니다. 클라비요는 모든 Stripe 데이터를 가져옵니다. 이를 확인하려면 특정 날짜의 결제 성공 횟수를 Stripe 인터페이스에 표시된 것과 비교하여 일치하는지 확인하면 됩니다.
4. 예를 들어,성공적으로 결제됨 메트릭의 차트 제목을 클릭합니다. 이 차트는 기본적으로 최근 30일간의 데이터를 표시합니다. 어제 데이터 포인트에 마우스를 올리거나 차트 아래의 데이터 표를 확인하여 어제 결제 건수를 확인하세요. 이 숫자와 Stripe에 저장된 숫자를 비교하면 정확히 일치하는 것을 확인할 수 있습니다.
5. 데이터가 일치하지 않는 경우 클라비요 계정의 표준 시간대가 Stripe 계정의 표준 시간대와 일치하지 않는 문제일 가능성이 높습니다. 클라비요에서 시간대 설정을 확인하려면 다음과 같이 하세요:
   • 왼쪽 하단에서 계정 이름을 클릭합니다.
   • 설정을클릭한 다음 > 조직을 선택합니다.
   • 시간대까지 아래로 스크롤합니다.

스트라이프 메트릭

Stripe는 다음 메트릭을 클라비요에 동기화합니다:

• 결제 실패
• 발행된 송장
• 환불된 결제
• 결제 성공

결제 실패

이 메트릭은 Stripe을 통해 이루어진 결제가 실패로 표시될 때마다 기록됩니다. 이 지표를 사용하여 결제에 실패한 고객을 타겟팅하여 잔액이 연체되었음을 알릴 수 있습니다. 다음 기준에 따라 결제 실패 이벤트를 필터링하고 대상을 지정할 수 있습니다:

• AttemptCount
  이 청구서가 사용자에게 청구하려고 시도한 횟수입니다.
• 통화
  인보이스의 통화를 결제하지 못했습니다(예: USD, GBP).
• 인보이스
  이 결제 실패 인보이스가 Stripe에 연결된 인보이스입니다.
• 이유
  이 결제에 실패한 이유(예: 카드 유효기간이 만료되었거나 카드가 거부되었습니다).

발행된 송장

이 지표는 Stripe을 통해 고객에게 인보이스가 발행될 때마다 기록됩니다. 이 지표를 사용하여 인보이스를 발행했지만 결제하지 않았거나 결제에 실패한 고객을 세분화할 수 있습니다. 또한 세그먼트를 트리거하여 고객에게 예정된 결제를 알리는 데 사용할 수도 있습니다.

환불된 결제

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

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

결제 성공

이 메트릭은 고객이 Stripe을 통해 인보이스를 성공적으로 결제할 때마다 기록됩니다. 이러한 이벤트에는 고객, 인보이스 및 인보이스에 포함된 제품에 대한 데이터가 포함됩니다. 이 지표를 사용하여 고객이 결제한 후 고객에게 자동 인보이스를 보내거나 이메일 흐름에서 고객이 웹사이트에서 활동했지만 제품이나 서비스에 대한 결제를 하지 않은 시점을 파악할 수 있습니다. 그런 다음 해당 사용자에게 웹사이트에서 구매할 수 있도록 할인 혜택을 제공하는 이메일을 보낼 수 있습니다.

다음 기준에 따라 성공적으로 결제된 이벤트를 필터링하고 타겟팅할 수 있습니다:

• 통화
  결제한 인보이스의 통화(예: USD, GBP)입니다.
• 인보이스
  이 결제와 연결된 인보이스는 Stripe에서 확인할 수 있습니다.

고객 데이터

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

클라비요에서 스트라이프 데이터 사용

모든 Stripe 지표 또는 메타데이터를 사용하여 클라비요에서 흐름을 트리거할 수 있습니다.

자동 인보이스

Stripe의 결제 성공 메트릭에 의해 트리거되는 인보이스 플로우를 설정하여 고객이 결제한 후 자동으로 인보이스 영수증을 고객에게 보낼 수 있습니다.

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

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

Stripe 결제 실패 흐름

Stripe 결제 실패 메트릭에 의해 트리거되는 자동화된 흐름을 통해 고객에게 결제 실패를 알립니다.

문제 해결

Stripe의 모든 활동이 클라비요에 동기화되지 않습니다.

스트라이프 이벤트가 클라비요에 동기화되지 않는 가장 일반적인 이유는 이벤트와 연결된 이메일 주소가 없기 때문입니다. 클라비요는 이메일 주소를 사용하여 개인을 고유하게 식별하기 때문에 이메일 주소와 연결되지 않은 사람에 대해서는 프로필을 만들 수 없습니다. 마찬가지로 클라비요는 이메일 주소와 연결되지 않은 이벤트는 프로필에 연결할 수 없습니다.

이름과 성 입력이 반드시 일관되거나 고유한 것은 아니므로 이 정보만으로는 프로필을 만들지 않습니다. 이렇게 하면 중복 및 부정확한 추적이 발생할 수 있습니다.

이메일 주소가 연결되어 있어도 여전히 Stripe 데이터가 클라비요에 동기화되지 않는다면 지원팀에 문의하세요.

결과

이제 스트라이프와 클라비요를 통합하고 동기화된 데이터를 사용하는 방법을 배웠습니다.

추가 리소스

• 플로우 시작하기
• 세그먼트 시작하기
• 클라비요와 앱 간에 교환되는 데이터 유형 이해하기