DOCS

맞춤 통합

Checkout•
홈Global ecommerce Integration Checkout 통합 맞춤 통합

맞춤 통합

맞춤 사이트에 end-to-end Checkout 통합을 구축합니다.

통합 체크리스트 

이 포괄적인 체크리스트에 따라 Zonos Dashboard 계정을 설정하고 맞춤 사이트 또는 플랫폼에 Zonos Checkout을 통합하세요.

시작하려면 영업팀에 문의하여 계정을 생성하고 계약에 서명하세요. 계약에 서명하면 확인해야 하는 두 건의 소액 입금이 계좌에 입금됩니다.

Dashboard store ID와 함께(영업 담당자 CC) 이 소액 입금 금액을 accounting@zonos.com으로 이메일로 보내주세요.

확인되면 은행 세부 정보가 Dashboard -> Settings -> Billing에 표시됩니다.

Zonos 계정을 생성한 후 Checkout이 스토어와 올바르게 작동하도록 Dashboard에서 설정을 구성해야 합니다. 이 섹션에서는 필수 Dashboard 구성을 모두 다룹니다.

지급 설정

Checkout에서 적시 지급을 받으려면 은행 계좌를 연결하세요. 지급은 결제 캡처 후 2일 이내에 매일 처리됩니다. 다음 단계를 따르세요.

  1. Dashboard -> Settings -> Checkout settings 로 이동합니다.
  2. Add bank account를 클릭합니다.
  3. Stripe portal로 이동하여 설정을 완료하고 다음 정보를 제공합니다.
    • Bank account information.
    • Company EIN.
    • 25% 지분 회사 소유자의 Social Security Number. 필요한 이유에 대한 자세한 내용은 Stripe documentation을 참조하세요.

Note: 지급 일정을 업데이트해야 하면 support@zonos.com에 문의하세요.

허용 도메인 설정

Zonos JS script은 보안을 위해 허용 도메인 목록이 필요합니다. 승인되지 않은 사이트의 스크립트 로드를 방지하고 승인된 도메인에서만 실행되도록 합니다. 이 구성 없이는 스크립트가 권한 오류를 반환합니다.

To set this up:

  1. Dashboard -> Settings -> Checkout settings로 이동합니다.
  2. URLs에서 Checkout이 사용될 전체 도메인 및 하위 도메인을 추가합니다. 예를 들어 도메인이 example.com이면 example.com과 test.example.com을 추가해야 합니다.

브랜딩 설정 사용자 지정

Dashboard에서 브랜딩 설정을 구성하여 스토어의 모양과 느낌에 맞춥니다.

To do this, please follow these steps:

  1. Dashboard -> Settings -> Checkout settings -> Branding으로 이동합니다.
  2. 다음 설정을 구성합니다.
    • Logo.
    • Brand and accent color.
    • Theme, Style, and Font.

브랜딩 설정에 대한 자세한 내용은 documentation을 참조하세요.

배송 운송사 연결

Checkout에서 배송을 견적하려면 Zonos 계정에 배송 운송사를 연결해야 합니다. Checkout에서 특정 배송 서비스 수준을 활성화할 수 있습니다.

To connect a shipping carrier, please follow these steps:

  1. Dashboard -> Settings -> Shipping -> Rates로 이동합니다.
  2. Add carrier를 클릭합니다.
  3. 운송사 설정 지침을 따릅니다.

운송사 계정 연결에 대한 자세한 내용은 documentation을 참조하세요.

배송 구역 설정

배송 구역을 사용하면 세계 각 지역에 사용 가능한 배송 운송사 및 서비스 수준을 구성할 수 있습니다.

To set up shipping zones, please follow these steps:

  1. Dashboard -> Settings -> Shipping -> Locations로 이동합니다.
  2. New zone을 클릭합니다.
  3. 구역 이름을 입력하고 배송할 국가를 선택합니다.
  4. 제공할 운송사 및 서비스 수준을 선택합니다.

배송 구역에 대한 자세한 내용은 documentation을 참조하세요.

대체 원산지 국가 및 HS code 설정 

원산지 국가 및 HS code는 정확한 관세 및 세금 계산에 사용됩니다.

특정 원산지 국가 또는 HS code를 제공하지 않으면 Dashboard에 설정된 대체 값을 사용합니다.

대체 Country of Origin 및 HS code를 설정하려면:

  1. Dashboard -> Settings -> Shipping -> Catalog로 이동합니다.
  2. 원산지 국가의 경우 제품 대부분이 제조된 국가를 선택합니다.
  3. HS code의 경우 가장 일반적인 제품의 HS code를 입력합니다. HS code가 없으면 Dashboard의 Classify로 이동하여 제품 이름과 설명을 입력하여 정확한 HS code를 생성합니다.

Zonos JS snippet은 사이트에서 글로벌 checkout 기능을 활성화하는 클라이언트 측 JavaScript 통합입니다. 이커머스 플랫폼과 Zonos 서비스 간의 다리 역할을 하며 다음을 처리합니다.

  • Checkout Experience: checkout UI를 렌더링하고 결제를 처리합니다.
  • Location Services: 방문자 위치를 감지하고 통화 변환을 관리합니다.
  • Cart Integration: 기존 장바구니 및 주문 시스템과 연결합니다.
  • Security: 도메인을 검증하고 API 요청을 인증합니다.

snippet은 사이트 성능에 영향을 주지 않도록 비동기로 로드됩니다. 스토어 API 자격 증명으로 초기화되며 모든 클라이언트 측 상호 작용을 안전하게 처리합니다. 구현은 비침투적으로 설계되어 기존 checkout 흐름에 최소한의 변경만 필요합니다.

아래는 Checkout 통합 시 참조할 스크립트 로드, 초기화 및 이벤트 처리가 포함된 완전한 예제입니다.

1
  1. relay가 어떤 property/pixel에 대해 발생시킬지 알 수 있도록 Checkout customHTML을 통해 해당 ID를 전달합니다.
1

단계별 iframe 지침, 전체 event reference(purchase / Purchase payload mapping 포함) 및 디버깅 팁은 다음을 참조하세요.

시스템과 Zonos Dashboard 간 주문을 동기화하려면 다음 API calls 및 webhooks를 구현하세요.

Required Mutations 

Mutation↕설명↕
orderUpdateAccountOrderNumber네이티브 account number를 Dashboard와 동기화합니다. Docs →
orderAddTrackingNumberDashboard에서 라벨을 인쇄하지 않는 경우에만 필요합니다. Dashboard에 추적이 표시되어 Zonos가 Landed cost 계산을 보장할 수 있도록 합니다. Docs →

Required Webhooks 

Webhook↕설명↕
ORDER_CREATEDCheckout 주문을 네이티브 플랫폼으로 보내는 데 필요합니다. Docs →
ORDER_STATUS_CHANGED주문 상태가 변경될 때(예: fulfilled, canceled) 시스템을 Zonos와 동기화 상태로 유지합니다. Docs →

Checkout 통합을 라이브하기 전에 원활한 고객 경험을 위해 통합의 모든 측면을 철저히 테스트하는 것이 중요합니다. checkout 흐름, 결제 처리, 주문 생성 및 webhook 기능 테스트가 포함됩니다.

테스트 가이드를 따라 통합이 올바르게 작동하는지 확인하고 프로덕션 출시 전 문제를 식별하고 수정하세요.

통합 프로세스에 대한 일반적인 질문입니다.

Zonos는 주문 확인을 어떻게 처리하나요? 

Success page type 아래 Dashboard -> Settings -> Checkout settings에서 구매 후 경험을 구성합니다. 세 가지 옵션이 있습니다.

  • Show Zonos success page(기본값, 권장) — 주문 후 Zonos가 내장 thank you page를 표시합니다. 주문이 시스템으로 가져와지지 않아도 페이지가 항상 표시되어 쇼퍼는 항상 확인을 받습니다.
  • Redirect to a success page — Zonos가 주문이 생성될 때까지 짧은 "Order complete" 화면에서 대기한 다음 구성된 success URL로 zOrderNumber(legacy carts의 경우 orderId)를 query params로 추가하여 리디렉션합니다.
  • Close the checkout modal — 결제가 캡처되면 Zonos가 modal을 닫습니다. success URL도 구성하면 Stripe가 결제를 수집한 직후 — 주문 생성을 기다리지 않고 — 해당 URL로 리디렉션하고 zonosCheckoutSessionId를 query param으로 추가합니다. 자체 success page로 가장 빠르게 전환하려면 이 옵션을 사용하세요.

zonosCheckoutSessionId에서 주문 조회 

Close the checkout modal과 redirect URL을 사용하면 리디렉션 후 checkout session에 주문이 연결되는 데 몇 초가 걸릴 수 있습니다. URL에서 zonosCheckoutSessionId를 읽고 secret credential token을 사용하여 서버에서 checkoutSession GraphQL query를 폴링하여 주문이 준비될 때까지 기다리세요. 브라우저에서 호출하지 마세요 — secret credential token은 서버 측에 유지해야 합니다.

1query getCheckoutSession($id: String!) {
2 checkoutSession(id: $id) {
3 order {
4 id
5 }
6 }
7}

Dashboard -> Settings -> Integrations의 secret credential token을 credentialToken request header로 전달하여 https://api.zonos.com/graphql에 쿼리를 보냅니다.

주문이 생성될 때 알림을 받을 수 있나요?

예. 주문 생성 시 알림을 받으려면 Checkout settings의 Email 섹션에서 주문 생성, 배송 또는 취소 시 알림을 받을 팀 구성원의 이메일 주소를 입력할 수 있습니다.

데모 예약하기

이 페이지가 도움이 되었나요?

지원 받기·법적 문서·© 2026 Zonos
이 페이지에서:
  • Zonos 계정 생성
  • Dashboard 및 Checkout 설정 구성
  • Zonos JS snippet 설치
  • Hello 설정
  • Checkout 설정
  • Dashboard에 주문 추적 및 상태 동기화