DOCS
Checkout•
홈글로벌 이커머스 Billing Payout

Payout 보기

Checkout payout 세부 정보에 액세스하고 이해하는 방법을 알아보세요.

Zonos Dashboard에서 payout 보고서에 쉽게 액세스하고 확인할 수 있습니다. Payout은 정기적으로 생성되며, Zonos Checkout 사용 시 거래, 수수료, 순 금액의 상세 내역을 제공합니다. Payout은 계정 설정 시 선택한 현지 통화로 발행됩니다. 이러한 보고서는 재무 기록 대조와 수익 추적에 도움이 됩니다.

주문 세부 정보 및 landed cost 계산 내역 등 추가 보고서는 Reports를 방문하세요. Downloadable reports에서 사용 방법을 알아보세요.

Payout 데이터 액세스 

Dashboard에서 payout을 찾고 보려면 다음을 수행합니다.

  1. Dashboard -> Payouts로 이동합니다.
  2. 보려는 payout을 선택합니다. 바로 표시되지 않으면 날짜 또는 금액으로 필터링하여 검색 범위를 좁힙니다. (date는 payout 도착 날짜입니다).
  3. Dashboard에서 payout 개요와 거래 목록을 확인합니다.
  4. 자세한 내용은 Export transactions를 클릭하여 Payout summary 또는 Payout details CSV 파일을 다운로드합니다.
    1. Legacy export: 새 보고서로의 전환을 돕기 위해 레거시 보고서 형식은 2025년 7월 31일까지 개별 payout 페이지에서 계속 이용할 수 있습니다.

여러 payout

여러 payout에 걸친 정보를 보려면 다음을 수행합니다.

  1. Dashboard -> Payouts로 이동합니다.
  2. 오른쪽 상단에서 Export를 클릭합니다.
  3. 원하는 보고서 유형을 선택합니다. Payout summary 또는 Payout details.
  4. 날짜 범위를 조정합니다. 날짜 범위는 주문 거래 날짜를 기준으로 합니다(payout 도착 날짜가 아님).
  5. Generate report를 클릭합니다.

Payout 개요 

payout 페이지는 보고서를 내보내지 않고도 주요 세부 정보를 빠르게 이해할 수 있는 고수준 보기를 제공합니다.

각 payout은 네 가지 구성 요소로 나뉜 후 합산됩니다.

  • Payments: 자금을 수령한 거래입니다.
  • Refunds: 자금을 반환한 거래입니다.
  • Charges: transaction fee 또는 adjustment 등 payout에서 차감된 수수료입니다.
  • Credits: 과청구 수수료 환불 등 payout에 적용된 reimbursement입니다.
  • Failed previous payout: 이전 payout이 실패하여 후속 payout과 함께 전송된 경우 이 행에 해당 세부 정보가 포함됩니다.

각 구성 요소에 대해 다음 세부 정보가 표시됩니다.

  • Items: payout 기간 내 쇼퍼가 상품에 지불한 총액입니다.
  • Shipping: payout 기간 내 쇼퍼가 배송에 지불한 총액입니다.
  • Discount: payout 기간 내 주문에 적용된 할인 총액입니다.
  • Duty, taxes, fees: payout 기간 내 쇼퍼가 관세, 세금, 기타 수수료에 지불한 총액입니다.
  • Guarantee: Zonos가 대신 지불한 guaranteed duties, taxes, fees를 커버하기 위해 Zonos가 회수한 총액입니다. 이러한 비용은 Zonos가 guarantee합니다.
  • Transaction fee: fraud protection을 포함한 Checkout 서비스 이용 총 수수료입니다(결제 처리 수수료 제외).
  • Merchant fee: payout에서 차감된 결제 처리 수수료 총액입니다.
  • Other: payout 기간 내 기타 miscellaneous charge 총액이며, memo에 세부 정보가 제공됩니다.
  • Total: payout의 순 총액입니다.

자세한 내용은 CSV report를 내보내세요.

Payout example

Payout 내 거래

payout 내 각 거래는 Transactions 섹션에 나열됩니다. 거래당 다음 세부 정보를 한눈에 확인할 수 있습니다.

  • Date: 거래 날짜입니다.
  • Order number: 거래와 연결된 Zonos order number입니다.
  • Items: 쇼퍼가 상품에 지불한 금액입니다.
  • Shipping: 쇼퍼가 배송에 지불한 금액입니다.
  • Discount: 주문에 적용된 할인입니다.
  • Duty, taxes, fees: 쇼퍼가 관세, 세금, 기타 수수료에 지불한 금액입니다.
  • Guarantee: Zonos가 대신 지불하는 guaranteed duties, taxes, fees를 커버하기 위해 Zonos가 회수하는 금액입니다. 이러한 비용은 Zonos가 guarantee합니다.
  • Transaction fee: fraud protection을 포함한 Checkout 서비스 이용 수수료입니다(결제 처리 수수료 제외).
  • Merchant fee: 결제 처리 수수료입니다.
  • Other: 사유를 설명하는 memo가 있는 miscellaneous charge입니다.
  • Total: payout에 포함된 거래의 순 총액입니다.

거래별 Zonos 수수료 내역

거래의 order number를 클릭하면 상품 금액, 배송 비용, 관세, 세금, 항목별 수수료를 포함한 상세 내역을 볼 수 있습니다(passthrough costs는 표시되지 않음). 수수료가 표시되지 않으면 해당 거래에 적용되지 않을 수 있습니다(예: refund 또는 DDU 주문).

CSV 보고서 내보내기 

Payout summary와 Payout detail 두 가지 보고서를 내보낼 수 있습니다. Downloadable reports 페이지에서 비교하세요.

단일 payout 내보내기

특정 payout의 CSV를 내보내려면 다음을 수행합니다.

  1. Dashboard -> Payouts로 이동합니다.
  2. 특정 payout을 클릭합니다.
  3. payout 페이지에서 Export transactions를 클릭합니다.
  4. Payout summary 또는 Payout detail 중 선택합니다.
  5. 해당 payout의 데이터만 내보냅니다.

여러 payout 기간

여러 payout 기간에 걸친 CSV를 내보내려면 다음을 수행합니다.

  1. Dashboard -> Payouts로 이동합니다.
  2. 오른쪽 상단에서 Export를 클릭합니다.
  3. Payout summary 또는 Payout detail을 선택합니다.
  4. 날짜 범위를 선택합니다(주문 거래 날짜 기준).
  5. Generate report를 클릭합니다.

Note: 새 보고서로의 전환을 돕기 위해 레거시 보고서 형식은 2025년 7월 31일까지 개별 payout 페이지에서 계속 이용할 수 있습니다.

보고서 유형

Payout summary 보고서

Payout summary report는 각 주문의 포괄적인 보기를 제공합니다. 각 주문이 한 행으로 나열되어 개별 주문 총액과 수수료를 쉽게 추적할 수 있습니다. 이 보고서는 빠른 대조와 주문별로 받을 순 금액을 이해하는 데 적합합니다. 아래는 보고서의 열 목록입니다.

필드↕설명↕
account_nameZonos 계정 이름
payout_datepayout 처리 날짜
arrival_date계정 도착 날짜
payout_numberpayout 고유 식별자
payout_totalpayout 총액
currencypayout 통화 코드(예: USD)
transaction_id거래 고유 식별자
transaction_date거래 발생 날짜
order_numberZonos order identifier
order_referenceplatform의 주문 참조 번호
order_date주문 날짜
transaction_type거래 유형(ORDER, ORDER_REFUND, ORDER_CANCEL)
item_order쇼퍼가 상품에 지불한 총액
shipping_order쇼퍼가 배송에 지불한 총액
discount_order주문에 적용된 할인
duty_tax_fee_order쇼퍼가 관세, 세금, 기타 수수료에 지불한 총액
guaranteeZonos가 guaranteed duties, taxes, fees를 커버하기 위해 회수한 총액
transaction_feeCheckout 서비스 이용 총 수수료
merchant_fee결제 처리 수수료 총액
othermemo에 세부 정보가 있는 miscellaneous charge
settled주문의 최종 settled 금액
memo거래에 대한 추가 정보

Payout detail 보고서

summary report 외에도 각 payout에 대한 더 상세한 details report를 다운로드할 수 있습니다. 이 보고서는 payout과 관련된 거래 및 수수료의 line-by-line 내역을 제공합니다. net되는 비용(쇼퍼가 지불하고 Zonos가 판매자 대신 납부하는 세금 등)은 이 보고서에 포함되지 않습니다. 각 charge type이 별도 행으로 나열되므로 주문당 여러 행이 있는 경우가 많습니다. details report는 재무 기록 대조와 각 거래 관련 수수료 이해에 유용합니다.

Payout detail 청구 유형

payout detail report에 표시될 수 있는 line item과 설명 목록입니다.

청구 유형↕유형↕설명↕
ZONOS_MERCHANT_PROCESSINGZonos 청구 수수료결제 처리 merchant fee입니다.
ZONOS_TRANSACTIONZonos 청구 수수료Zonos Checkout transaction fee입니다.
CURRENCY_CONVERSION_FEEZonos 청구 수수료외환 리스크에 대한 FX forward premium입니다.
ZONOS_LANDED_COSTZonos 청구 수수료Zonos Landed Cost Guarantee fee입니다.
ZONOS_LANDED_COST_GUARANTEEZonos 청구 수수료landed cost 계산 guarantee fee입니다.
ADVANCEMENT캐리어 수수료배송 캐리어 청구—자세한 내용은 Payout memo 열을 참조하세요.
BROKERAGE_FEE캐리어 수수료배송 캐리어 청구—자세한 내용은 Payout memo 열을 참조하세요.
SHIPPING_AMOUNT주문 소계 항목주문 배송 총액. charge line이 주문 총액과 일치하도록 사용됩니다.
PRODUCT_AMOUNT주문 소계 항목주문 cart 총액. charge line이 주문 총액과 일치하도록 사용됩니다.
DUTY_TAX_AMOUNT주문 소계 항목withholding 전 주문 관세/세금 총액. charge line이 주문 총액과 일치하도록 사용됩니다.
TAX주문 소계 항목주문 세금 총액. charge line이 주문 총액과 일치하도록 사용됩니다. tax remittance를 위해 withheld됩니다.
DUTY주문 소계 항목주문 관세 총액. charge line이 주문 총액과 일치하도록 사용됩니다. tax remittance를 위해 withheld됩니다.
GUARANTEE_PERCENTZonos 청구 수수료관세 및 세금에 대한 percentage-based guarantee fee입니다.
GUARANTEE_ORDERZonos 청구 수수료주문당 flat-rate guarantee fee입니다.
TRANSACTION_ORDERZonos 청구 수수료주문당 flat-rate transaction fee입니다.
TRANSACTION_PERCENTZonos 청구 수수료percentage-based transaction fee입니다.

거래 유형

payout 보고서에는 다양한 거래 유형이 포함됩니다.

거래 유형↕설명↕
ORDER자금을 수령한 일반 주문 거래입니다.
ORDER_REFUND고객에게 자금을 반환한 거래입니다.
ORDER_CANCEL처리 전 취소된 주문 거래입니다.
Charge주문과 연결되지 않은 charge 거래입니다.
Credit주문과 연결되지 않은 credit 거래입니다.

API로 payout 세부 정보 가져오기 

Dashboard에서 CSV 보고서를 내보내는 것 외에도 Zonos GraphQL API를 통해 동일한 payout detail breakdown을 프로그래밍 방식으로 가져올 수 있습니다. 자체 회계 또는 대조 시스템에 payout 데이터를 자동 동기화하는 데 유용합니다.

ORDER_PAYOUT_DETAILS_READY webhook으로 알림 받기

ORDER_PAYOUT_DETAILS_READY webhook을 구독하면 payout의 line-item 세부 정보를 쿼리할 수 있을 때 알림을 받을 수 있습니다. 수신은 breakdown이 확정되어 안전하게 가져올 수 있음을 의미합니다. webhook은 세부 정보를 가져오는 데 사용하는 payoutId를 전달하며, 세부 정보 자체는 포함하지 않습니다. webhooks guide에서 webhook 설정 방법을 알아보세요.

1{
2 "payoutId": "payout_xxxxxxxxxxxxx",
3 "eventType": "ORDER_PAYOUT_DETAILS_READY"
4}

Payout 세부 정보 쿼리

payoutId를 orderPayoutDetails 쿼리에 전달합니다. 거래당 한 행의 OrderPayoutDetailItem line items 페이지네이션 connection을 반환하며, 위 Export CSV reports에서 설명한 Payout detail CSV report를 반영합니다.

1query OrderPayoutDetails($payoutId: String!, $first: Int, $after: String) {
2 orderPayoutDetails(payoutId: $payoutId, first: $first, after: $after) {
3 totalAmount
4 edges {
5 cursor
6 node {
7 accountName
8 payoutDate
9 arrivalDate
10 payoutNumber
11 currency
12 transactionId
13 transactionDate
14 orderNumber
15 orderReference
16 orderDate
17 transactionType
18 detailType
19 payee
20 payor
21 amount
22 memo
23 }
24 }
25 pageInfo {
26 hasNextPage
27 endCursor
28 }
29 }
30}

connection은 totalAmount 필드도 노출하며, 조직에 표시되는 line items의 amount 합계를 제공하므로 모든 페이지를 직접 합산하지 않고 payout 총액을 얻을 수 있습니다.

대규모 payout 페이지네이션

단일 payout에 많은 거래가 포함될 수 있습니다. first 및 after 인수를 사용하여 결과를 페이지네이션하고 pageInfo.hasNextPage가 false가 될 때까지 pageInfo.endCursor를 따르세요.

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

지원 받기·법적 문서·© 2026 Zonos
이 페이지에서:
  • Payout 보기
  • Payout 데이터 액세스
  • Payout 개요
  • CSV 보고서 내보내기
  • API로 payout 세부 정보 가져오기