Trong bài viết này
Vị trí: Settings → Readers & money → Connections → Payments
Mở trang này: admin.<your-site>/settings/connections/payments (thay <your-site> bằng địa chỉ trang web của bạn)
Trước khi bắt đầu
- Kết nối Razorpay, Stripe hoặc PayPal trước. Xem Payments.
- Bạn phải là chủ sở hữu trang web.
Các bước thực hiện
Stripe và PayPal: Keynate sẽ tự thiết lập tin nhắn thanh toán trong tài khoản giúp bạn khi có thể. Thẻ thông báo "Tin nhắn thanh toán đã được thiết lập trong Stripe cho bạn." Nếu không thể, thẻ sẽ báo "Còn một bước nữa" cùng nút Hoàn tất thiết lập. Hãy làm theo các bước bên dưới.
Razorpay: không thể thực hiện tự động cho bạn. Thẻ Razorpay có khung hướng dẫn 3 bước với tính năng kiểm tra trực tiếp: Đang chờ tin nhắn đầu tiên của Razorpay… sẽ chuyển thành Chúng tôi đã nhận được tin nhắn đầu tiên của Razorpay. sau lần thanh toán đầu tiên của bạn, dù là thử nghiệm hay thực tế. Nhấn Kiểm tra ngay để kiểm tra lại. Xem Connect Razorpay.
Các bước dành cho mọi cổng:
- Mở Cài đặt → Độc giả & Doanh thu → Kết nối → Thanh toán.
- Trên thẻ của cổng thanh toán, tìm khung Webhook.
- Nhấn Mở webhook (nút sẽ nêu tên cổng của bạn). Trang quản trị của cổng thanh toán sẽ mở trong tab mới.
- Trong cổng thanh toán, nhấn Thêm.
- Quay lại Keynate, nhấn Sao chép bên cạnh URL webhook và dán vào cổng thanh toán.
- Đánh dấu chọn các sự kiện được liệt kê trong khung Keynate.
- Razorpay: nhấn Sao chép ở mã bí mật và dán vào làm secret. Dùng mã bí mật khác nhau cho thử nghiệm và thực tế.
- Lưu lại trong cổng thanh toán.
- Stripe và PayPal sẽ hiển thị một mã sau khi lưu. Stripe gọi mã này là signing secret và bắt đầu bằng
whsec_. PayPal gọi nó là Webhook ID. Hãy sao chép và dán vào khung tương ứng trong Keynate. - Nhấn Kiểm tra kết nối.
Thông tin hữu ích
- Chế độ thử nghiệm và chế độ thực tế mỗi bên cần webhook riêng.
- Nếu bạn làm mất mã bí mật, hãy thêm webhook mới trong cổng thanh toán và dán mã mới.
Lỗi thường gặp
- "Dán webhook secret bạn đã nhập trong Razorpay." Khung trong Keynate đang để trống. Hãy dán cùng mã bí mật bạn đã cung cấp cho Razorpay.
- "Dùng webhook secret khác nhau cho thử nghiệm và thực tế." Hãy tạo một mã bí mật mới cho chế độ thứ hai.
- "Dán webhook signing secret. Mã bắt đầu bằng whsec_." Sao chép mã từ Stripe sau khi bạn thêm endpoint.
- "Dán Webhook ID (chỉ gồm chữ và số)." Sao chép ID từ danh sách Webhooks trong ứng dụng PayPal của bạn.
- Razorpay vẫn báo "Đang chờ tin nhắn đầu tiên của Razorpay…". Hãy thực hiện một khoản thanh toán thử nghiệm nhỏ. Tin nhắn sẽ tới sau lần thanh toán đầu tiên. Sau đó nhấn Kiểm tra ngay.
- Đơn hàng vẫn ở trạng thái chưa thanh toán sau khi người đọc đã trả tiền. Webhook bị thiếu hoặc sai. Mỗi đêm Keynate cũng đối soát đơn hàng của bạn với cổng thanh toán và xử lý các đơn bị sót.
Câu hỏi thường gặp
Câu hỏi thường gặp
Việc này có giống với API key không?
Không. Khóa giúp Keynate giao tiếp với cổng. Webhook giúp cổng giao tiếp với Keynate.
Tôi có cần webhook riêng cho thử nghiệm và thực tế không?
Có. Chế độ thử nghiệm và chế độ thực tế mỗi bên cần webhook riêng.
Nếu tôi làm mất mã bí mật thì sao?
Thêm một webhook mới trong cổng thanh toán và dán mã mới vào Keynate.
Nếu đơn hàng vẫn chưa thanh toán dù người đọc đã trả tiền thì sao?
Webhook bị thiếu hoặc sai. Mỗi đêm Keynate cũng đối soát đơn hàng của bạn với cổng thanh toán và xử lý các đơn bị sót.