Nhận thanh toán qua lava.top
Hướng dẫn từng bước: cách kết nối tài khoản lava.top với CreateYourVPN để khoản thanh toán của khách tự trở thành gói đăng ký — khóa API, một webhook và gắn ưu đãi với các gói cước của bạn.
lava.top là nhà cung cấp thanh toán nhận thẻ, SBP và PayPal bằng rúp, đô la và euro. Bạn kết nối một lần — và khoản thanh toán trên cửa hàng của bạn tự trở thành gói đăng ký đang hoạt động: không cần cấp quyền truy cập thủ công.
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 thuộc gói trả phí Max — chính gói này bật chế độ bán hàng cho cửa hàng. 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ài khoản dùng để bán);
- 10–15 phút cho thiết lập ban đầu;
- một khoản nhỏ cho lần thanh toán thử: lava.top không có môi trường thử nghiệm, nên cách duy nhất để kiểm tra toàn bộ thiết lập là một giao dịch mua 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: 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 thanh toán đầu tiên mới làm.
Bước 2. Tạo sản phẩm
Trong lava.top hãy tạo một sản phẩm cho mỗi gói cước bạn bán.
- Với gói định kỳ, chọn loại sản phẩm «Đăng ký» — khi đó lava.top sẽ tự trừ tiền, và mỗi lần gia hạn sẽ kéo dài quyền truy cập bên chúng tôi.
- Với giao dịch một lần, hãy dùng sản phẩm số, khóa học hoặc tư vấn có giá cố định.
- Thêm giá vào ưu đãi bằng ít nhất một loại tiền được hỗ trợ: RUB, USD hoặc EUR. Loại tiền của gói trong CreateYourVPN là lựa chọn mặc định, nhưng khách có thể chọn bất kỳ loại tiền nào có trong ưu đãi.
- Khớp chu kỳ trừ tiền với thời hạn gói: sản phẩm theo tháng ↔ 30 ngày, 90 ngày ↔ 90, v.v.
- Chỉ dùng chế độ hiển thị «ẩn» để giấu sản phẩm khỏi trang lava.top công khai. Đừng bật «giá theo yêu cầu qua API»: tích hợp của chúng tôi tạo thanh toán từ ưu đãi có giá cố định và không gửi số tiền qua API. Giao dịch mua trực tiếp có thể đến mà không có dấu của chúng tôi và thành «Chưa khớp». Sản phẩm giá cố định bị ẩn vẫn hiện trong bộ chọn ưu đãi.
lava.top gọi giá của sản phẩm là ưu đãi (offer). Một sản phẩm có thể có nhiều ưu đãi (khác loại tiền và chu kỳ) — và chính ưu đãi là thứ bạn sẽ chọn cho từng gói cước ở bước sau.
Mua lại thì sao
Sản phẩm một lần không có gia hạn: khi khách cần thêm, họ chỉ việc mua lại. Đó là kịch bản bình thường, và mua sớm là an toàn — số ngày được cộng vào phần còn lại, chứ không tính lại từ đầu. Mười ngày còn lại cộng một tháng mới thành bốn mươi ngày.
Một ngoại lệ, nếu gói còn cấp dung lượng: hạn mức được thay thế, không cộng dồn. Khách đã mua 100 GB, dùng hết 30 và mua lại chính gói đó sẽ có 100 GB mới, chứ không phải 170. Hãy tính đến điều này khi định giá các gói có dung lượng.
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.

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

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 «Đã nhận khóa» — 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ị: URL webhook 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ị ngay sau khi tạo khóa — nhấn «+ Add Webhook». Nút đó cũng có sau này trên trang API.

Chỉ cần một webhook — ở ô loại sự kiện, hãy chọn cùng lúc tất cả các loại cần thiết:

URL — địa chỉ webhook lấy từ bảng điều khiển của bạn. lava.top chỉ nhận HTTPS; địa chỉ của chúng tôi đúng như vậy.
Event type — chọn cả hai loại: «Payment result» và «Recurring payment». Danh sách cho phép chọn nhiều, 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 hoàn toàn không ký các yêu cầu, nên chính khóa webhook nói cho bộ nhận của chúng tôi biết rằng thông điệp đến từ tài khoản của bạn — hãy coi nó như mật khẩu.
Đừng bỏ chọn «Recurring payment» nếu bạn bán gói đăng ký: thiếu loại sự kiện này, các lần gia hạn sẽ không đến được chúng tôi và quyền truy cập của khách đang trả tiền sẽ đơn giản là hết hạn. Với sản phẩm một lần, chỉ «Payment result» là đủ, nhưng để chọn cả hai cũng hoàn toà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 nhấn «Thanh toán»; đọc danh mục sản phẩm của bạn cho bộ chọn ưu đãi; và hủy gói đăng ký khi khách tắt tự động gia hạn trong trang cá nhân của họ. Chúng tôi không đổi giá, không đụng đến việc xuất doanh số của bạn và không làm gì khác với khóa này. Khóa được lưu ở dạng mã hóa, không hiển thị lại ở đâu nữa và không lọt vào nhật ký 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. Gắn ưu đãi với các gói cước
Mở «Gói cước», vào một gói và tìm khối lava.top:
Nhấn «Tải sản phẩm» — chúng tôi sẽ lấy danh mục từ tài khoản lava.top của bạn.
Chọn ưu đãi dùng để bán gói này. Trong danh sách hiện rõ sản phẩm, giá và chu kỳ trừ tiền.
Xem các cảnh báo nếu có. Bảng điều khiển sẽ báo khi ưu đãi không có giá bằng tiền của gói và khi chu kỳ trừ tiền lệch với thời hạn gói («trừ tiền mỗi 30 ngày, nhưng gói cấp 365»).
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.
Khách có thể chọn bất kỳ loại tiền nào có trong ưu đãi. Thanh toán một lần bằng rúp có thẻ và SBP, gói đăng ký bằng rúp chỉ có thẻ, còn USD và EUR hỗ trợ thẻ và PayPal.
Bước 5. Kiểm tra bằng một khoản thanh toán thật
Hãy tự mua gói rẻ nhất từ một tài khoản khách trên cửa hàng của bạn. Trong vòng một phút, gói phải xuất hiện trong tài khoản đó, còn khoản thanh toán phải nằm trong nhật ký với trạng thái «Đã xử lý» (mục «Kiếm tiền»).
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 chọn các loại sự kiện cần thiết, hoặc khóa webhook 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 «Chưa khớp» — chúng tôi không xác định được đó là khoản thanh toán của ai và cho gói nào. Hãy khớp thủ công ngay trong nhật ký: gói đăng ký sẽ được cấp bằng đúng đoạn mã như khi thanh toán tự động;
- «Cần xử lý» — khoản thanh toán cần quyết định của con người: khách bị chặn trong bảng điều khiển của bạn, hoặc gói cước đã được chuyển sang một sản phẩm lava.top khác sau khi khoản thanh toán được tạo. Ở đây chúng tôi không tự động đụng đến quyền truy cập — bạn quyết định.
Một lần trừ tiền thất bại không phải lý do để hoảng: lava.top sẽ thử lại sau 8 và 24 giờ, và chúng tôi không cắt quyền truy cập vì một lần thử hỏng. Thông báo thất bại chỉ được gửi sau lần thử cuối; nếu gói đăng ký bị hủy, lần gia hạn tiếp theo sẽ không diễn ra và kỳ đã trả tiền vẫn có hiệu lực đến hết.
Về tiền
- Hoa hồng của lava.top là 8 % 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.
- 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 đó. lava.top hiện chưa có loại webhook riêng cho hoàn tiền và chargeback, nên bạn sẽ thấy chúng trong bảng điều khiển lava.top chứ không phải trong nhật ký của chúng tôi.
- Hủy tự động gia hạn. Khách có thể tự hủy trong trang cá nhân của họ trên cửa hàng của bạn — khi đó chúng tôi yêu cầu lava.top hủy gói đăng ký — hoặc trong tài khoản lava.top của chính họ; bạn cũng có thể hủy giúp họ từ bảng điều khiển lava.top của mình. Việc hủy không lấy đi quyền truy cập: nó còn hiệu lực đến hết kỳ đã trả tiền, và chúng tôi chỉ đơn giản thôi chờ lần trừ tiền tiếp theo.
- 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 của cửa hàng và thư từ với khách — bằng chứng chính là như vậy.
- Hạn mức thanh toán: 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 €, và 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. Giá trị mới phải được dán 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, nó cũng cần được cập nhật 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.
Cách thiết lập máy chủ của bạn (chế độ “Một máy chủ”)
Hướng dẫn từng bước: cách kết nối VPS của bạn với CreateYourVPN ở chế độ “Một máy chủ” — từ việc thuê máy chủ đến một VPN cá nhân sẵn sàng chỉ trong vài phút.
Happ
Cách cài đặt ứng dụng Happ trên điện thoại hoặc máy tính, phải làm gì nếu ứng dụng không khả dụng ở quốc gia của bạn, và cách kết nối bằng liên kết từ tài khoản của bạn.