大口価格とボリューム段階
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での購入にも、アプリと同じルールが適用されます。コードのない番号や、最初のコードの前にキャンセルした番号は全額返金されます。
この記事は役に立ちましたか?
ありがとうございます。お役に立ててうれしいです。