lava.top으로 결제 받기

단계별 가이드: 고객의 결제가 알아서 구독으로 바뀌도록 lava.top 계정을 CreateYourVPN에 연결하는 방법 — API 키, 웹훅 하나, 오퍼와 요금제 연결.

lava.top은 루블·달러·유로로 카드, SBP, PayPal 결제를 받는 결제 제공업체입니다. 한 번 연결해 두면 스토어프론트에서 발생한 결제가 알아서 활성 구독이 됩니다. 접근 권한을 손으로 줄 필요가 없습니다.

돈은 여러분 자신의 lava.top 계정으로 들어갑니다. CreateYourVPN은 결제의 중개자가 아니며 여러분의 매출에서 수수료를 가져가지 않습니다.

결제 수령은 유료 요금제 Max에 포함됩니다. 스토어프론트를 판매 모드로 전환하는 것도 이 요금제입니다. 플랫폼 가격은 청구 수업을 참고하세요.

준비물

lava.top 계정(판매하는 쪽인 «작가» 계정)
초기 설정에 필요한 10~15분
테스트 결제를 위한 소액: lava.top에는 테스트 환경이 없어서, 설정 전체를 확인할 방법은 실제 구매뿐입니다(최소 50 ₽ / 5 $ / 5 €).

1단계. 가입과 본인 확인

lava.top에 가입하고 프로필을 채우세요. 프로필이 비어 있으면 구매자에게 결제 페이지가 미완성처럼 보입니다.

그다음 Balance → 본인 확인으로 들어갑니다: 신분증과 셀피, 18세 이상, VPN은 꺼 둔 상태로.

본인 확인 전에도 판매는 가능하지만, 확인 없이는 돈을 출금할 수 없습니다. 첫 정산 때까지 미루지 마세요.

2단계. 상품 만들기

lava.top에서 판매하는 요금제마다 상품을 하나씩 만드세요.

정기 요금제에는 상품 유형 «구독»을 선택하세요. 그러면 lava.top이 알아서 청구하고, 갱신될 때마다 저희 쪽 이용 기간도 연장됩니다.
일회성 구매에는 고정 가격의 디지털 상품, 강의 또는 상담을 사용하세요.
오퍼에 지원 통화(RUB, USD, EUR) 중 하나 이상의 가격을 추가하세요. CreateYourVPN의 요금제 통화가 기본값이지만, 고객은 오퍼에 있는 어떤 통화든 선택할 수 있습니다.
청구 주기를 요금제 기간에 맞추세요: 월간 상품 ↔ 30일, 90일 ↔ 90 등.
상품은 «숨김» 노출 설정만으로 공개 lava.top 페이지에서 숨기세요. «가격은 API를 통해 문의»는 켜지 마세요. 이 연동은 고정 가격 오퍼로 결제를 만들며 API로 금액을 보내지 않습니다. 직접 구매는 저희 표식 없이 도착해 «미연결»이 될 수 있습니다. 숨긴 고정 가격 상품은 오퍼 선택기에 계속 표시됩니다.

lava.top은 상품의 가격을 오퍼(offer)라고 부릅니다. 한 상품에 여러 오퍼(통화와 주기가 다른)를 둘 수 있는데, 나중에 각 요금제에 고르는 것이 바로 이 오퍼입니다.

재구매하면 어떻게 되나

일회성 상품에는 갱신이 없습니다. 고객이 더 필요하면 그냥 다시 삽니다. 정상적인 흐름이고 미리 사 두어도 안전합니다 — 일수는 남은 기간에 더해지며, 처음부터 다시 세지 않습니다. 남은 열흘에 새 한 달을 더하면 사십 일이 됩니다.

예외가 하나 있습니다. 요금제가 트래픽도 준다면 용량은 교체되며 합산되지 않습니다. 100 GB를 사서 30 GB를 쓰고 같은 요금제를 다시 산 고객은 170 GB가 아니라 새 100 GB를 갖게 됩니다. 트래픽 요금제 가격을 정할 때 참고하세요.

3단계. CreateYourVPN에서 계정 연결하기

lava.top 쪽에서 필요한 것은 모두 한곳에 있습니다: 왼쪽 메뉴의 Integrations, API 카드입니다.

lava.top의 «Integrations» 섹션: API와 Web-Widget 카드

API 키 만들기

API 카드를 열고 **«Create API key»**를 누르세요. 키는 한 번만 표시됩니다 — 즉시 복사하세요. lava.top은 두 번 다시 보여주지 않으며, 잃어버린 키는 새 키로 교체하는 수밖에 없습니다.

API 키 페이지: «Create API key» 버튼과 웹훅 기록 링크

키를 캐비닛에 붙여넣기

CreateYourVPN에서 «수익화» 섹션을 열고 lava.top 카드의 **«연결»**을 누른 뒤, 키를 «lava.top API 키» 칸에 붙여넣고 저장하세요.

저희는 키를 즉시 확인해 «키가 승인되었습니다» — 계정에서 찾은 상품 수와 함께 — 또는 «lava.top이 이 키를 받아들이지 않았습니다»라고 답합니다.

저장 직후 같은 폼에 값이 두 개 더 나타납니다: 웹훅 URL과 웹훅 키입니다. 다음 단계에서 이 둘을 lava.top에 붙여넣습니다. 웹훅 키는 저희가 생성하므로 직접 만들 필요가 없습니다.

웹훅 만들기

lava.top은 키를 만든 직후에 이를 제안합니다 — **«+ Add Webhook»**을 누르세요. 같은 버튼은 나중에 API 페이지에도 있습니다.

«API key successfully added» 창과 «+ Add Webhook» 버튼

웹훅은 하나면 충분합니다 — 이벤트 유형 칸에서 필요한 유형을 한 번에 모두 선택하세요:

웹훅 추가 폼: URL, 이벤트 유형, 인증 방식, API 키 칸

URL — 캐비닛에 있는 웹훅 주소. lava.top은 HTTPS만 받는데, 저희 주소가 바로 그렇습니다.

Event type — 두 유형 모두 선택합니다: **«Payment result»**와 «Recurring payment». 다중 선택이 가능하므로 두 번째 웹훅은 만들 필요가 없습니다.

Type of authentication for Webhook — **«API key of your service»**를 고르고 «API key» 칸에 캐비닛의 웹훅 키를 붙여넣으세요. (Basic도 됩니다 — 저희는 받아들입니다 — 다만 칸이 하나가 아니라 둘입니다.)

Comment — 선택 사항, 본인을 위한 메모입니다. «CreateYourVPN — 결제» 같은 문구는 연동이 여러 개일 때 도움이 됩니다.

lava.top에는 요청 서명이 아예 없기 때문에, 이 전달이 여러분의 계정에서 왔다는 사실을 저희 수신부에 알려 주는 것은 웹훅 키뿐입니다 — 비밀번호처럼 다루세요.

구독을 판매한다면 «Recurring payment» 선택을 해제하지 마세요: 이 이벤트 유형이 없으면 갱신이 저희에게 도달하지 않아 결제한 고객의 이용 기간이 그냥 끝나 버립니다. 일회성 상품에는 **«Payment result»**만으로 충분하지만, 둘 다 선택해 두어도 안전합니다.

lava.top에는 «읽기 전용» 키가 없습니다 — API 키는 작가 계정에 대한 완전한 접근 권한을 줍니다. 저희는 딱 세 가지에만 사용합니다: 고객이 «결제»를 누른 순간 결제를 생성하는 것, 오퍼 선택기를 위해 상품 카탈로그를 읽는 것, 그리고 고객이 자기 캐비닛에서 자동 갱신을 끌 때 구독을 취소하는 것입니다. 가격을 바꾸지 않고, 매출 내보내기에 손대지 않으며, 이 키로 그 밖의 어떤 일도 하지 않습니다. 키는 암호화되어 저장되고 어디에도 다시 표시되지 않으며 저희 로그에도 남지 않습니다. 접근을 끊고 싶다면 캐비닛에서 연결을 삭제하세요 — 키도 함께 삭제됩니다.

4단계. 오퍼를 요금제에 연결하기

**«요금제»**를 열고 요금제로 들어가 lava.top 블록을 찾으세요:

**«상품 불러오기»**를 누르세요 — 여러분의 lava.top 계정에서 카탈로그를 가져옵니다.

이 요금제를 판매할 오퍼를 선택하세요. 목록에는 상품, 가격, 청구 주기가 표시됩니다.

경고가 뜨면 확인하세요. 오퍼에 요금제 통화의 가격이 없을 때, 그리고 청구 주기가 요금제 기간과 어긋날 때(«30일마다 청구하는데 요금제는 365일을 줍니다») 캐비닛이 알려 줍니다.

방금 lava.top에서 상품을 만들었는데 목록에 없나요? **«목록 새로고침»**을 누르세요 — 카탈로그는 1분간 캐시됩니다.

고객은 오퍼에 있는 어떤 통화든 선택할 수 있습니다. 루블 일회성 결제에는 카드와 SBP, 루블 구독에는 카드만, USD와 EUR에는 카드와 PayPal이 제공됩니다.

5단계. 실제 결제로 확인하기

가장 저렴한 요금제를 직접, 자기 스토어프론트의 고객 계정에서 구매해 보세요. 1분 안에 해당 계정에 요금제가 나타나고, 결제는 기록에 «처리됨» 상태로 보여야 합니다(«수익화» 섹션).

그렇지 않다면:

기록에 이벤트가 아예 없음 — lava.top의 웹훅이 잘못된 주소를 보고 있거나, 필요한 이벤트 유형이 선택되어 있지 않거나, 웹훅 키가 캐비닛의 값과 다릅니다. lava.top에는 재전송 버튼이 있는 웹훅 기록이 있으니 거기서부터 확인하세요;
이벤트는 있는데 «미연결» — 누구의 결제인지, 어떤 요금제인지 알아내지 못했습니다. 기록에서 바로 수동으로 연결하세요. 구독은 자동 결제와 동일한 코드로 부여됩니다;
«확인 필요» — 사람이 판단해야 하는 결제입니다: 고객이 캐비닛에서 차단되었거나, 결제가 생성된 뒤 요금제가 다른 lava.top 상품으로 옮겨졌습니다. 여기서 저희가 임의로 접근 권한에 손대지 않습니다 — 결정은 여러분의 몫입니다.

청구 실패는 당황할 일이 아닙니다. lava.top은 8시간 후와 24시간 후에 다시 시도하며, 한 번의 실패로 접근을 끊지 않습니다. 실패 알림은 마지막 시도 후에만 전송됩니다. 구독이 취소되면 다음 갱신은 이루어지지 않고, 이미 결제된 기간은 끝까지 유지됩니다.

돈에 관하여

**lava.top 수수료는 성공한 결제마다 8 %**입니다. 즉시 차감되며 나중에 고객에게 환불하더라도 돌려받지 못합니다.
환불은 lava.top 캐비닛의 «판매» 섹션에서 합니다. 구독의 환불은 구독을 취소합니다. 환불과 차지백 전용 웹훅 유형은 lava.top에 아직 없어서, 이들은 저희 기록이 아니라 lava.top 캐비닛에서 보게 됩니다.
자동 갱신 취소. 고객은 여러분의 스토어프론트에 있는 자기 캐비닛에서 직접 취소할 수 있고(그때 저희가 lava.top에 구독 취소를 요청합니다), 자신의 lava.top 계정에서도 할 수 있습니다. 여러분이 lava.top 캐비닛에서 대신 취소해 줄 수도 있습니다. 취소해도 접근 권한을 빼앗지는 않습니다. 이미 결제된 기간의 끝까지 유효하며, 저희는 그저 다음 청구를 기다리지 않을 뿐입니다.
차지백은 결제 후 540일까지 제기할 수 있고, 증빙 제출 기한은 3일입니다. 스토어프론트 약관과 고객과의 대화를 보관하세요 — 증빙이란 바로 그런 것입니다.
결제 한도: 최소는 항상 50 ₽ / 5 $ / 5 €입니다. 최대는 구독이 300 000 ₽ / 3 000 $ / 3 000 €, 일회성 상품이 1 000 000 ₽ / 10 000 $ / 10 000 €입니다.

키가 유출되면

lava.top 카드에는 서로 다른 버튼이 두 개 있고, 하는 일이 다릅니다:

«웹훅 키 재발급» — 수신 알림용 새 키를 발급합니다. 새 값을 lava.top의 웹훅에 붙여넣어야 하며, 그 전까지는 결제가 확인되지 않습니다.
«웹훅 URL 교체» — 새 주소를 발급합니다. 기존 주소는 즉시 작동을 멈추므로, 이것도 웹훅에서 갱신해야 합니다.

API 키 자체가 유출되었다면 lava.top에서 폐기하고 새로 만들어 캐비닛에 붙여넣으세요.