맞춤형 결제 통합¶
이 항목에서는 WHMCS(예: Blesta, Hostbill, Ubersmith 등)를 제외한 모든 결제 시스템 과 후불 결제 통합을 설정하는 방법에 대해 설명합니다.
1단계 - 토큰과 통화 간의 전환율 정의¶
SolusVM 2는 시간별 및 월별 청구를 제공합니다. 하나의 토큰에 드는 실제 화폐(원하는 통화)가 얼마인지 결정합니다.
Note
토큰은 정수만 가능합니다.
다음과 같은 상세한 변환표를 준비하는 것이 좋습니다.
| 토큰 | 토큰 가격(USD) | 토큰 가격(EUR) |
| 1 | $0.00100 | €0.00091 |
| 10 | $0.01000 | €0.00910 |
| 100 | $0.10000 | €0.09100 |
| 1,000 | $1.00000 | €0.91000 |
| 10,000 | $10.00000 | €9.10000 |
2단계 – 시간당 및 월별 가격 계산¶
전제 조건: 이미 계획을 추가했다고 가정해 보겠습니다. 그렇지 않다면 지금이 그렇게 해야 할 때입니다.
이제 계획에 얼마를 청구할지 결정해야 합니다. SolusVM 2의 각 계획은 토큰으로 시간별 및 월별 가격을 가질 수 있습니다.
- "시간당 토큰"은 시간당 리소스 사용에 대한 토큰 가격입니다.
예를 들어, 서버를 시작하고 5분 후에 종료한다면 서버 사용자는 1시간에 대한 비용을 지불해야 합니다.
- "월별 토큰"은 대략 한 달 동안 리소스를 사용하는 데 대한 토큰 가격입니다.
달의 길이는 다르지만 월별 가격은 고정되어 있습니다. 이를 달성하려면 월별 한도를 계산하여 월별 가격을 설정합니다. 예를 살펴보겠습니다.
우리는 7개 토큰의 시간당 가격을 가지고 있습니다($0.007/h와 동일). 전체 31일 월 비용은 다음과 같습니다.
7개 토큰 × 24시간 × 31일 = 7 × 744시간 = 5208개 토큰($5.21)
사람들은 둥근 숫자를 좋아합니다. 208개 토큰($0.21)을 공제하고 5000개 토큰($5.00)의 가격을 얻을 수 있습니다. 이것이 월별 한도이자 월별 가격이 됩니다. SolusVM 2는 월별 가격에 따라 청구할 가격(시간별 또는 월별)을 선택합니다.
예를 들어, 사용자가 700시간 동안 서버를 실행했는데, 그 비용은 4900 토큰입니다. 월간 한도의 토큰 5000개 미만이므로 사용자에게 시간당 요금이 청구됩니다. 다음 달에 사용자는 730시간 동안 서버를 운영했는데, 그 비용은 5110 토큰입니다. 월별 한도는 5000개 이상의 토큰이므로 사용자에게 월별 요금($5.00)이 청구됩니다.
SolusVM 2에서 실제로 설정하기 전에 시간별 및 월별 가격을 계산하는 것이 좋습니다. 아래에서는 1단계에 표시된 변환표를 사용하여 가격을 계산한 방법의 예를 볼 수 있습니다.
| 계획 | 시간당 토큰 | 월별 집계 토큰(시간당 토큰 × 24시간 × 31일) | 월간 집계 가격(USD) | 월별 토큰(고정 가격) | "월별 토큰"이 적용된 경우 월별 가격(USD) |
| 1코어, 1GiB RAM | 7 | 5,208 | $5.21 | 5,000 | $5.00 |
| 1코어, 2GiB RAM | 14 | 10,416 | $10.42 | 10,000 | $10.00 |
| 2코어, 2GiB RAM | 21 | 15,624 | $15.62 | 15,000 | $15.00 |
| 2코어, 4GiB RAM | 28 | 20,832 | $20.83 | 20,000 | $20.00 |
Note
위 예에서는 월별 가격(마지막 두 열)을 반올림했습니다. 고객님들께 더욱 편리하고 월별 할인혜택도 가능합니다. 똑같이 할 것인지 말 것인지는 당신에게 달려 있습니다.
3단계 – SolusVM 2 계획에 대한 토큰 가격 설정¶
이전 단계에서는 세부 가격표를 생성했습니다. 이제 SolusVM 2의 계획에 대해 시간당 및 월별 가격 (각각 가격표의 두 번째 및 다섯 번째 열)을 설정해야 합니다.
-
SolusVM 2에 로그인합니다.
-
컴퓨팅 리소스 > 계획으로 이동합니다.
-
기존 계획을 편집하거나 새 계획을 생성하는 동안 토큰 값을 지정할 수 있습니다.
-
기존 계획을 편집하려면 계획 행에서
아이콘을 클릭하세요. -
새 계획을 만들려면 계획 추가를 클릭하세요.
-
"시간당 토큰" 및 "월당 토큰"에서 각각 토큰으로 시간당 및 월간 가격을 지정합니다.
-
계획을 작성하는 경우 도 필수 필드를 입력하세요.
!!! note
'월별 토큰'을 '0'으로 설정하면 시간별 과금만 가능합니다.
'시간당 토큰'을 '0'으로 설정했지만 '토큰(월)' 값을 지정하면
이면 시간별 과금을 사용할 수 없습니다.
고객에게는 항상 "월별 토큰"으로 정의된 고정 월별 가격이 청구됩니다.
- 저장을 클릭합니다.
4단계 - SolusVM 2 사용자 영역에서 등록 비활성화¶
SolusVM 2로 구성된 청구 시스템은 SolusVM 2 사용자를 위한 기본 데이터베이스여야 합니다. 청구 시스템 데이터베이스만이 사용자에게 서버 생성 권한이 있거나 없는 을 제어해야 합니다.
그러나 SolusVM 2에는 사용자가 서버를 생성하는 "사용자 영역" 이라는 인터페이스의 일부가 있습니다. 사용자 영역에서 직접 사용자를 생성하여 빌링 시스템 데이터베이스 를 우회하는 것이 가능합니다. 이를 방지하려면 사용자 영역에서 등록을 비활성화해야 합니다.
- SolusVM 2에 로그인합니다.
- 설정 > 사용자 영역으로 이동하여 “등록 활성화” 확인란을 선택 취소하세요.
- 저장을 클릭합니다.
사용자 영역에서 등록을 비활성화했습니다. 청구 시스템 데이터베이스는 이제 SolusVM 2 사용자를 위한 기본 데이터베이스입니다.
5단계 – 제한 그룹 생성¶
제한 그룹은 특정 사용자가 생성하고 실행 상태를 유지할 수 있는 서버 수에 대한 제한을 설정하는 데 도움이 됩니다. 제한 그룹을 생성하고 새 사용자에 대한 기본 제한 그룹을 선택하는 것이 좋습니다. 방법 알아보기.
6단계 - 청구 시스템 측에서 API 엔드포인트 구성¶
이제 청구 시스템 측에서 GetTokenPricing 엔드포인트를 구성해야 합니다.
원하는 코딩 언어로 쉽게 구성할 수 있습니다.
SolusVM 2가 고객에게 가격을 표시하려면 이 엔드포인트가 필요합니다.
Note
현재로서는 GetTokenPricing 엔드포인트만 구성하면 됩니다.
하지만 향후 API 엔드포인트 목록을 확장할 수 있습니다.
GetTokenPricing 엔드포인트에는 다음과 같은 요청 및 응답 매개변수가 있습니다.
요청 매개변수¶
| 매개변수 | 유형 | 설명 | 필수의 |
| '토큰' | 끈 | 인증 토큰 | 아니요 |
| `userid` | int | 결제 시스템의 사용자 ID | 예 |
응답 매개변수¶
| 매개변수 | 유형 | 설명 |
| `base_token_unit_cost` | 뜨다 | 할인 및/또는 세금 전 토큰 1개의 가격입니다. |
| `user_token_unit_cost` | 뜨다 | 할인 및 세금을 포함한 하나의 토큰의 전체 및 최종 가격입니다. |
| `currency` | 정렬 | ISO 코드, 접두사, 접미사, 소수 자릿수, 천 단위, 소수 구분 기호 등 통화 형식 매개변수로 구성된 배열입니다. 예: ``` "currency": { "code": "GBP", "display_prefix": "\u00a3", "display_suffix": " GBP", "thousands_separator ": ",", "decimals_separator": ".", "decimals_per_month": 2, "decimals_per_hour": 4 } ``` |
| `discounts` | 정렬 |
이름, 설명, 승수로 구성된 적용된 할인의 배열입니다.
예:
|
| `taxes` | 정렬 | 세금 유형(복합 여부) 및 세율(라벨 및 세율)을 포함한 세금 정보 배열입니다. 예: ``` "세금": { "복합": true, "세율": [ { "label": "시세", "세율": 6 }, { " label": "주세", "세율": 2 } ] } ``` |
SolusVM 2가 고객에게 가격을 표시해야 할 때
SolusVM 2는 사용자 ID
와 함께 API 요청을 GetTokenPricing 엔드포인트로 보냅니다.
curl -X POST "https://www.mybilling.com/solusio/api/"
\ -H "Accept: application/json"
\ -H "Content-Type: application/x-www-form-urlencoded"
\ -d "token=xxxxxxx&action=GetTokenPricing&userid=1"
그런 다음 결제 시스템은 가격 관련 정보가 포함된 API 응답을 보냅니다. 예를 들면 다음과 같습니다.
{
"base_token_unit_cost": 1.34,
"user_token_unit_cost": 1.0812,
"currency": {
"code": "GBP",
"display_prefix": "\u00a3",
"display_suffix": " GBP",
"thousands_separator": ",",
"decimals_separator": ".",
"decimals_per_month": 2,
"decimals_per_hour": 4
},
"discounts": [
{
"name": "Special Client Group Discount",
"description": "5% Recurring Discount",
"multipler": 0.95
}
],
"taxes": {
"compound": true,
"rates": [
{
"label": "City Tax",
"rate": 6
},
{
"label": "State Tax",
"rate": 2
}
]
}
}
응답의 user_token_unit_cost는 특정 사용자의
모든 세금, 할인 및 특별 혜택을 반영하는 계수입니다.
그런 다음 SolusVM 2는 user_token_unit_cost에 계획의 토큰 가격을 곱하고
는 통화로 실제 가격(이 예에서는 파운드)
을 가져와 이 가격을 사용자에게 보여줍니다.
7단계 - SolusVM 2에서 청구 통합 활성화¶
청구 시스템 측에서 API 엔드포인트를 구성했습니다. 이제 그것을 사용하겠습니다.
- SolusVM 2에 로그인합니다.
- 설정 > 결제 통합으로 이동합니다.
- '유형'에서 '맞춤 결제'를 선택하세요.
- 청구 시스템 측에서
GetTokenPricing엔드포인트의 URL을 (예:https://www.mybilling.com/solusio/api/) 지정합니다. - (선택 사항) 결제 시스템에서 승인을 위해 토큰이 필요할 수 있습니다. 그렇다면 결제 시스템 승인 토큰을 붙여넣으세요.
- 저장을 클릭합니다.
8단계 – 청구 시스템 측에서 SolusVM 2와 사용자 관리 통합¶
청구 시스템은 필요할 때 SolusVM 2의 사용자를 관리해야 합니다.
이를 위해서는 결제 시스템 측에서 SolusVM 2와 사용자 관리 통합 을 설정해야 합니다. 그렇게 하면 결제 시스템에서 잠금 및 일시 중지 SolusVM 2 API 엔드포인트를 사용하는 SolusVM 2의 사용자.
Note
사용자 관리를 통합할 때,
청구 시스템이 SolusVM 2에 billing_user_id 를 전송하는지 확인하세요.
SolusVM 2에는 청구 시스템에 저장된 사용자와 일치하도록 billing_user_id 가 필요합니다.
SolusVM 2에 저장된 것과 함께.
9단계 - SolusVM 2에 자동 로그인 구성¶
청구 시스템은 사용자를 SolusVM 2 사용자 영역으로 리디렉션합니다. 사용자가 두 번째 로그인 없이 SolusVM 2에 들어갈 수 있도록 자동 로그인을 구성합니다. 그러기 위해서는 먼저 사용자에 대한 액세스 토큰을 생성 해야 합니다. 그런 다음 토큰이 포함된 로그인 링크를 사용하여 통합 스크립트에서 사용자에게 권한을 부여합니다.
GET https://www.solus-user-ui.com/auth/by_token/{access_token}
10단계 - 청구 시스템 측에서 송장 생성 구성¶
마지막 단계로, /usage SolusVM 2에 API 요청을 보내도록 결제 시스템 을 구성해야 합니다. API 엔드포인트.
청구 주기가 끝나면 청구 시스템에서 청구서를 생성하여 사용자에게 보냅니다.
요금을 계산하려면 결제 시스템이 /usage 엔드포인트에 API 요청을 보내 소비된 리소스 통계
를 받아야 합니다.
축하해요! SolusVM 2와 청구 시스템 통합을 완료했습니다. 우리는 이미 돈이 들어오기를 바랍니다.