CreateYourVPN Academy
Hướng dẫn

Nhận thanh toán qua lava.top

Hướng dẫn từng bước: kết nối lava.top với CreateYourVPN để khách hàng nạp tiền vào số dư trên gian hàng của bạn. Khóa API, webhook, các mức nạp tiền và tự động nạp số dư.

lava.top nhận thẻ, SBP và PayPal bằng rúp, đô la và euro. Khách hàng dùng nó để nạp tiền vào số dư trong trang người dùng trên gian hàng của bạn, rồi mua gói cước bằng số dư đó: bạn không cần cấp quyền truy cập thủ công.

lava.top làm việc với các mức cố định: khách hàng chọn một trong các mức nạp tiền bạn đã tạo, và mỗi mức có ưu đãi riêng với cùng mức giá. Khách hàng không thể tự nhập số tiền. Nếu bạn muốn cho nạp số tiền bất kỳ, hãy kết nối thêm PayHot.

Tiền vào tài khoản lava.top của chính bạn. CreateYourVPN không phải trung gian trong thanh toán và không lấy hoa hồng từ doanh số của bạn.

Nhận thanh toán có trong gói trả phí Max: với gói này, gian hàng của bạn bắt đầu bán hàng, và số dư khách hàng tự bật. Về giá của nền tảng, xem bài học về thanh toán.

Bạn cần những gì

  • một tài khoản trên lava.top (tài khoản tác giả, tức là tài khoản dùng để bán);
  • 10–15 phút cho thiết lập ban đầu;
  • một khoản nhỏ để nạp thử: lava.top không có chế độ thử nghiệm, nên cách duy nhất để kiểm tra toàn bộ thiết lập từ đầu đến cuối là một khoản thanh toán thật (tối thiểu 50 ₽ / 5 $ / 5 €).

Bước 1. Đăng ký và xác minh

Đăng ký trên lava.top và điền hồ sơ: với hồ sơ trống, trang thanh toán trông dở dang trong mắt người mua.

Sau đó vào Balance → xác minh và hoàn tất xác minh: giấy tờ và ảnh selfie, 18+, không bật VPN.

Bạn có thể bán ngay cả trước khi xác minh, nhưng không rút được tiền nếu chưa xác minh. Đừng để đến lần rút tiền đầu tiên mới làm.

Bước 2. Tạo sản phẩm

Giá của ưu đãi trong lava.top chính là mức nạp tiền. Hãy tạo số ưu đãi bằng số mức nạp bạn muốn cung cấp cho khách hàng.

  • Nạp số dư một lần: sản phẩm số, khóa học hoặc tư vấn có giá cố định. Một ưu đãi cho một mức nạp, ví dụ 300, 500 hoặc 1000 ₽.
  • Tự động nạp số dư: sản phẩm loại «Đăng ký». lava.top tự trừ giá của ưu đãi theo lịch của nó (mỗi tháng, 3 tháng một lần, 6 tháng một lần hoặc mỗi năm), và mỗi lần trừ tiền sẽ nạp vào số dư của khách hàng.
  • Ưu đãi phải có giá theo tiền tệ tài khoản khách hàng. Bạn xem tiền tệ ở mục «Kiếm tiền», trên thẻ «Số dư khách hàng». lava.top nhận rúp, đô la và euro.
  • Ẩn sản phẩm khỏi trang lava.top công khai của bạn bằng chế độ hiển thị ẩn. Đừng bật «giá theo yêu cầu qua API»: CreateYourVPN làm việc với các ưu đãi có giá cố định. Giao dịch mua thẳng từ trang lava.top của bạn sẽ đến mà không có dấu của chúng tôi, và chúng tôi sẽ không biết đó là khoản thanh toán của ai. Sản phẩm giá cố định bị ẩn vẫn hiện trong bảng điều khiển.

Ưu đãi trong lava.top là một cách bán sản phẩm với một mức giá và chu kỳ trừ tiền nhất định. Một sản phẩm có thể có nhiều ưu đãi, và trong bảng điều khiển bạn chọn ưu đãi phù hợp cho từng mức nạp.

Bước 3. Kết nối tài khoản trong CreateYourVPN

Mọi thứ cần làm ở phía lava.top nằm cùng một chỗ: Integrations ở menu bên trái, thẻ API.

Mục «Integrations» trong lava.top: thẻ API và Web-Widget

Tạo khóa API

Mở thẻ API và nhấn «Create API key». Khóa chỉ hiển thị một lần, nên hãy sao chép ngay: lava.top sẽ không hiện lại, và khóa bị mất chỉ có thể thay bằng khóa mới.

Trang khóa API: nút «Create API key» và liên kết tới lịch sử webhook

Dán khóa vào bảng điều khiển của bạn

Trong CreateYourVPN, mở mục «Kiếm tiền», nhấn «Kết nối» trên thẻ lava.top, dán khóa vào ô «Khóa API lava.top» rồi lưu.

Chúng tôi kiểm tra khóa ngay và trả lời «Khóa đã được chấp nhận» kèm số sản phẩm tìm thấy trong tài khoản, hoặc «lava.top không chấp nhận khóa này».

Ngay sau khi lưu, trong cùng biểu mẫu xuất hiện thêm hai giá trị: Webhook URL và khóa webhook. Đó là những thứ bạn sẽ dán vào lava.top ở bước tiếp theo. Khóa webhook do chúng tôi tạo, bạn không phải tự nghĩ ra.

Tạo webhook

lava.top đề nghị việc này ngay sau khi tạo khóa: nhấn «+ Add Webhook». Sau này nút đó cũng có trên trang API.

Cửa sổ «API key successfully added» với nút «+ Add Webhook»

Chỉ cần một webhook: trường loại sự kiện nhận tất cả sự kiện cùng lúc.

Biểu mẫu thêm webhook: URL, loại sự kiện, kiểu xác thực và ô khóa API

URL: địa chỉ webhook lấy từ bảng điều khiển của bạn. lava.top chỉ nhận HTTPS, và địa chỉ của chúng tôi đúng là như vậy.

Loại sự kiện: đánh dấu tất cả sự kiện trong danh sách. Đây là lựa chọn nhiều mục, nên không cần webhook thứ hai.

Type of authentication for Webhook: chọn «API key of your service» và dán khóa webhook từ bảng điều khiển vào ô «API key». Basic cũng được, chúng tôi chấp nhận, nhưng đó là hai ô thay vì một.

Comment: không bắt buộc, để cho chính bạn. Một ghi chú kiểu «CreateYourVPN, thanh toán» sẽ hữu ích khi bạn có nhiều tích hợp.

lava.top không thêm chữ ký mật mã cho nội dung yêu cầu, nên chính khóa webhook xác thực việc gửi. Hãy coi nó như mật khẩu.

Đừng bỏ sót sự kiện nào: thiếu các sự kiện về thanh toán định kỳ, các khoản tự động nạp số dư của khách hàng sẽ không bao giờ vào được số dư. Đánh dấu tất cả luôn an toàn.

Khóa API cho chúng tôi những gì

lava.top không có khóa «chỉ đọc»: khóa API cấp toàn quyền vào tài khoản tác giả. Chúng tôi dùng nó đúng cho ba việc: tạo khoản thanh toán vào lúc khách hàng nhấn «Thanh toán»; đọc danh mục sản phẩm của bạn để bạn chọn ưu đãi trong bảng điều khiển; và hủy gói đăng ký khi khách hàng tắt tự động nạp số dư hoặc tự động gia hạn trong trang người dùng của họ. Chúng tôi không đổi giá, không xuất dữ liệu bán hàng của bạn và không đụng đến bất cứ thứ gì khác. Khóa được lưu ở dạng mã hóa, không hiển thị lại và không bao giờ lọt vào nhật ký hệ thống của chúng tôi. Nếu muốn cắt quyền truy cập, hãy xóa kết nối trong bảng điều khiển: khóa sẽ bị xóa cùng.

Bước 4. Thêm các mức nạp tiền

Mở «Gói cước» và tìm khối «Nạp tiền vào số dư».

Nhấn «Thêm nạp số dư», chọn một ưu đãi một lần trong danh sách «Ưu đãi lava.top» rồi nhấn «Thêm nạp số dư» trong cửa sổ. Mức nạp sẽ thành giá của ưu đãi. Thêm từng mức theo cách này, tối đa 20 mức.

Với tự động nạp số dư, nhấn «Thêm tự động nạp số dư», chọn một gói đăng ký lava.top rồi nhấn «Thêm tự động nạp số dư» trong cửa sổ. Ưu đãi quyết định số tiền và tần suất, ví dụ 500 ₽ mỗi tháng. Bảng điều khiển sẽ cho biết khoản nạp như vậy đủ cho gói cước nào.

Kiểm tra cảnh báo ở các dòng, nếu có. Bảng điều khiển sẽ báo khi ưu đãi không có giá theo tiền tệ của số dư, khi giá ưu đãi khác với mức nạp, và khi ưu đãi không còn trong lava.top.

Vừa tạo sản phẩm trong lava.top mà không thấy trong danh sách? Nhấn «Làm mới danh sách»: danh mục được lưu đệm trong một phút.

Khi chưa có mức nào và chưa kết nối PayHot, khách hàng không có cách nạp tiền vào số dư: trong cửa sổ «Nạp tiền vào số dư» họ sẽ thấy «Chưa thể nạp tiền». Hãy tạo ít nhất một mức không thấp hơn giá của gói cước đắt nhất: khi đó khách hàng có số dư bằng 0 có thể nạp tiền và mua gói chỉ trong một lần thanh toán, bằng nút «Nạp tiền và mua».

Trong chính gói cước, bạn không chọn ưu đãi: gói cước theo tiền tệ tài khoản được mua bằng số dư. Ngoại lệ là gói cước có giá bằng tiền tệ khác và đã gắn với một ưu đãi từ trước: khách hàng thanh toán gói đó trực tiếp qua lava.top.

Khách hàng sẽ thấy gì

Trong trang người dùng trên gian hàng của bạn, khách hàng nhấn «Nạp tiền». Ở tab «Một lần», họ chọn một trong các mức của bạn và phương thức thanh toán: thẻ, SBP (chỉ rúp), hoặc PayPal nếu ưu đãi có giá bằng đô la hoặc euro. Ở tab «Tự động», họ bật tự động nạp số dư: bằng thẻ hoặc PayPal, vì gói đăng ký của lava.top không nhận SBP. Số dư luôn nhận đúng mức nạp theo tiền tệ tài khoản, kể cả khi khách hàng trả bằng tiền tệ khác.

Tự động nạp số dư cần một gói đăng ký có thời hạn và có giá theo tiền tệ tài khoản: không có gói như vậy, khách hàng sẽ không có tab «Tự động». Tự động nạp số dư hoạt động cùng với tự động gia hạn gói cước từ số dư: khi khách hàng bật tự động nạp số dư, tự động gia hạn sẽ tự bật, và nếu khách hàng chưa có gói cước, lần trừ tiền đầu tiên sẽ mua gói. Mỗi khách hàng chỉ có một khoản tự động nạp số dư.

Bước 5. Kiểm tra bằng một khoản thanh toán thật

Từ một tài khoản khách hàng trên gian hàng của bạn, hãy nạp tiền vào số dư với mức nhỏ nhất. Trong vòng một phút, tiền phải xuất hiện trong số dư, và ở mục «Kiếm tiền», trong «Nhật ký thanh toán», phải có một khoản nạp số dư với trạng thái «Đã xử lý». Sau đó hãy mua một gói cước bằng số dư.

Nếu không như vậy:

  • sự kiện hoàn toàn không có trong nhật ký: webhook trong lava.top đang trỏ sai địa chỉ, chưa đánh dấu tất cả sự kiện, hoặc khóa của nó không trùng với khóa trong bảng điều khiển. lava.top có lịch sử webhook kèm nút gửi lại, hãy bắt đầu từ đó;
  • sự kiện có, nhưng tiền không vào số dư: sự kiện sẽ có ghi chú «Chưa cộng vào số dư» kèm gợi ý. Hãy kiểm tra khoản thanh toán trong lava.top và cộng số tiền bằng một khoản điều chỉnh trong thẻ khách hàng;
  • «Chưa khớp»: chúng tôi không xác định được đó là khoản thanh toán của ai. Điều này xảy ra khi khách hàng mua sản phẩm thẳng trên trang lava.top của bạn mà không qua gian hàng. Hãy tìm khách hàng đó và cộng số tiền bằng một khoản điều chỉnh trong thẻ của họ;
  • «Cần xử lý»: sự kiện cần bạn quyết định, và chính sự kiện đó cho biết cần làm gì.

Nếu lần trừ tiền theo gói đăng ký không thành công, lava.top sẽ thử thêm hai lần, sau 8 và 24 giờ, và chỉ gửi thông báo thanh toán thất bại sau lần thử cuối. Khách hàng sẽ thấy trong trang người dùng rằng lần trừ tiền gần nhất không thành công. Tiền đã có trong số dư vẫn thuộc về khách hàng.

Về tiền

  • Hoa hồng của lava.top: 8 % trên mỗi khoản thanh toán thành công. Nó bị trừ ngay và không được trả lại nếu sau đó bạn hoàn tiền cho khách hàng.
  • Hoàn tiền thực hiện từ bảng điều khiển lava.top, mục «Doanh số»; hoàn tiền cho gói đăng ký sẽ hủy gói đăng ký đó. Thông báo về hoàn tiền hoặc chargeback sẽ vào nhật ký với trạng thái «Cần xử lý». Số dư của khách hàng không tự giảm sau khi hoàn tiền: hãy trừ đúng số tiền đó bằng một khoản điều chỉnh trong thẻ khách hàng.
  • Tắt tự động nạp số dư. Khách hàng tự tắt trong trang người dùng trên gian hàng của bạn, và chúng tôi yêu cầu lava.top hủy gói đăng ký. Nếu khách hàng tắt tự động gia hạn gói cước, tự động nạp số dư cũng tắt theo. Bạn cũng có thể hủy gói đăng ký trong bảng điều khiển lava.top. Dù bằng cách nào, tiền trong số dư cũng không mất.
  • Chargeback có thể mở trong vòng 540 ngày sau khi thanh toán, và bạn có 3 ngày để nộp bằng chứng. Hãy lưu giữ điều khoản bán hàng, thư từ với khách hàng và bằng chứng rằng quyền truy cập đã được cung cấp.
  • Hạn mức thanh toán phụ thuộc vào loại sản phẩm. Mức tối thiểu luôn là 50 ₽ / 5 $ / 5 €. Mức tối đa cho gói đăng ký là 300 000 ₽ / 3 000 $ / 3 000 €, còn cho sản phẩm một lần là 1 000 000 ₽ / 10 000 $ / 10 000 €.

Nếu khóa bị lộ

Trên thẻ lava.top có hai nút khác nhau, và chúng làm những việc khác nhau:

  • «Cấp lại khóa webhook» phát hành khóa mới cho các thông báo đến. Hãy dán giá trị mới vào webhook trong lava.top; cho đến khi bạn làm vậy, các khoản thanh toán sẽ không được xác nhận.
  • «Đổi URL webhook» phát hành địa chỉ mới. Địa chỉ cũ ngừng hoạt động ngay lập tức; hãy cập nhật cả trong webhook.

Nếu chính khóa API bị lộ, hãy thu hồi nó trong lava.top, tạo khóa mới và dán vào bảng điều khiển.

On this page