대량 구매 가격과 볼륨 등급
API는 앱과 같은 가격에서 대량 구매 할인을 뺀 금액으로 판매합니다. 할인은 30일 지출에 따른 볼륨 등급 또는 리셀러 고정 할인입니다.
개발자 API는 모든 번호를 앱과 같은 가격으로 판매합니다. 그다음 이용량이 늘수록 대량 구매 할인이 가격을 낮추며, 같은 할인이 어디서 구매하든 적용됩니다. 앱, 웹사이트, Telegram 봇, API 모두 같습니다.
계산식
price = ceil( list_price × (100 − discount_percent) / 100 )
price = max( price, minimum_price )
price = min( price, list_price )
list_price 값은 앱에서의 번호 가격입니다. 결과는 다음 센트로 올림합니다. 아주 저렴한 일부 번호에는 최저 가격이 있어 할인 폭이 작을 수 있으며, 가격이 정가를 넘는 일은 없습니다.
볼륨 등급
할인은 모든 채널을 합산한 최근 30일 순지출(청구액에서 환불액을 뺀 금액)에 따라 정해집니다. 지출이 등급 기준을 넘으면 약 5분 안에 이후 구매하는 모든 번호에 할인이 적용되고, 30일 지출이 기준 아래로 내려가면 등급이 내려갑니다. 현재 등급은 웹사이트의 대량 구매 페이지와 GET /dev/v1/me 응답에서 확인할 수 있습니다.
리셀러 할인
승인된 리셀러는 월 이용량과 관계없이 모든 번호에 고정 할인을 받습니다. 리셀러 할인과 볼륨 등급 중 항상 더 큰 쪽이 적용됩니다. 리셀러는 구매마다 customer_ref 값을 붙일 수 있고, GET /dev/v1/statement 호출로 일별, 고객별, 서비스별 명세서를 받을 수 있습니다. 신청은 웹사이트의 대량 구매 페이지에서 하며, 자세한 내용은 개발자 문서에 있습니다.
내 가격 확인하기
GET /dev/v1/prices호출은 할인이 반영된 상품별 현재 가격을 정가와 함께 돌려줍니다.GET /dev/v1/me호출은 할인율, 할인 종류, 30일 지출, 현재 등급, 다음 등급까지 남은 금액을 보여 줍니다.
curl -s https://smsgrab.com/api/dev/v1/me \
-H "Authorization: Bearer $SMSGRAB_KEY"
{ "pricing": {
"discount_percent": 5, "source": "tier", "program_enabled": true,
"trailing_30d_spend_minor": 31250,
"tier": { "level": 2, "min_spend_minor": 25000, "discount_percent": 5 },
"next_tier": { "level": 3, "min_spend_minor": 100000, "discount_percent": 8,
"remaining_minor": 68750 } } }
가격 보호
가격은 구매하는 순간 확정되어 활성화 정보와 함께 저장됩니다. 구매할 때마다 max_price_minor 값을 보내세요. 가격이 그보다 오르면 구매는 409 PRICE_CHANGED 응답과 함께 거부되고 아무것도 차감되지 않습니다.
환불
API 구매에도 앱과 같은 규칙이 적용됩니다. 코드가 없는 번호나 첫 코드 전에 취소한 번호는 전액 환불됩니다.
이 문서가 도움이 되었나요?
감사합니다! 도움이 되었다니 기쁩니다.