Nhảy đến nội dung

Stripe

Hướng dẫn kết nối Stripe

Tạo tài khoản thanh toán với loại Stripe​

Cách tạo tài khoản thanh toán được mô tả tại đây.

Kết nối Stripe với tài khoản thanh toán​

Để làm điều này, hãy truy cập vào tài khoản thanh toán đã tạo và nhấn Kết nối Stripe

IMG1

Bạn sẽ được chuyển hướng đến trang kết nối Stripe. Điền thông tin công ty, chọn loại hình và địa điểm kinh doanh, xác nhận đại diện tài khoản và cung cấp thông tin ngân hàng để nhận thanh toán. Sau khi hoàn tất đăng ký, bạn sẽ quay lại CMS, và tài khoản thanh toán sẽ hiển thị trạng thái Stripe connected.

Sau khi kết nối, hãy chuyển đến Developers → Webhooks trong Bảng điều khiển Stripe và nhấn Thêm điểm đến.

Thực hiện các bước trong trình hướng dẫn tạo điểm đến sự kiện: chọn các sự kiện để lắng nghe, chọn loại điểm đến (webhook endpoint), và ở bước cấu hình, trong trường Endpoint URL, hãy chỉ định địa chỉ webhook của chúng tôi. Thay thế test-project.oneentry.cloud bằng địa chỉ dự án của bạn:

https://test-project.oneentry.cloud/api/content/payments/webhook/stripe

Đặt tên cho điểm đến và hoàn tất việc tạo — điểm cuối mới sẽ xuất hiện trong danh sách Điểm đến sự kiện với trạng thái Hoạt động.

Để OneEntry kiểm tra tính xác thực của các sự kiện đến từ Stripe, hãy sao chép bí mật chữ ký (Signing secret) của điểm cuối đã tạo trong Bảng điều khiển Stripe. Nó sẽ cần thiết trong cài đặt tài khoản thanh toán.

Sau khi thêm webhook, hãy truy cập vào CMS trong Payments → Trạng thái, chọn kho lưu trữ đơn hàng và vào cài đặt của nó

IMG10

Thêm cập nhật tự động trạng thái thanh toán cho đơn hàng. Bên trái là trạng thái đơn hàng, và bên phải là các trạng thái đơn hàng của bạn, đã được thêm trước đó trong phần đơn hàng

IMG7

Điền vào cài đặt tài khoản​

Mở tài khoản thanh toán để chỉnh sửa. Trong khối Chi tiết, hãy chỉ định:

  • Success URL — địa chỉ mà khách hàng sẽ quay lại sau khi thanh toán thành công. Trường này là bắt buộc.
  • Cancel URL — địa chỉ mà khách hàng sẽ quay lại khi hủy thanh toán.
  • Session timeout — thời gian sống của phiên thanh toán. Giá trị phải là một số nguyên lớn hơn 0.
  • Use Stripe webhook data validation — kích hoạt kiểm tra tính xác thực của dữ liệu mà Stripe gửi đến webhook.
  • Key for validating Stripe webhook — bí mật chữ ký của endpoint từ Bảng điều khiển Stripe. Trường này chỉ khả dụng khi đã đánh dấu Use Stripe webhook data validation, và trong trường hợp này là bắt buộc.

Các thay đổi sẽ được lưu tự động.

IMG11

Trong tài khoản thanh toán có hỗ trợ chế độ thử nghiệm. Chức năng này cho phép thử nghiệm kết nối Stripe với các tham số kết nối thử nghiệm.

IMG11

Để tắt chế độ thử nghiệm, hãy bỏ chọn ô đánh dấu