Cài đặt Checkout

Mở Checkout trong Tapaya Platform. Trang này hiển thị Organization defaults (mặc định của tổ chức) và liệt kê Checkout merchants (các merchant dùng Checkout) của tổ chức bạn. Chọn một merchant để mở trang cài đặt của merchant đó. Hãy cấu hình merchant tại đây trước khi bạn tích hợp Hosted Checkout hoặc Embedded Checkout.

Mỗi cách tích hợp cần gì

Thực hiện lần lượt từ trên xuống dưới các cài đặt mà tích hợp của bạn sử dụng:

Chế độ nền tảng dùng Secret key của tổ chức từ trang API Keys thay cho checkout key của merchant.

Onboarding merchant cho Checkout

Hoàn tất onboarding merchant với lựa chọn thanh toán trực tuyến, hoặc cả thanh toán trực tuyến lẫn thanh toán tại cửa hàng. Onboarding trực tuyến thu thập website của cửa hàng và thông tin kinh doanh trực tuyến. Một merchant chỉ dùng Checkout không cần máy thanh toán.

Các merchant yêu cầu thanh toán trực tuyến tự động xuất hiện trong Checkout merchants, kể cả những merchant đang chờ phê duyệt. Việc tạo bản ghi merchant hoặc checkout key không đồng nghĩa với việc được phê duyệt thanh toán trực tuyến. Chỉ riêng việc được phê duyệt thanh toán tại cửa hàng không kích hoạt Checkout.

Bảng hiển thị mức độ sẵn sàng của merchant:

Sao chép Merchant token cho chế độ nền tảng, hoặc chọn Settings để cấu hình merchant. Chỉ quản trị viên của tổ chức mới có thể chỉnh sửa cài đặt Checkout.

Tạo checkout key của merchant

Trong Settings của một merchant, mục Merchant checkout keys liệt kê các key dành cho backend riêng của merchant đó. Nhập tên key và chọn Create merchant key. Key bắt đầu bằng tapaya_test_ trong sandbox và tapaya_live_ trong production.

Hãy sao chép secret ngay lập tức. Platform chỉ hiển thị nó một lần và chỉ lưu bản hash. Một key chỉ hoạt động cho merchant của nó. Thu hồi một key để chặn các yêu cầu dùng key đó; các key khác của merchant và các key của tổ chức bạn vẫn hợp lệ. Xem Xác thực Checkout.

Cấu hình đích trả về

Hosted Checkout đưa khách hàng trở lại cửa hàng của bạn sau khi thanh toán hoặc khi họ rời đi. Thanh toán nhúng không dùng URL chuyển hướng.

Đích trả về thuộc về thông tin xác thực đã tạo phiên:

Hai cấu hình này không bao giờ được kết hợp, và không cấu hình nào được dùng làm dự phòng cho cấu hình kia. Một phiên ở chế độ nền tảng chỉ có thể quay về các website được phép của tổ chức, và một phiên tạo bằng key của merchant chỉ có thể quay về các website được phép của merchant. Nếu một phiên bỏ qua successUrl hoặc cancelUrl và thông tin xác thực của nó không có giá trị mặc định, việc tạo phiên sẽ bị từ chối.

Trong phần dành cho thông tin xác thực của bạn, thêm cửa hàng của bạn vào Allowed websites, sau đó đặt Default success URL và Default cancel URL. Ví dụ, một cửa hàng có thể dùng:

• Website được phép: https://shop.example.
• URL thành công: https://shop.example/checkout/return.
• URL hủy: https://shop.example/checkout/cancel.

Một website được phép là một origin: scheme, host và port tùy chọn, không có path, query hoặc fragment. Việc so khớp dùng origin chính xác, bao gồm cả port. Ký tự đại diện (wildcard) và hậu tố tên host không được coi là khớp. Dùng HTTPS cho các cửa hàng đã triển khai; HTTP được chấp nhận cho các host cục bộ.

Một phiên có thể ghi đè các giá trị mặc định bằng successUrl hoặc cancelUrl khi bạn tạo phiên. Các giá trị ghi đè vẫn phải khớp với một website được phép của cùng thông tin xác thực. Một nền tảng phục vụ các merchant trên các path hoặc subdomain khác nhau thường truyền cả hai URL trong mọi phiên.

Trạng thái Ready mô tả việc phê duyệt merchant và thiết lập cổng thanh toán. Nó không xác nhận cấu hình URL trả về của bạn. Thanh toán nhúng không cần URL trả về. Các phiên Hosted Checkout cần giá trị mặc định hoặc các URL được phép tường minh cho thông tin xác thực mà chúng dùng.

Việc truy cập bất kỳ URL trả về nào cũng không chứng minh kết quả thanh toán. Hãy truy xuất phiên từ máy chủ của bạn trước khi đánh dấu đơn hàng là đã thanh toán.

Đặt tên hiển thị với khách hàng

Customer-facing name được hiển thị khi thanh toán và trong ví thanh toán. Để trống để dùng tên pháp lý của merchant. Cài đặt này không thay đổi tên hiển thị trên sao kê ngân hàng.

Ví và giao diện

Mỗi merchant hoặc chọn Use organization wallets and appearance, hoặc tự thiết lập riêng. Công tắc này không ảnh hưởng đến đích trả về, vốn tuân theo thông tin xác thực như mô tả ở trên. Tên merchant và checkout key luôn riêng cho từng merchant.

Organization defaults cho ví và giao diện áp dụng cho mọi merchant sử dụng chúng, và các thay đổi có hiệu lực ngay với những merchant đó:

• Apple Pay và Google Pay. Thẻ luôn được bật.
• Hide powered by Tapaya.
• Checkout color, một mã màu hex sáu chữ số, ví dụ #1380A5.
• Checkout logo, một ảnh PNG hoặc WebP có dung lượng tối đa 5 MB. Việc tải lên và xóa logo được lưu ngay lập tức.

Nếu chưa lưu giá trị mặc định nào, ví sẽ được bật, còn màu sắc và logo được lấy từ thương hiệu của tổ chức bạn.

Nút ví còn phụ thuộc vào thiết bị và trình duyệt của khách hàng. Việc bật một ví không đảm bảo rằng nó xuất hiện ở mọi nơi. Google Pay ở chế độ chính thức yêu cầu đã cấu hình Google Pay merchant ID.

Hosted Checkout dùng tất cả các cài đặt này. Embedded Checkout dùng cài đặt ví và màu checkout đang có hiệu lực làm màu nhấn khi focus của các trường nhập thẻ (colorFocus). Các biến mà trang của bạn truyền trong appearance.variables sẽ ghi đè màu này. Bật các nút ví nhúng trong trang của bạn như mô tả trong Embedded Checkout.

Dùng Checkout preview để xem lại thương hiệu và các phương thức thanh toán trong bố cục máy tính và di động.

Đăng ký tên miền cửa hàng cho Apple Pay

Để dùng Apple Pay trong Embedded Checkout, hãy đăng ký từng tên host của cửa hàng nơi ví xuất hiện. Hosted Checkout chạy trên tên miền của Tapaya. Allowed websites cho chuyển hướng của Hosted Checkout không đăng ký tên miền cho Apple Pay.

1. Mở Settings của merchant, sau đó chọn Apple Pay và Shop domains.
2. Chọn Add domain và tải xuống tệp xác minh.
3. Phục vụ tệp đó nguyên vẹn, không có phần mở rộng, tại https://shop.example/.well-known/apple-developer-merchantid-domain-association. Dùng chứng chỉ HTTPS hợp lệ và phục vụ tệp trực tiếp, không qua chuyển hướng.
4. Nhập tên host, ví dụ shop.example, và chọn Verify and add. Đăng ký riêng www.shop.example nếu khách hàng cũng dùng tên miền này.
5. Chờ đến khi tên miền hiển thị Active, sau đó bật Apple Pay. Dùng Check now để chẩn đoán một tên miền đang gặp lỗi.

Giữ tệp xác minh luôn truy cập được sau khi đăng ký. Mỗi merchant cần đăng ký tên miền riêng, kể cả khi ví và giao diện lấy từ mặc định của tổ chức. Merchant cần có cổng thanh toán đã được cấu hình trước khi có thể đăng ký tên miền.

Trang này còn thiếu điều gì?Đề xuất tính năng. Chúng tôi sẽ đính kèm trang này để đội ngũ nắm được bối cảnh.