Skip to main content

소개

Close CRM 통합은 Dodo Payments 이벤트에서 Close에 레코드를 생성합니다. 성공한 결제로 연락처를 생성하고 새 구독으로 기회를 생성할 수 있으므로 영업팀은 리드와 함께 매출 활동을 확인할 수 있습니다.
이 통합을 사용하려면 연락처와 기회를 생성할 수 있는 권한이 있는 Close API key가 필요합니다. Close에서 API key를 생성하려면 Settings → Developer → API Keys로 이동한 다음 New API Key를 클릭합니다.

시작하기

1

Open the Webhook Section

Dodo Payments 대시보드에서 Developer → Webhooks로 이동한 다음 Add endpoint를 클릭합니다.
Add endpoint dialog with CloseCRM selected in the Integration dropdown
2

Select Close CRM

Integration에서 CloseCRM을 선택합니다.
3

Enter API Key

API key에 Close API key를 붙여넣습니다. Dodo Payments는 모든 delivery의 Authorization header에 이 key를 포함해 전송합니다.
4

Select Events

Subscribed events에서 transformation이 처리할 이벤트를 선택합니다. 이 페이지의 예제에서는 payment.succeeded 및 subscription.active를 사용합니다.
5

Configure Transformation

Transformation code에서 handler를 편집하여 결제 데이터를 Close object에 매핑합니다. 예제에서 시작하세요.
6

Test & Create

Test this code에서 Simulate를 클릭하여 샘플 payload에 대해 handler를 실행합니다. 그런 다음 Create endpoint를 클릭합니다.
7

Done

이제 구독한 각 이벤트가 Close에 레코드를 생성합니다.

Transformation Code 예제

각 handler는 webhook.url를 Close API endpoint로 설정하고 webhook.payload를 request body로 대체합니다. Close는 custom.cf_<field_id> key를 통해 custom field를 설정하므로, 예제의 cf_ key를 직접 만든 custom field의 ID로 바꿉니다. Dodo Payments 금액은 가장 작은 통화 단위로 표시됩니다. 예를 들어 USD의 경우 cents입니다.

결제에서 연락처 생성

결제가 성공하면 연락처를 생성합니다. Close는 emails 및 phones를 object 목록으로 받습니다. request에 lead_id가 없으면 Close는 연락처 이름으로 새 lead를 생성합니다.
create_contact.js

구독에서 기회 생성

구독이 활성화되면 기회를 생성합니다. Close는 value를 cents 단위의 integer로 받고, value_period를 one_time, monthly 또는 annual로 받으므로, 예제에서는 구독의 payment_frequency_interval를 기간에 매핑합니다. lead_id는 Dodo Payments customer ID가 아니라 Close lead ID여야 합니다. 예제에서는 구독의 metadata에서 이 값을 읽으므로 구독을 생성할 때 lead ID를 해당 위치에 저장해야 합니다. lead_id가 없으면 Close는 제목이 없는 새 lead를 생성합니다.
create_opportunity.js

팁

  • field를 매핑하기 전에 Close API documentation에서 field 이름과 type을 확인합니다.
  • 금액 및 결제 방법과 같은 결제 관련 데이터는 custom field에 저장합니다. 먼저 Close에서 field를 생성한 다음 해당 ID를 사용합니다.
  • 구독의 recurring_pre_tax_amount를 opportunity의 value에 매핑하고, 결제 주기를 value_period에 매핑합니다.
  • ID를 사용하여 레코드를 연결합니다. Dodo Payments customer_id를 Close 연락처에 저장하고, Close lead ID를 Dodo Payments metadata에 저장합니다.
  • 연락처 예제는 갱신 및 반복 구매를 포함한 모든 payment.succeeded에서 실행되므로, 기존 고객이 다시 구매하면 연락처가 하나 더 생성됩니다.

문제 해결

  • API key에 write permission이 있는지 확인합니다.
  • 필요한 field가 포함되어 있는지 확인합니다.
  • 각 email address가 유효한지 확인합니다.
  • Close API rate limit을 검토합니다.
  • delivery가 401와 함께 실패하면 Close에서 Basic authentication을 요구하는 것일 수 있습니다. endpoint의 Advanced 탭에서 Authorization header를 조정합니다.
  • Developer → Webhooks의 Logs 탭에서 endpoint의 delivery attempt를 열어 Close의 response를 확인합니다.
  • payload가 Close API format과 일치하는지 확인합니다.
  • 필요한 모든 field가 있는지 확인합니다.
  • field 이름이 Close schema와 정확히 일치하고 custom field가 custom.cf_ ID를 사용하는지 확인합니다.
마지막 수정일 2026년 9월 26일