DOCS
Collect•
홈물류 제공업체용 Zonos Collect 시작하기

Collect 시작하기

배송 전 수하인으로부터 관세, 세금, 수수료를 수금합니다.

작동 방식 

Zonos Collect는 기존 landed cost 워크플로우에 통합됩니다. landedCostCalculateWorkflow mutation에 quoteType: COLLECT를 추가하면 요청이 표준 landed cost 계산과 동일하게 작동하여 동일한 데이터를 모두 반환하지만, 여기에 더해 Collect 워크플로우도 함께 트리거됩니다.

과정은 간단합니다. 요청에 quoteType: COLLECT를 지정하면 시스템이 결제 카트를 자동으로 생성하고, 카트 링크를 수신자의 이메일로 전송하며, 결제가 완료되면 견적을 주문으로 전환합니다.

Collect 견적 생성 

이미 익숙한 GraphQL 워크플로우를 그대로 사용하고, 파라미터 하나만 추가하면 됩니다. landedCostCalculateWorkflow input에 quoteType: COLLECT를 추가하면 기존 기능을 모두 유지하면서 Collect 프로세스 전체가 트리거됩니다. 응답의 links 필드는 checkout 세션 URL을 반환하며, 필요에 따라 이를 저장해 두었다가 결제 당사자와의 후속 소통에 사용할 수 있습니다.

1mutation CollectQuote(
2$parties: [PartyCreateWorkflowInput!]!
3$items: [ItemCreateWorkflowInput!]!
4$shipmentRating: ShipmentRatingCreateWorkflowInput!
5$landedCost: LandedCostCalculateWorkflowInput!
6) {
7 partyCreateWorkflow(input: $parties) {
8 type
9 id
10 organization
11 }
12 
13 itemCreateWorkflow(input: $items) {
14 id
15 amount
16 quantity
17 description
18 }
19 
20 cartonizeWorkflow {
21 id
22 }
23 
24 shipmentRatingCreateWorkflow(input: $shipmentRating) {
25 id
26 amount
27 }
28 
29 landedCostCalculateWorkflow(input: $landedCost) {
30 id
31 landedCostGuaranteeCode
32 links {
33 key
34 url
35 }
36 amountSubtotals {
37 duties
38 fees
39 taxes
40 landedCostTotal
41 }
42 fees {
43 amount
44 currency
45 type
46 item {
47 productId
48 }
49 }
50 }
51}

웹훅

견적이 주문으로 전환되는 즉시 알림을 받으려면 ORDER_CREATED 웹훅을 구성하세요:

1mutation CreateOrderWebhook($input: WebhookCreateInput!) {
2 webhookCreate(input: $input) {
3 id
4 status
5 url
6 }
7}

페이로드에는 type 필드가 포함됩니다. Collect 주문만 처리하려면 payload.type === "COLLECT"를 확인하세요:

javascript

if (payload.type === 'COLLECT') {
}

Dashboard 관리 

견적 및 주문: Collect 견적과 주문은 Dashboard에 "COLLECT" 배지로 표시됩니다. 견적 유형으로 필터링하여 Collect 전용 견적을 확인 및 관리하고 결제 상태를 모니터링할 수 있습니다.

이메일 브랜딩: Dashboard → Settings → Email Templates에서 Collect 결제 카트의 이메일 브랜딩을 조정하세요

수하인 경험 

Collect 견적을 생성하면 고객은 보안 결제 링크가 포함된 자동 이메일을 받습니다. 결제 카트는 상품 가격은 비공개로 유지하면서 관세, 세금, 수수료는 투명하게 표시합니다.

결제 프로세스, 지원되는 국가 및 언어, 커스터마이징 옵션에 대한 자세한 내용은 수하인 경험 가이드를 참조하세요.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentRatingCreateWorkflowInput WebhookCreateInput

MUTATIONS

cartonizeWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentRatingCreateWorkflow webhookCreate

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

지원 받기·법적 문서·© 2026 Zonos
이 페이지에서:
  • Collect 시작하기
  • Collect 견적 생성
  • Dashboard 관리