Stripe

Cách khác: dán chìa khóa của riêng bạn

Mọi thứ từ đây trở xuống đều là đường dẫn thủ công. Bạn thiết lập một webhook trong trang tổng quan Stripe của mình, thu thập ba giá trị ở đó và dán chúng vào Coin Moebius. Lên kế hoạch khoảng mười phút. Nếu bạn đã đăng nhập ở trên thì bạn đã hoàn tất và có thể bỏ qua tất cả những điều này.

Những gì bạn cần

Chỉ có con đường chính mới cần những thứ này. Nếu bạn đăng nhập bằng Stripe ở trên thì sẽ không có gì để thu thập. Stripe giữ các khóa riêng biệt cho chế độ Kiểm tra và Trực tiếp (pk_test_ / sk_test_ so với pk_live_ / sk_live_), mỗi khóa có bí mật ký webhook riêng. Coin Moebius giữ cả hai tab Trực tiếp và Kiểm tra, vì vậy bạn có thể xác minh trên các khóa kiểm tra và thêm khóa trực tiếp sau mà không cần nhập lại mọi thứ.

Vì sao chúng tôi hỏi mỗi trường

Publishable key

Nhận diện tài khoản của bạn khi checkout mở trong trình duyệt của người mua. Công khai theo thiết kế.

Secret key

Nửa riêng tư cho phép tạo khoản phí, để khoản thanh toán chạy qua tài khoản của bạn.

Webhook signing secret

Chứng minh một webhook đến thực sự từ Stripe, nên không ai có thể giả mạo một sự kiện "đã trả tiền". Nó là một giá trị riêng tách khỏi secret key.

Success và Cancel URL

Cài đặt thông thường: nơi người mua đáp xuống sau khi trả tiền hoặc rút lui. Không bí mật.

Thiết lập

1. Dùng chế độ thử nghiệm (miễn phí)

   Một tài khoản Stripe là miễn phí, và chế độ thử nghiệm hoạt động trước khi kích hoạt. Đăng nhập tại dashboard.stripe.com và bật Test mode (góc trên). Thiết lập thử nghiệm trước, rồi lặp lại ở live.

2. Sao chép các khóa của bạn

   Vào Developers → API keys và sao chép Publishable key và Secret key.

   ⤢
3. Thêm webhook
   1. Developers → Webhooks → Add endpoint.
   2. Đặt URL endpoint thành địa chỉ webhook dự án của bạn (bên dưới).
   3. Chọn các sự kiện. Cho thanh toán một lần: checkout.session.completed, charge.refunded, charge.dispute.created. Nếu bạn bán gói đăng ký, thêm: customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.payment_succeeded, invoice.payment_failed. Sự kiện thừa là vô hại, chúng tôi bỏ qua những gì mình không dùng.
   4. Sao chép Signing secret của endpoint (whsec_…). Test và live mỗi cái có một secret riêng.

   https://api.coinmoebius.com/webhook/stripe/<your project id>

   ⤢
4. Kiểm tra

   Thẻ thử nghiệm chỉ hoạt động ở chế độ thử nghiệm và không bao giờ tính phí một thẻ thật. Dùng bất kỳ ngày hết hạn tương lai nào, bất kỳ CVC nào, bất kỳ mã bưu chính nào.

   Kết quả	Thẻ
   Thành công	4242 4242 4242 4242
   Cần xác thực	4000 0025 0000 3155
   Bị từ chối	4000 0000 0000 9995

5. Kết nối trong bảng điều khiển

   Thêm nhà cung cấp → Stripe. Nhập publishable key, secret key, webhook signing secret, Success URL, và Cancel URL. Dùng khóa thử nghiệm để kiểm chứng luồng, rồi chỉnh sửa nhà cung cấp và thay bằng khóa live.

Sau khi bạn kết nối

Thực hiện một khoản thanh toán trước khi bạn phát trực tiếp:

1. Đăng nhập bằng Stripe? Tài khoản của bạn đang hoạt động, vì vậy hãy mua sản phẩm trị giá một đô la bằng thẻ của chính bạn và hoàn lại tiền từ Stripe sau đó. Đã dán khóa kiểm tra? Mỗi khoản thanh toán đều là khoản thanh toán thử nghiệm, vì vậy hãy sử dụng thẻ thử nghiệm từ phía trên.
2. Tạo một sản phẩm và đặt nút mua lên một trang (một tệp HTML cục bộ cũng được) trỏ về dự án của bạn.
3. Thanh toán bằng một thẻ thử nghiệm ở trên.
4. Mở tab Giao dịch. Khi trạng thái hàng mới đạt succeeded, khóa và webhook của bạn đều hoạt động trọn vẹn đầu cuối.

Nếu bạn đã sử dụng khóa kiểm tra, hãy chỉnh sửa nhà cung cấp, trao đổi khóa trực tiếp của mình và bạn sẽ nhận được khoản thanh toán thực.

Khắc phục sự cố

Bắt đầu với Verify. Trong trang tổng quan, nhấp vào Verify trên thẻ Stripe. Nó hỏi Stripe về tài khoản của bạn hoặc kiểm tra chìa khóa của bạn và trả về một tin nhắn cụ thể nếu có điều gì đó không ổn.

Tôi đã đăng nhập bằng Stripe và nhận được thông báo "Đã kết nối tài khoản. Cần hành động."

Tài khoản Stripe của bạn đã được kết nối nhưng Stripe vẫn chưa được thanh toán bằng thẻ. Mở Stripe, hoàn thành những gì nó yêu cầu (thường là chi tiết doanh nghiệp hoặc tài khoản ngân hàng), sau đó nhấp vào Verify trên thẻ Stripe trong Coin Moebius.

Thẻ Stripe cho biết Đã ngắt kết nối.

Coin Moebius đã bị xóa khỏi tài khoản Stripe của bạn, thường là khỏi trang Ứng dụng được ủy quyền trong Stripe. Mở thẻ, chọn Edit và nhấp vào Reconnect để phê duyệt lại.

Xác minh báo định dạng khóa sai.

Secret key bắt đầu bằng sk_test_ hoặc sk_live_ (khóa hạn chế bắt đầu bằng rk_). Webhook signing secret bắt đầu bằng whsec_. Sao chép lại giá trị đúng vào trường đúng.

Xác minh báo Stripe từ chối khóa.

Sao chép lại secret key từ Developers → API keys, và đảm bảo bạn không ghép một khóa test với một webhook secret live hay ngược lại.

Thanh toán hoàn tất nhưng đơn hàng vẫn đang chờ.

Webhook không đến. Xác nhận URL endpoint khớp chính xác, rằng bạn đã chọn checkout.session.completed, và rằng một khoản thanh toán thử nghiệm đang đến endpoint chế độ thử nghiệm của bạn (test và live là các endpoint riêng).

Xác minh chữ ký thất bại.

Mỗi endpoint Stripe có signing secret riêng. Sao chép whsec_ từ cài đặt của endpoint này, không phải một endpoint khác.

Xác nhận nó trọn vẹn đầu cuối.

Stripe không có nút giả lập. Trong Stripe Dashboard, gửi lại một sự kiện gần đây đến endpoint của bạn, hoặc tạo một PaymentIntent thử nghiệm, rồi quan sát đơn hàng cập nhật.

Cần biết

Đã đăng nhập bằng Stripe. Không có khóa hoặc bí mật webhook nào để sao chép, lưu trữ hoặc xoay. Stripe thông báo cho Coin Moebius khi tài khoản của bạn thay đổi. Để cắt liên kết, nhấp vào Disconnect trên thẻ Stripe hoặc xóa Coin Moebius trong Ứng dụng được ủy quyền trong Stripe.

Xoay khóa. Dán chìa khóa của riêng bạn? Cuộn khóa bí mật hoặc bí mật webhook bất cứ lúc nào, sau đó dán giá trị mới. Các trường bí mật được giữ trống khi chỉnh sửa để bạn có thể thả phím xoay.

Kích hoạt. Khóa live chỉ hoạt động khi tài khoản của bạn được kích hoạt cho thanh toán. Khóa thử nghiệm hoạt động ngay.

Câu hỏi? Join our Discord