DOCS

Thanh Toán

Xem thanh toán

Tìm hiểu cách truy cập và hiểu chi tiết thanh toán của bạn cho Checkout.

Dễ dàng truy cập và xem báo cáo thanh toán của bạn trong Zonos Dashboard. Thanh toán được tạo thường xuyên, cung cấp phân tích chi tiết về giao dịch, phí và số tiền ròng khi sử dụng Zonos Checkout. Thanh toán được phát hành bằng tiền tệ địa phương mà bạn đã chọn khi thiết lập tài khoản. Những báo cáo này giúp bạn đối soát hồ sơ tài chính và theo dõi thu nhập của bạn.

Để xem thêm các báo cáo, chẳng hạn như chi tiết đơn hàng và phân tích chi tiết tính toán chi phí hạ cánh, hãy truy cập Báo Cáo. Tìm hiểu cách sử dụng chúng trong Báo cáo có thể tải xuống.

Truy cập dữ liệu thanh toán 

Để tìm và xem thanh toán trong Dashboard:

  1. Đi tới Dashboard -> Thanh Toán.
  2. Chọn thanh toán bạn muốn xem. Nếu nó không xuất hiện ngay lập tức, hãy lọc theo ngày hoặc số tiền để thu hẹp tìm kiếm. (Ngày date là ngày thanh toán được nhận).
  3. Xem tổng quan thanh toán và danh sách giao dịch trong Dashboard.
  4. Để có thêm chi tiết, nhấp Xuất giao dịch để tải xuống tệp CSV của Tóm tắt thanh toán hoặc Chi tiết thanh toán.
    1. Xuất cũ: Định dạng báo cáo cũ vẫn còn trên trang thanh toán riêng lẻ cho đến ngày 31 tháng 7 năm 2025, để giúp chuyển đổi sang báo cáo mới của chúng tôi.

Thanh toán nhiều lần

Để xem thông tin trên nhiều thanh toán:

  1. Đi tới Dashboard -> Thanh Toán.
  2. Nhấp Xuất ở góc trên cùng bên phải.
  3. Chọn loại báo cáo bạn thích: Tóm tắt thanh toán hoặc Chi tiết thanh toán.
  4. Điều chỉnh phạm vi ngày. Phạm vi ngày dựa trên ngày giao dịch đơn hàng (không phải ngày thanh toán được nhận).
  5. Nhấp Tạo báo cáo.

Tổng quan thanh toán 

Trang thanh toán cung cấp chế độ xem cấp cao của thanh toán để bạn có thể nhanh chóng hiểu các chi tiết chính mà không cần phải xuất báo cáo.

Mỗi thanh toán được chia thành bốn thành phần, sau đó được tổng hợp:

  • Thanh toán: Giao dịch nơi tiền được nhận.
  • Hoàn tiền: Giao dịch nơi tiền được hoàn lại.
  • Phí: Khoản phí bị khấu trừ từ thanh toán, chẳng hạn như phí giao dịch hoặc điều chỉnh.
  • Tín dụng: Khoản hoàn lại được áp dụng cho thanh toán của bạn, chẳng hạn như hoàn lại phí tính phí quá mức hoặc các tín dụng khác được cấp cho tài khoản của bạn.
  • Thanh toán trước đó không thành công: Nếu thanh toán trước đó không thành công và được gửi sau với thanh toán tiếp theo, dòng này sẽ bao gồm những chi tiết đó.

Đối với mỗi thành phần, các chi tiết sau được hiển thị:

  • Mục: Tổng số tiền mà khách mua hàng đã thanh toán cho sản phẩm trong kỳ thanh toán.
  • Vận chuyển: Tổng số tiền mà khách mua hàng đã thanh toán cho vận chuyển trong kỳ thanh toán.
  • Chiết khấu: Tổng tiền giảm giá được áp dụng cho đơn hàng trong kỳ thanh toán.
  • Thuế, phí, lệ phí: Tổng số tiền mà khách mua hàng đã thanh toán cho thuế, lệ phí và phí khác trong kỳ thanh toán.
  • Bảo đảm: Tổng số tiền Zonos thu được để bao phủ thuế được bảo đảm, lệ phí và phí, mà Zonos đã trả thay cho bạn. Những chi phí này được Zonos bảo đảm.
  • Phí giao dịch: Tổng phí sử dụng dịch vụ Checkout, bao gồm bảo vệ gian lận (không bao gồm phí xử lý thanh toán).
  • Phí thương nhân: Tổng phí xử lý thanh toán bị khấu trừ từ thanh toán.
  • Khác: Tổng của bất kỳ khoản phí linh tinh nào trong kỳ thanh toán, với ghi chú cung cấp chi tiết.
  • Tổng: Tổng ròng cho thanh toán.

Để biết thêm chi tiết, hãy xuất báo cáo CSV.

Ví dụ thanh toán

Giao dịch trong thanh toán

Mỗi giao dịch trong thanh toán được liệt kê trong phần Giao dịch. Một cách nhanh chóng, các chi tiết sau đây có sẵn cho mỗi giao dịch:

  • Ngày: Ngày giao dịch.
  • Số đơn hàng: Số đơn hàng zonos liên quan đến giao dịch.
  • Mục: Số tiền mà khách mua hàng đã thanh toán cho sản phẩm.
  • Vận chuyển: Số tiền mà khách mua hàng đã thanh toán cho vận chuyển.
  • Chiết khấu: Bất kỳ chiết khấu nào được áp dụng cho đơn hàng.
  • Thuế, phí, lệ phí: Số tiền mà khách mua hàng đã thanh toán cho thuế, lệ phí và phí khác.
  • Bảo đảm: Số tiền Zonos thu để bao phủ thuế được bảo đảm, lệ phí và phí, mà Zonos trả thay cho bạn. Những chi phí này được Zonos bảo đảm.
  • Phí giao dịch: Phí sử dụng dịch vụ Checkout, bao gồm bảo vệ gian lận (không bao gồm phí xử lý thanh toán).
  • Phí thương nhân: Phí xử lý thanh toán.
  • Khác: Khoản phí linh tinh với ghi chú giải thích lý do.
  • Tổng: Tổng ròng cho giao dịch được bao gồm trong thanh toán.

Phân tích chi tiết phí Zonos cho mỗi giao dịch

Nhấp vào số đơn hàng của giao dịch để xem phân tích chi tiết, bao gồm số tiền sản phẩm, chi phí vận chuyển, thuế, lệ phí và phí được liệt kê (chi phí thông qua sẽ không được hiển thị). Nếu không có phí nào xuất hiện, chúng có thể không áp dụng cho giao dịch đó (ví dụ: hoàn tiền hoặc đơn hàng DDU).

Xuất báo cáo CSV 

Bạn có thể xuất hai loại báo cáo—Tóm tắt thanh toánChi tiết thanh toán. So sánh chúng trên trang Báo cáo có thể tải xuống.

Xuất một thanh toán duy nhất

Để xuất CSV của thanh toán cụ thể:

  1. Đi tới Dashboard -> Thanh Toán
  2. Nhấp vào thanh toán cụ thể
  3. Nhấp Xuất giao dịch trên bất kỳ trang thanh toán nào
  4. Chọn giữa Tóm tắt thanh toán hoặc Chi tiết thanh toán
  5. Điều này xuất dữ liệu chỉ cho thanh toán cụ thể đó

Nhiều kỳ thanh toán

Để xuất CSV trải dài nhiều kỳ thanh toán:

  1. Đi tới Dashboard -> Thanh Toán
  2. Nhấp Xuất ở góc trên cùng bên phải
  3. Chọn Tóm tắt thanh toán hoặc Chi tiết thanh toán
  4. Chọn phạm vi ngày của bạn (dựa trên ngày giao dịch đơn hàng)
  5. Nhấp Tạo báo cáo

Ghi chú: Định dạng báo cáo cũ vẫn còn trên các trang thanh toán riêng lẻ cho đến ngày 31 tháng 7 năm 2025, để giúp chuyển đổi sang báo cáo mới của chúng tôi.

Loại báo cáo

Báo cáo tóm tắt thanh toán

Báo cáo tóm tắt thanh toán cung cấp chế độ xem toàn diện về mỗi đơn hàng. Mỗi đơn hàng được liệt kê trên dòng riêng của nó, giúp dễ dàng theo dõi tổng chi phí và phí cho mỗi đơn hàng. Báo cáo này lý tưởng để đối soát nhanh và hiểu số tiền ròng bạn sẽ nhận được cho mỗi đơn hàng. Dưới đây là danh sách các cột trong báo cáo:

CộtMô tả
account_nameTên tài khoản Zonos của bạn
payout_dateNgày thanh toán được xử lý
arrival_dateNgày thanh toán được nhận trong tài khoản của bạn
payout_numberMã định danh duy nhất cho thanh toán
payout_totalTổng số tiền thanh toán
currencyMã tiền tệ cho thanh toán (ví dụ: USD)
transaction_idMã định danh duy nhất cho giao dịch
transaction_dateNgày giao dịch diễn ra
order_numberMã định danh đơn hàng Zonos
order_referenceSố tham chiếu đơn hàng của nền tảng của bạn
order_dateNgày đơn hàng được đặt
transaction_typeLoại giao dịch (ORDER, ORDER_REFUND, ORDER_CANCEL)
item_orderTổng số tiền mà khách mua hàng đã thanh toán cho sản phẩm
shipping_orderTổng số tiền mà khách mua hàng đã thanh toán cho vận chuyển
discount_orderBất kỳ chiết khấu nào được áp dụng cho đơn hàng
duty_tax_fee_orderTổng số tiền mà khách mua hàng đã thanh toán cho thuế, lệ phí và phí khác
guaranteeTổng số tiền Zonos thu được để bao phủ thuế được bảo đảm, lệ phí và phí
transaction_feeTổng phí sử dụng dịch vụ Checkout
merchant_feeTổng phí xử lý thanh toán
otherBất kỳ khoản phí linh tinh nào với ghi chú cung cấp chi tiết
settledSố tiền cuối cùng được xử lý cho đơn hàng
memoThông tin bổ sung về giao dịch

Báo cáo chi tiết thanh toán

Ngoài báo cáo tóm tắt, bạn có thể tải xuống báo cáo chi tiết chi tiết hơn cho mỗi thanh toán. Báo cáo này cung cấp phân tích từng dòng của giao dịch và phí liên quan đến thanh toán. Các chi phí được ước tính (chẳng hạn như thuế mà khách mua hàng thanh toán, mà Zonos giữ lại để trả thay cho thương nhân) không được bao gồm trong báo cáo này. Thường sẽ có nhiều dòng cho mỗi đơn hàng, vì mỗi loại phí được liệt kê trên dòng riêng của nó. Báo cáo chi tiết rất hữu ích để đối soát hồ sơ tài chính của bạn và hiểu các phí liên quan đến mỗi giao dịch.

Loại phí chi tiết thanh toán

Dưới đây là danh sách các mục dòng có thể bạn sẽ thấy trên báo cáo chi tiết thanh toán và mô tả của chúng:

Loại phíLoạiMô tả
ZONOS_MERCHANT_PROCESSINGPhí thanh toán ZonosPhí thương nhân cho xử lý thanh toán.
ZONOS_TRANSACTIONPhí thanh toán ZonosPhí giao dịch Zonos Checkout.
CURRENCY_CONVERSION_FEEPhí thanh toán ZonosPhí bảo hiểm kỳ vọng FX cho rủi ro trao đổi ngoại tệ.
ZONOS_LANDED_COSTPhí thanh toán ZonosPhí Bảo đảm Chi phí Hạ cánh Zonos.
ZONOS_LANDED_COST_GUARANTEEPhí thanh toán ZonosPhí bảo đảm cho tính toán chi phí hạ cánh.
ADVANCEMENTPhí vận chuyểnĐược tính phí bởi nhà cung cấp vận chuyển-xem cột ghi chú Thanh toán để biết thêm chi tiết.
BROKERAGE_FEEPhí vận chuyểnĐược tính phí bởi nhà cung cấp vận chuyển-xem cột ghi chú Thanh toán để biết thêm chi tiết.
SHIPPING_AMOUNTMục tổng đơn hàngTổng vận chuyển trên đơn hàng, được sử dụng để đảm bảo các dòng phí tính tổng đơn hàng.
PRODUCT_AMOUNTMục tổng đơn hàngTổng số tiền trong giỏ hàng trên đơn hàng, được sử dụng để đảm bảo các dòng phí tính tổng đơn hàng.
DUTY_TAX_AMOUNTMục tổng đơn hàngTổng lệ phí/thuế trên đơn hàng trước khi khấu trừ, được sử dụng để đảm bảo các dòng phí tính tổng.
TAXMục tổng đơn hàngTổng thuế trên đơn hàng, được sử dụng để đảm bảo các dòng phí tính tổng. Được giữ lại để nộp thuế.
DUTYMục tổng đơn hàngTổng lệ phí trên đơn hàng, được sử dụng để đảm bảo các dòng phí tính tổng. Được giữ lại để nộp thuế.
GUARANTEE_PERCENTPhí thanh toán ZonosPhí bảo đảm dựa trên phần trăm cho thuế và lệ phí.
GUARANTEE_ORDERPhí thanh toán ZonosPhí bảo đảm lệ định giá cho mỗi đơn hàng.
TRANSACTION_ORDERPhí thanh toán ZonosPhí giao dịch lệ định giá cho mỗi đơn hàng.
TRANSACTION_PERCENTPhí thanh toán ZonosPhí giao dịch dựa trên phần trăm.

Loại Giao dịch

Báo cáo thanh toán bao gồm các loại giao dịch khác nhau:

Loại Giao dịchMô tả
ORDERGiao dịch đơn hàng thường xuyên nơi tiền được nhận.
ORDER_REFUNDGiao dịch nơi tiền được hoàn lại cho khách hàng.
ORDER_CANCELGiao dịch nơi đơn hàng bị hủy trước khi xử lý.
ChargeGiao dịch không liên quan đến đơn hàng và là một khoản phí.
CreditGiao dịch không liên quan đến đơn hàng và là tín dụng.

Lấy chi tiết thanh toán qua API 

Ngoài xuất báo cáo CSV từ Dashboard, bạn có thể lấy dữ liệu chi tiết thanh toán giống nhau theo lập trình thông qua Zonos GraphQL API. Điều này rất hữu ích để tự động đồng bộ dữ liệu thanh toán vào kế toán hoặc hệ thống đối soát của bạn.

Nhận thông báo với webhook ORDER_PAYOUT_DETAILS_READY

Đăng ký webhook ORDER_PAYOUT_DETAILS_READY để được thông báo khi chi tiết dòng mục của thanh toán có sẵn để truy vấn. Nhận nó có nghĩa là phân tích thanh toán là cuối cùng và an toàn để kéo. Webhook cung cấp payoutId bạn sử dụng để tìm nạp chi tiết—nó không nhúng chi tiết chính nó. Xem hướng dẫn webhooks để tìm hiểu cách thiết lập webhooks.

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

Truy vấn chi tiết thanh toán

Chuyển payoutId tới orderPayoutDetails truy vấn. Nó trả về một kết nối được phân trang của OrderPayoutDetailItem dòng mục—một dòng cho mỗi giao dịch—phản ánh báo cáo Chi tiết thanh toán CSV được đề cập trong Xuất báo cáo CSV ở trên.

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}

Kết nối cũng hiển thị trường totalAmount—tổng của amount trên các mục dòng hiển thị cho tổ chức của bạn—để bạn có thể lấy tổng thanh toán mà không cần tính tổng từng trang.

Phân trang thanh toán lớn

Một thanh toán duy nhất có thể chứa nhiều giao dịch. Sử dụng firstafter các đối số để phân trang qua kết quả, theo pageInfo.endCursor cho đến khi pageInfo.hasNextPagefalse.

Trang này có hữu ích không?