Kết nối Stripe với ứng dụng MonstarX của bạn

Nhận thanh toán bằng thẻ, gói đăng ký và quy trình thanh toán ngay trong ứng dụng.

Loại

Cho ứng dụng của bạn

Danh mục

Thanh toán và hóa đơn

Kết nối bằng

Khóa API

Stripe là công ty thanh toán: Stripe lo biểu mẫu nhập thẻ, phần làm việc với ngân hàng và biên nhận, rồi chuyển tiền về tài khoản ngân hàng của bạn. Kết nối Stripe, và ứng dụng của bạn bán được hàng — một gói buổi tập, một sản phẩm, một gói hội viên hằng tháng — qua trang thanh toán an toàn do Stripe vận hành.

Bạn xây dựng được gì với Stripe?

• Nút “Mua ngay” mở trang thanh toán của Stripe và đưa khách trở lại ứng dụng sau khi trả tiền xong.
• Gói buổi tập và combo, như “5 buổi tập giá $90”, mở khóa một quyền lợi trong ứng dụng sau khi thanh toán.
• Gói đăng ký hằng tháng hoặc hằng năm cho hội viên hoặc cho một gói trả phí.
• Lịch sử đơn hàng cho từng khách hàng, và một trang quản trị liệt kê các khoản thanh toán.
• Tự động xử lý tiếp, như đánh dấu đơn hàng đã thanh toán và gửi email biên nhận, khi Stripe xác nhận thanh toán.

Trước khi bắt đầu

• Một tài khoản Stripe. Tạo tài khoản là miễn phí; Stripe thu phí trên mỗi khoản thanh toán thành công (xem bảng giá Stripe). MonstarX không thu thêm gì.
• Để kiểm thử, bạn không cần gì thêm: tài khoản Stripe nào cũng dùng được sandbox (môi trường thử nghiệm) — một bản sao để tập dượt của tài khoản, nơi không có tiền thật nào được chuyển.
• Để nhận thanh toán thật, Stripe yêu cầu bạn kích hoạt tài khoản trước — thông tin doanh nghiệp và tài khoản ngân hàng nhận tiền.

Môi trường thử nghiệm và môi trường chính thức là gì?

Stripe cho bạn hai bộ khóa, và MonstarX hỏi bạn đang dán bộ nào qua lựa chọn Môi trường:

Môi trường	Khóa bắt đầu bằng	Điều gì xảy ra
Môi trường thử nghiệm (khóa kiểm thử)	sk_test_… và pk_test_…	Thanh toán giả với số thẻ kiểm thử. Không thẻ thật nào bị trừ tiền và không có tiền nào được chuyển. Dùng trong lúc xây dựng.
Môi trường chính thức (khóa thật)	sk_live_… và pk_live_…	Thẻ thật, tiền thật, chuyển về ngân hàng của bạn. Dùng khi khách hàng thật trả tiền.

Những gì bạn tạo ở môi trường này không tồn tại ở môi trường kia: sản phẩm, giá, khách hàng và khoản thanh toán tạo trong môi trường thử nghiệm chỉ nằm trong môi trường thử nghiệm.

Làm sao để thanh toán bằng thẻ kiểm thử?

Trong môi trường thử nghiệm, trang thanh toán của Stripe chấp nhận các thẻ kiểm thử Stripe công bố. Dùng ngày hết hạn bất kỳ trong tương lai (như 12/34), mã CVC ba chữ số bất kỳ và mã bưu chính bất kỳ:

Số thẻ	Kết quả
4242 4242 4242 4242	Thanh toán thành công.
4000 0000 0000 0002	Thẻ bị từ chối, để bạn xem khách hàng thấy gì khi thanh toán thất bại.
4000 0025 0000 3155	Ngân hàng yêu cầu xác minh thêm (3D Secure) trước khi thanh toán hoàn tất.

Đừng bao giờ nhập số thẻ thật vào trang thanh toán thử nghiệm. Stripe liệt kê thêm thẻ kiểm thử trong hướng dẫn kiểm thử.

Lấy khóa API

1. Đăng nhập Stripe Dashboard.

2. Để kiểm thử, mở một sandbox từ menu tài khoản ở góc trên bên trái. Để chạy thật, chuyển sang live mode.

3. Mở API keys (trong Developers). Sao chép Publishable key, rồi hiện và sao chép Secret key.

Chú ý

Khóa bí mật có thể thu tiền và hoàn tiền trên tài khoản của bạn. Chỉ dán khóa vào biểu mẫu trình kết nối của MonstarX — không bao giờ dán vào cuộc trò chuyện, email hay mã nguồn ứng dụng. Khóa bí mật live chỉ hiển thị một lần, nên hãy cất ở nơi an toàn.

Kết nối trong MonstarX

Khi bạn yêu cầu tính năng thanh toán, MonstarX thường hiển thị thẻ Kết nối Stripe trong cuộc trò chuyện với đúng các trường này. Bạn cũng có thể tự kết nối:

1. Mở dự án, nhấp vào Dịch vụ đám mây trên thanh trên cùng, rồi chọn Đám mây.

2. Trong mục Trình kết nối, nhấp vào Kết nối bên cạnh Stripe.

3. Chọn Môi trường: Môi trường thử nghiệm (khóa kiểm thử) hoặc Môi trường chính thức (khóa thật).

4. Dán Khóa bí mật và Khóa công khai. Tạm để trống Giá trị bí mật ký webhook.

   

5. Nhấp vào Kết nối Stripe. Dòng này hiện Đã kết nối · môi trường thử nghiệm (hoặc Đã kết nối · môi trường chính thức) và bản xem trước khởi động lại với khóa mới.

MonstarX không kiểm tra xem khóa có khớp với môi trường bạn chọn không, nên hãy chắc chắn khóa sk_test_ đi với Môi trường thử nghiệm và khóa sk_live_ đi với Môi trường chính thức.

Tôi có cần giá trị bí mật ký webhook không?

Webhook là cách Stripe báo cho ứng dụng “khoản thanh toán này đã thành công”, kể cả khi khách đóng trang trước khi quay lại. Ứng dụng mở khóa quyền lợi sau khi thanh toán, hoặc chạy gói đăng ký, nên có webhook. Hãy thêm sau khi ứng dụng đã xuất bản, vì Stripe không với tới được bản xem trước riêng tư của bạn:

1. Hỏi MonstarX: “Địa chỉ webhook Stripe của tôi là gì, và webhook cần nghe những sự kiện nào?” Địa chỉ thường là https://your-app.monstarx.app/api/stripe-webhook.

2. Trong Stripe, mở Webhooks, nhấp vào Create an event destination, chọn các sự kiện đó, chọn Webhook endpoint rồi dán địa chỉ.

3. Hiện signing secret (bắt đầu bằng whsec_) và sao chép.

4. Trong MonstarX, nhấp vào Cập nhật khóa trên dòng Stripe, dán vào Giá trị bí mật ký webhook rồi nhấp vào Lưu khóa. Xuất bản lại để ứng dụng đang hoạt động nhận được giá trị này.

Môi trường thử nghiệm và live mode có webhook và signing secret riêng.

Nhờ MonstarX dùng Stripe

Bạn nhập	Điều gì xảy ra
“Cho hội viên mua gói 5 buổi tập giá $90 qua Stripe.”	Một nút mua, trang thanh toán Stripe đúng số tiền đó và một trang cảm ơn; gói buổi tập được cộng vào sau khi thanh toán.
“Thêm gói Pro hằng tháng giá $12 qua Stripe, và một trang để xem gói của tôi.”	Trang thanh toán gói đăng ký và một trang hiển thị gói của hội viên.
“Thêm trang quản trị liệt kê mọi khoản thanh toán.”	Một trang liệt kê các khoản thanh toán: ai trả, trả cho gì và khi nào.
“Nhập sản phẩm Stripe của tôi vào cửa hàng.”	MonstarX cần khóa của bạn để đọc tài khoản, nên thẻ hiển thị MonstarX cần Stripe để tiếp tục và MonstarX tự tiếp tục ngay khi bạn kết nối.

Chưa có khóa? Nhấp vào Để sau trên thẻ. MonstarX vẫn xây dựng toàn bộ phần thanh toán, và nút thanh toán sẽ báo Stripe chưa được kết nối cho đến khi bạn thêm khóa.

Chạy thật

1. Kích hoạt tài khoản Stripe, chuyển sang live mode và sao chép khóa live.

2. Trong Dịch vụ đám mây›Đám mây, nhấp vào Cập nhật khóa trên dòng Stripe.

3. Đặt Môi trường thành Môi trường chính thức (khóa thật), dán cả hai khóa live (và giá trị bí mật ký webhook live, nếu bạn dùng) rồi nhấp vào Lưu khóa.

4. Xuất bản lại ứng dụng. Từ giờ, mọi khoản thanh toán đều là thật.

Mẹo

Hãy tự thanh toán thật một khoản nhỏ, rồi hoàn tiền từ Stripe Dashboard. Đây là cách nhanh nhất để kiểm tra mọi thứ chạy ổn ở live mode.

Bảo mật và quyền riêng tư

• Khóa được lưu mã hóa, chỉ cùng ứng dụng này. Tên khóa hiện trong Dịch vụ đám mây›Giá trị bí mật; giá trị thì không bao giờ hiển thị lại.
• Khóa bí mật và giá trị bí mật ký webhook chỉ được máy chủ của ứng dụng dùng. Khóa công khai được làm ra để hiển thị trong trình duyệt, và điều đó an toàn.
• Số thẻ được nhập vào trang thanh toán của chính Stripe. Số thẻ không bao giờ tới ứng dụng của bạn hay MonstarX.
• Chỉ chủ sở hữu dự án mới kết nối, cập nhật hoặc ngắt kết nối được Stripe. Ngắt kết nối xóa khóa khỏi ứng dụng này; khi đó trang thanh toán sẽ báo Stripe chưa được kết nối.
• Nếu khóa bị lộ, hãy đổi khóa (roll) trong Stripe Dashboard và dán khóa mới bằng Cập nhật khóa.

Điều nên biết

• Mỗi ứng dụng dùng một môi trường Stripe tại một thời điểm. Chuyển một ứng dụng đang chạy thật về khóa thử nghiệm sẽ dừng thanh toán thật cho đến khi bạn chuyển lại.
• Stripe còn có restricted keys (rk_…) chỉ mang những quyền bạn chọn. Khóa này dùng được trong trường Khóa bí mật nếu cho phép mọi việc ứng dụng cần làm, như tạo phiên thanh toán (checkout session).
• Kiểm thử QA kiểm thử luồng thanh toán đến bước Stripe và đánh dấu là cần khóa khi Stripe chưa được kết nối.

Câu hỏi thường gặp

MonstarX có lấy phần trăm doanh thu của tôi không?

Không. Tiền thanh toán đi thẳng vào tài khoản Stripe của bạn. Chỉ có phí của chính Stripe.

Tôi có thử thanh toán mà không cần thẻ thật được không?

Được. Kết nối với Môi trường thử nghiệm (khóa kiểm thử) rồi thanh toán bằng thẻ kiểm thử 4242 4242 4242 4242, ngày bất kỳ trong tương lai và CVC bất kỳ. Không có tiền nào được chuyển.

Làm sao để chuyển từ thanh toán thử sang thanh toán thật?

Nhấp vào Cập nhật khóa trên dòng Stripe, đặt Môi trường thành Môi trường chính thức (khóa thật), dán khóa live, nhấp vào Lưu khóa rồi xuất bản lại.

Vì sao trang thanh toán báo Stripe chưa được kết nối?

Khóa chưa được thêm, hoặc đã bị xóa. Mở Dịch vụ đám mây → Đám mây và kết nối Stripe; bản xem trước sẽ khởi động lại với khóa mới.

Tôi có xem các khoản thanh toán trong MonstarX được không?

Ứng dụng hiển thị những gì MonstarX đã xây dựng cho ứng dụng, như một trang đơn hàng. Hồ sơ đầy đủ về mọi khoản thanh toán, hoàn tiền và chuyển tiền nằm trong Stripe Dashboard của bạn.

Liên quan

Kết nối dịch vụ với ứng dụngTrình kết nối cho ứng dụng, thẻ trong cuộc trò chuyện và nút Để sau hoạt động thế nào.

Xuất bản ứng dụngĐưa ứng dụng lên mạng để Stripe với tới được.

TwilioNhắn tin biên nhận hoặc lời nhắc cho khách hàng.

Cất khóa API an toànNơi lưu khóa của bạn.