適応通貨

​

仕組み

​

主なメリット

• 現地通貨でのチェックアウト — デフォルトで顧客の現地通貨で価格を表示
• より多くの決済手段 — 現地通貨でのみ利用可能な決済手段を利用可能
• 同一通貨での返金 — 顧客が支払った通貨で返金
• 高度な価格設定 — Purchasing Power Parity と Charm Pricing を有効にし、市場ごとの価格を自動的に最適化

​

Adaptive Currency を有効にする

​

顧客体験

1. 検出 — システムが請求先住所に基づいて顧客の国を検出します
2. 通貨の選択 — 国が対応している場合、デフォルトで現地通貨の価格が表示されます。顧客は基準通貨に戻すこともできます
3. 決済手段 — 利用可能な場合、現地向けの決済手段が表示されます
4. チェックアウト — 選択した通貨で支払いが完了します

​

換算と手数料

• $500 未満の注文：4%
• $500 以上 $1,500 以下の注文：3%
• $1,500 を超える注文：2%

​

Fees Inclusive を有効にする

​

リクエストごとの上書き

// Note: POST /payments is deprecated. Checkout sessions don't accept
// `adaptive_currency_fees_inclusive` for one-time payments, so this override
// still runs through the one-time payment route.
const payment = await client.payments.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  customer: { customer_id: 'cus_123' },
  billing: { country: 'US' },
  adaptive_currency_fees_inclusive: true, // override the business setting for this payment
  return_url: 'https://yoursite.com/return'
});

​

対応通貨

​

返金と調整

​

返金の例

1. Adaptive Currency を有効にして、100 USD で商品を販売します
2. カナダの顧客には、1 USD = 1.37 CAD の為替レートで 137 CAD と表示され、購入が完了します
3. Dodo Payments は支払いを処理し、決済金額として 137 CAD を 100 USD に換算します
4. その後、為替レートが 1 USD = 1.40 CAD に変わり、全額返金を実行します
5. Dodo Payments は 100 USD を差し引き、顧客に 140 CAD を返金します

​

請求書と税金

• 請求書には決済通貨の金額のみが表示されます
• 税金とプラットフォーム手数料は決済通貨の金額に基づいて計算されます
• 例：10 ドルの販売額を 36 AED に換算しても、Dashboard と請求書には 10 ドルとして表示されます

​

チェックアウトごとに請求通貨を設定する

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_one_time_or_subscription',
      quantity: 1
    }
  ],
  billing_currency: 'AED',
  return_url: 'https://example.com/return'
});

​

関連ページ