Skip to main content

소개

MailerLite 통합은 결제 이벤트가 발생할 때 유료 고객을 MailerLite에 추가합니다. 고객을 그룹에 추가하고, 결제 데이터를 구독자 필드에 저장하며, 자동화 워크플로를 시작할 수 있으므로 이메일 목록에 실제 결제 활동이 반영됩니다. MailerLite는 뉴스레터, 캠페인 및 자동화를 위한 이메일 마케팅 플랫폼입니다. 이 통합을 사용하면 온보딩 시퀀스, 고객 세분화 및 타겟 캠페인을 위해 결제 활동을 기준으로 구독자를 관리할 수 있습니다.
이 통합은 MailerLite API key로 인증합니다. API key를 만들려면 MailerLite Integrations 페이지를 열고 Generate new token을 클릭합니다.

시작하기

1

Open the Webhook Section

Dodo Payments 대시보드에서 Developer → Webhooks로 이동한 다음 Add endpoint를 클릭합니다.
Integration 드롭다운에서 MailerLite가 선택된 Add endpoint 대화 상자
2

Select MailerLite

Integration 목록에서 MailerLite를 선택합니다.
3

Enter API Key

MailerLite API key를 API key 필드에 붙여넣습니다. Dodo Payments는 모든 전송에서 이를 Authorization header로 전송합니다.
4

Configure Transformation

각 이벤트가 MailerLite 구독자 요청이 되도록 Transformation code 아래의 코드를 수정합니다. 아래 예제에서 시작하세요.
5

Test & Create

Test this code에서 샘플 payload에 대해 변환을 실행한 다음 Create endpoint를 클릭합니다.
6

Done

이제 결제 이벤트가 MailerLite 그룹의 구독자를 추가하고 업데이트합니다.

변환 코드 예제

대부분의 예제는 MailerLite subscribers API에 POST 요청을 전송합니다. MailerLite는 구독자를 생성하거나 동일한 이메일 주소를 가진 기존 구독자를 업데이트합니다. 이 upsert는 지정하지 않은 필드나 그룹을 제거하지 않습니다.

결제 성공 시 고객 추가

이 예제는 결제가 성공하면 고객을 하나의 그룹에 추가합니다. your-group-id-here를 MailerLite 그룹 ID로 바꾸세요.
add_customer.js

제품에 따라 구독자를 여러 그룹에 추가

이 예제는 모든 유료 고객을 customers 그룹에 추가하고, $100 이상을 결제한 고객은 premium 그룹에도 추가합니다.
product_segmentation.js

구독 활성화 시 새 구독자 추가

이 예제는 구독이 활성화되면 고객을 두 개의 구독자 그룹에 추가하고 플랜 세부 정보를 저장합니다.
subscription_subscriber.js

구독 취소 시 구독자 업데이트

이 예제는 구독이 취소될 때 기존 subscriber를 업데이트합니다. MailerLite의 PUT 업데이트 endpoint는 MailerLite subscriber ID를 필요로 하지만 Dodo Payments payload에는 이 ID가 포함되어 있지 않으므로, 이메일 주소를 기준으로 POST upsert를 전송합니다. upsert는 subscriber를 이탈 그룹에 추가하고 기존의 다른 그룹은 유지합니다.
subscription_cancelled.js

Custom Fields로 Customer 추가

이 예제는 subscriber 필드에 위치, 연락처 및 결제 세부 정보를 저장합니다. Custom Fields Setup에 설명된 대로 먼저 MailerLite에서 custom fields를 생성합니다.
custom_fields.js

Event를 통한 Automation 트리거

이 예제는 모든 결제 성공 시 트리거 필드를 업데이트합니다. last_payment_trigger가 변경될 때 시작되는 automation을 MailerLite에서 구축합니다.
trigger_automation.js

팁

  • transformation에서 사용하기 전에 MailerLite에서 custom fields를 생성합니다.
  • product, plan tier 또는 구매 행동별로 customer를 분류하려면 groups를 사용합니다.
  • field가 업데이트될 때 시작되는 automation workflow를 MailerLite에서 설정합니다.
  • 중복 subscriber 오류를 방지하려면 /subscribers에 POST 요청을 전송하여 upsert합니다.
  • customer에 대해 더 자세히 파악하려면 결제 metadata를 custom fields에 저장합니다.
  • 모든 결제에 integration을 활성화하기 전에 소규모 group으로 테스트합니다.

Custom Fields 설정

transformation이 해당 필드에 값을 기록하기 전에 MailerLite에서 각 custom field를 생성합니다:
  1. MailerLite 대시보드를 엽니다.
  2. Subscribers → Fields로 이동합니다.
  3. Create field를 클릭하고 다음과 같은 field를 추가합니다:
    • total_spent (Number)
    • customer_since (Date)
    • subscription_plan (Text)
    • payment_method (Text)
    • last_payment_amount (Number)

문제 해결

  • API key가 올바르고 활성 상태인지 확인합니다.
  • 이메일 주소가 RFC 2821에 따라 유효한지 확인합니다.
  • 각 group ID가 올바르고 계정에 존재하는지 확인합니다.
  • MailerLite는 API를 통해 반송되었거나 스팸 처리된 subscriber를 다시 활성화하지 않습니다. 이전에 구독을 취소한 subscriber를 다시 구독시키려면 POST 본문에 resubscribe: true를 추가합니다.
  • 각 custom field가 MailerLite에 존재하는지 확인합니다.
  • field 이름이 정확히 일치하는지 확인합니다. 대소문자를 구분합니다.
  • 각 값이 field type(텍스트, 숫자 또는 날짜)과 일치하는지 확인합니다.
  • MailerLite API는 분당 120개의 요청을 허용합니다.
  • 많은 subscriber를 처리할 때는 batch endpoint를 사용합니다.
  • 대량 트래픽 상황을 위해 backoff 전략을 추가합니다.
  • group ID가 숫자 문자열인지 확인합니다.
  • 해당 groups가 MailerLite 계정에 존재하는지 확인합니다.
  • groups를 포함한 PUT 요청은 목록에 포함되지 않은 모든 group에서 subscriber를 제거합니다. POST 요청은 groups를 추가만 합니다.

API Reference

MailerLite의 create 또는 upsert subscriber endpoint는 다음 주요 parameter를 허용합니다: 전체 API 문서는 MailerLite Developers를 참조하세요.
마지막 수정일 2026년 9월 26일