支払い設定

支払い機能は、合法的に認可されたシナリオにおける内部決済、企業顧客の経理、またはコンプライアンスサービス料金に適用されます。デプロイ担当者は、関連サービス、料金、上位の認可、および運用方法が、現地の法令、上位のサービス規約、プラットフォーム規則、および支払いリスク管理要件に準拠していることを確認する必要があります。

ここでは、チャージ機能に関する設定を行うことができます。

支払い設定

Stripe

対応する決済ゲートウェイ

易支付（EPay）
- 必須項目：APIアドレス、マーチャントID（PID）、マーチャントキー（KEY）
- プラットフォームのコールバックパラメータには署名が含まれており、システムは検証を行い、自動的に入金処理を行います。
Stripe（オプション）
- 必須項目：APIキー WebHook署名キー 商品価格ID

易支付とは

易支付は、「第三者集約型決済ゲートウェイ/インターフェース」モデルの総称であり、特定のウェブサイトや企業を指すものではありません。商用集約型決済サービスを指すこともあれば、自社構築/オープンソースで「易支付プロトコルスタイル」に準拠したゲートウェイ実装を指すこともあります。

主な機能: WeChat Pay、Alipay、銀行カードなどのチャネルを集約し、マーチャントに統一された注文、署名検証、およびコールバックインターフェースを提供します。
コンプライアンスに関する注意: ゲートウェイ自体は、ライセンスを持つ決済機関とは異なります。資金の清算決済およびコンプライアンスは、接続先のライセンスを持つチャネルに依存するため、現地の規制およびリスク管理要件に従ってください。

チャージ方法設定テンプレート

「チャージ方法」では、以下の構造で設定できます。

[
  {
    "color": "rgba(var(--semi-blue-5), 1)",
    "name": "支付宝",
    "type": "alipay"
  },
  {
    "color": "rgba(var(--semi-green-5), 1)",
    "name": "微信",
    "type": "wxpay"
  },
  {
    "color": "rgba(var(--semi-green-5), 1)",
    "name": "Stripe",
    "type": "stripe",
    "min_topup": "50"
  },
  {
    "name": "自定义1",
    "color": "black",
    "type": "custom1",
    "min_topup": "50"
  }
]

フィールドの説明

name: 表示テキスト。「支払い方法を選択」ボタンに表示されます（例：「Alipay/WeChat/Stripe/カスタム1」）。
color: ボタン/バッジのテーマカラーまたはボーダーカラー。任意のCSSカラー値をサポートしており、既存のデザインシステムトークン（例： rgba(var(--semi-blue-5), 1)）の使用を推奨します。
type: チャネル識別子。バックエンドのルーティングと注文に使用されます。
- stripe → Stripeゲートウェイを使用します。
- その他（例： alipay、wxpay、custom1 など）→ 易支付スタイルのゲートウェイを使用し、この値をチャネルパラメータとして透過的に渡します。
- 詳細なロジックはバックエンドコントローラ controller/topup.go を参照してください（参照: controller/topup.go）。
min_topup: 最低チャージ金額（単位はページ通貨と一致）。入力金額がこの値より小さい場合、ページには「この支払い方法の最低チャージ金額はXです」と表示され、支払いの開始が制限されます。バックエンドでも検証が行われます。
ソート: 配列の順序に従って左から右へレンダリングされます。

チャージ金額設定

カスタムチャージ数量オプション

ユーザーが選択できるチャージ数量オプションを設定します。例えば：

[10, 20, 50, 100, 200, 500]

これらの数値は「チャージ額を選択」エリアに表示され、ユーザーは直接クリックして対応するチャージ金額を選択できます。

チャージ金額割引設定

異なるチャージ金額に対応する割引を設定します。キーはチャージ金額、値は割引率です。例えば：

{
  "100": 0.95,
  "200": 0.9,
  "500": 0.85
}

キー：チャージ金額（文字列形式）
値：割引率（0〜1の間の小数。例：0.95は95%の価格、つまり5%割引を表します）
システムは設定に基づいて、実際の支払い金額と節約金額を自動的に計算します。
割引機能の使用は、認可範囲、上位のサービス規約、プラットフォーム規則、および現地の法令要件に準拠する必要があります。
詳細な実装ロジックはバックエンドコントローラ controller/topup.go を参照してください。