Chuẩn bị hệ thống cho Shop Cash

Trước khi ra mắt dòng công việc Shop Cash với hệ thống của bên thứ ba, hãy xác nhận các yêu cầu sau:

• Hệ thống ERP, OMS, hệ thống hoàn tất đơn hàng, kế toán và xử lý đơn hàng trả lại có thể chấp nhận nhiều phương thức thanh toán trên một đơn hàng.
• shop_cash được ánh xạ thành phương thức thanh toán tại nơi có các giá trị cổng thanh toán.
• Shop Cash không được xử lý như khoản chiết khấu, thẻ quà tặng hoặc tín dụng cửa hàng.
• Giá trị ủy quyền được lưu trữ dưới dạng chuỗi có độ dài thay đổi không rõ định dạng (opaque) với ít nhất 1024 ký tự. Nếu có thể, hãy sử dụng trường văn bản không giới hạn.
• Các giao dịch thu, hủy giá trị và hoàn tiền được xác định bằng ID giao dịch thay vì giá trị ủy quyền. Thao tác thu và hủy giá trị của Admin API sử dụng parentTransactionId, còn thao tác hoàn tiền sử dụng parentId.
• Hệ thống không phân tích cú pháp, giải mã, chuẩn hóa, băm hoặc cắt bớt giá trị ủy quyền Shop Cash.
• Hệ thống có thể xử lý các khoản thanh toán được nhóm lại, trong đó một dòng shop_cash_credit có thể đại diện cho nhiều đơn hàng.
• Dòng công việc đối soát không mặc định một đơn hàng tương ứng với một dòng thanh toán.
• Dòng công việc đối soát có thể xử lý khoản của Shop Cash và khoản của thẻ hoặc Shop Pay Trả góp được quyết toán vào các đợt thanh toán khác nhau.
• Dòng công việc hoàn tiền có thể xử lý khoản hoàn tiền một phần bằng thẻ hoặc Shop Pay Trả góp và Shop Cash.
• Ứng dụng xử lý đơn hàng trả lại có thể hoàn tiền cho giao dịch thu từ Shop Cash, không phải giao dịch ủy quyền.
• Nếu đã chạy Shop Campaigns trước tháng 1 năm 2026, dòng công việc tài chính sẽ xử lý dòng shop_cash_campaign_billing_debit cũ và các dòng lập hóa đơn chiến dịch liên quan tách biệt với doanh thu đơn hàng. Kể từ tháng 1 năm 2026 trở đi, chi phí chiến dịch sẽ được tính vào hóa đơn Shopify.

Việc thử nghiệm Shop Cash có những giới hạn vì hệ thống này phụ thuộc vào tài khoản người mua trên Shop, số dư Shop Cash, Shopify Payments và cơ sở hạ tầng quyết toán Shop Cash.

Cách đáng tin cậy nhất để xác thực toàn diện tiện ích tích hợp cấp doanh nghiệp là đặt một đơn hàng thực tế giá trị thấp qua Shop, sau đó hoàn tiền. Việc này tạo ra giao dịch đơn hàng, dữ liệu thu, hoạt động thanh toán, giao dịch hoàn tiền và hoạt động ghi nợ hoàn tiền giống thực tế, truyền qua Shopify admin, dữ liệu Admin API, tệp xuất thanh toán và dữ liệu API thanh toán.

Cửa hàng thử nghiệm có thể giúp xác thực một số cấu trúc trường API và logic ánh xạ, nhưng không thể kiểm tra đáng tin cậy toàn bộ luồng quyết toán, số dư của người mua và quy trình trên trang thanh toán bắt nguồn từ Shop. Chế độ thử nghiệm và cổng Bogus không tạo ra các dòng thanh toán Shop Cash thực tế vì không sử dụng luồng quyết toán Shopify Payments trực tiếp.

Thường có thể thử nghiệm các dòng công việc sau bằng một đơn hàng thực tế giá trị thấp bắt nguồn từ Shop:

• Tiếp nhận đơn hàng đối với đơn hàng có nhiều phương thức thanh toán, bao gồm Shop Cash và Shop Pay hoặc Shop Pay Trả góp.
• Ánh xạ hệ thống ERP hoặc OMS cho shop_cash.
• Lưu trữ toàn bộ giá trị ủy quyền Shop Cash.
• Hoàn tiền toàn bộ và một phần cho đơn hàng.
• Tiếp nhận hoạt động thanh toán shop_cash_refund_debit.
• Đối soát thanh toán cho tín dụng Shop Cash.
• Hành vi đối với đơn hàng đặt trước hoặc thu tiền khi hoàn tất đơn hàng, nếu cửa hàng sử dụng phương thức thu tiền chậm.
• Cách ứng dụng xử lý đơn hàng trả lại hoạt động đối với đơn hàng có nhiều hơn một phương thức thanh toán.

Khi thử nghiệm trên môi trường thực tế, hãy dùng đơn hàng giá trị thấp và làm theo các thủ tục hoàn tiền và đơn hàng đặt thử nội bộ của cửa hàng.

Liên hệ với Bộ phận Hỗ trợ Shopify nếu cần trợ giúp với bất kỳ trường hợp nào sau đây:

• Xem xét tính khả dụng của Shop Cash cho một thị trường đang trong quá trình triển khai.
• Điều tra giao dịch hoàn tiền hoặc thu tiền qua Shop Cash bị lỗi.
• Điều tra giao dịch thanh toán Shop Cash bị thiếu sau chu kỳ thanh toán thông thường cộng thêm một chu kỳ thanh toán bổ sung.
• Xem xét xem có thể ủy quyền lại cho một khoản ủy quyền Shop Cash đã hết hạn hoặc bị hủy giá trị không.
• Lập kế hoạch ra mắt cho dòng công việc hoàn tất đơn hàng, đơn hàng đặt trước, OMS hoặc ERP phức tạp.

Trước khi mở rộng quy mô khối lượng đơn hàng Shop Cash, hãy hoàn tất các bước kiểm tra sau:

• Ánh xạ phương thức thanh toán trong ERP và OMS đã được triển khai và xác minh cho shop_cash.
• Đơn hàng Shop Cash mẫu được tiếp nhận toàn diện, bao gồm cả các giao dịch ủy quyền và thu tiền.
• Tín dụng thanh toán Shop Cash mẫu được đối soát với một hoặc nhiều đơn hàng gốc.
• Khoản hoàn tiền Shop Cash mẫu được xử lý và đối soát với khoản ghi nợ hoàn tiền.
• Hệ thống hỗ trợ các dòng thanh toán Shop Cash được nhóm lại hoặc có quy trình đối soát thủ công.
• Nhóm hỗ trợ và tài chính hiểu rõ cách phân bổ khoản hoàn tiền một phần.
• Hành vi đối với đơn hàng đặt trước, thu tiền thủ công và thu tiền khi hoàn tất đơn hàng đã được xác thực, nếu áp dụng.
• Ứng dụng xử lý đơn hàng trả lại có thể xác định và hoàn tiền đúng giao dịch thu tiền Shop Cash.
• Nhóm hỗ trợ và tài chính hiểu rõ sự khác biệt giữa số dư Shop Cash của khách hàng, ưu đãi của Shop và hoạt động lập hóa đơn Shop Campaigns.

Để biết yêu cầu về API và dữ liệu đơn hàng, hãy xem mục Dữ liệu đơn hàng Shop Cash và các tiện ích tích hợp của bên thứ ba. Để biết yêu cầu về thanh toán, hãy xem mục Đối soát thanh toán Shop Cash.