決済設定 – 概要
リンクフォーム / ウィジェットが表示されると、パラメータで指定されたアプリケーショントークンに関連した店舗の決済設定を取得する為に自動的にAPIにリクエストを行います。
決済設定は、リンクフォーム / ウィジェットを動作する為に必要な様々な設定情報の集合です。
決済設定オブジェクト
| フィールド | データ型 | 備考 |
|---|
| mode | string | ウィジェットに設定されたアプリケーショントークンのモード |
| name | string | ストア名 |
| logo_image | string | ストアのロゴ画像のURL |
| recurring_token_privilege | string | このストアのリカーリングトークンの権限。none (なし), bounded (制限付き), infinite (無制限) のいずれか。 |
| card_configuration.enabled | boolean | カードが利用可能か |
| card_configuration.debit_enabled | boolean | デビットカードが利用可能か |
| card_configuration.prepaid_enabled | boolean | プリペイドカードが利用可能か |
| card_configuration.forbidden_card_brands | array[string] | このストアでの使用が許可されていないカードブランドのリスト |
| card_configuration.allowed_countries_by_ip | array[string] | IPアドレスが課金を許可されていない国のリスト |
| card_configuration.foreign_cards_allowed | boolean | 外国のカードを許可するかどうか。
外国のカードとは、その国がストアの国と同じではないカードを指す |
| card_configuration.fail_on_new_email | boolean | 以前に特定のメールアドレスで使用されたカードを許可するかどうか
trueの場合、別のメールアドレスで使用されているカードは拒否される |
| card_configuration.allow_empty_cvv | boolean | カード払いのCVVチェックを有効にするかどうか |
| card_configuration.card_limit.amount | number | 定義された期間、カードごとに利用を制限する金額 |
| card_configuration.card_limit.currency | string (ISO-4217) | amountが定義されている通貨 |
| card_configuration.card_limit.duration | string (ISO-8601) | 定義された期間、カードごとに利用を制限する金額 |
| qr_scan_configuration.enabled | boolean | QRコードが支払方法として利用可能かどうか |
| qr_scan_configuration.forbidden_qr_scan_gateways | array[string] | QRコード決済の処理に使用されない決済ゲートウェイのリスト |
| convenience_configuration.enabled | boolean | コンビニがペイメント方法として利用可能かどうか |
| theme.colors.main_background | string (HexColor) | 入力欄背景。入力フォームが表示されるエリアの背景色。デフォルトは #fafafa |
| theme.colors.secondary_background | string (HexColor) | ロゴとタイトルが含まれるエリアの背景色。デフォルトは #ee7a00 |
| theme.colors.main_color | string (HexColor) | ヘッダーと下部のボタンの背景色。デフォルトは #fafafa |
| theme.colors.primary_text | string (HexColor) | タイトル（デフォルトはストア名）の文字色。デフォルトは #fafafa |
| theme.colors.secondary_text | string (HexColor) | （指定がある場合は）ウィジェットのタイトル下部に表示される説明文の文字色。デフォルトは #222222 |
| theme.colors.base_text | string (HexColor) | 上記で指定されない他のテキストの文字色。デフォルトは #000000 |
| recurring_card_charge_cvv_confirmation.enabled | boolean | リカーリングトークンを使用するときに、このストアにCVV確認が必要かどうか |
| recurring_card_charge_cvv_confirmation.threshold | array[MoneyAmount] | CVV確認せずに課金可能な、ストアのデフォルト通貨での最大金額 |
| supported_brands | array[SupportedBrand] | 利用可能な決済ブランド |
MoneyAmount
| フィールド | データ型 | 備考 |
|---|
| amount | number | 小数点以下の金額 |
| currency | string (ISO-4217) | ISO-4217形式の通貨 |
SupportedBrand
| フィールド | データ型 | 備考 |
|---|
| brand | string | 対応しているブラント
payment_typeにより、次のいずれか
card: visa, mastercard, american_express, jcb, diners_club, unionpay, discover, maestro
qr_merchant: alipay_merchant_qr, alipay_connect_mpm, pay_pay_merchant, we_chat_mpm
online: alipay_online, alipay_plus_online, pay_pay_online, we_chat_online,dbarai_online
bank_transfer: aozora_bank
paidy: paidy |
| payment_type | string | 次のいずれか card, qr_merchant, online, bank_transfer, paidy |
| support_auth_capture | boolean | 仮売上のキャプチャが許可されているか |
| requires_full_name | boolean | 名前を必須にしているか |
| support_dynamic_descriptor | boolean | ダイナミックディスクリプタ―が利用可能か |
| requires_cvv | boolean | セキュリティコードが必須か |
| countries_allowed | array[string] | 許可されている国 |
| supported_currencies | array[string] | 許可された通貨 |
| cvv_auth | boolean | セキュリティコード認証を行うか |
| dynamic_info | boolean | 分割払いが利用可能か |
