マルチカレンシー

この度、Opn Paymentsではタイバーツ（THB)、米ドル（USD)、ユーロ（EUR)、英ポンド（GBP)、日本円（JPY)、そしてシンガポールドル（SGD)の6種類の通貨で課金の受領が可能となりました。

マルチカレンシーの課金作成は非常にシンプルです。課金を作成する際には、受領する希望の通貨を指定することができます。Opn Paymentsは、自動的に換金処理を行い、現地通貨をお客様の口座に入金致します。

Opn Paymentsはこの機能の利便性を高めるため、追加のAPIも提供しています。

この機能に関する詳細、重要な規約をご確認ください。

マルチカレンシーの課金を作成する

別通貨での課金作成は、通常の charge（課金）を作成するのと同様です。currency（通貨）パラメータの値をご希望の通貨に変更しご利用ください。

Forex APIにリクエストを送信し、使用為替レート（10分以内）を確認することができます。有効なminimum and maximum charge amount（最小・最大課金額）は、為替レートによって異なります。

課金リクエスト

下記の curlスニペットは1000米ドルの課金を作成する方法を示しています。：

curl https://api.omise.co/charges \
  -X POST \
  -u skey_test_57rlyvu8iyjhu1gx6b2: \
  -d "amount=100000" \
  -d "currency=usd" \
  -d "card=tokn_test_5eihqwlbykc5xp7lkeo"

課金レスポンス

下記のJSONの抜粋は、上記のコマンドの応答を示しています。　

{
    "object": "charge",
    "id": "chrg_test_5eihqy40lburr9pwj3p",
    "livemode": false,
    "location": "/charges/chrg_test_5eihqy40lburr9pwj3p",
    "amount": 100000,
    "currency": "usd",
    "funding_amount": 3328532,
    "funding_currency": "thb",
    "transaction": "trxn_test_5eihqy6cn0q7ylicbyz",

属性、funding_amount（資金額）はfunding_currency（口座通貨）へ変換された後のamount（額）が表示されます。

取引レスポンス

資金は常に登録されている口座通貨で決済されます。 上記のtransaction（取引）（trxn_test_5e95tvtbghmpc8vz5jz）から、アカウント内currency（通貨）入金額（手数料差引後の）を確認できます。

{
    "object": "transaction",
    "id": "trxn_test_5eihqy6cn0q7ylicbyz",
    "location": "/transactions/trxn_test_5eihqy6cn0q7ylicbyz",
    "type": "credit",
    "amount": 3198537,
    "currency": "thb",

管理画面

下記のスクリーンショットは、ダッシュボードに表示される課金額を示しています。下記のスクリーンショットは、ダッシュボードに表示される課金額を示しています。

返金

通常どおりrefund API、またはdashboard（管理画面）から、マルチカレンシーの全額または一部返金を作成できます 。

注：APIを介してマルチカレンシーの返金処理を行う場合、amountパラメータは課金された時の同じ通貨として処理されます。

curl https://api.omise.co/charges/chrg_test_4ype2jynk2len88i4er/refunds \
  -X POST \
  -u skey_test_4ypcvnwzy9ob6gs89pn: \
  -d "amount=10000"

制限

マルチカレンシーの機能は、現在Opn Payments Thailandご契約加盟店のみご利用可能いただけます。 他の国々へのサポートは近々始まります。

マルチカレンシーの課金は、クレジットカードとデビットカード（VisaとMastercard）のみ可能です。インターネットバンキングやAlipayなどでの別方法での決済は、ご自分のアカウントで登録された通貨で課金してください。

マルチカレンシーの有効化

Opn Payments Thailandのライブアカウントをお持ちのユーザーの場合は、support@opn.oooまでメールをお送りください。APIをテストする前に利用規約を確認していただく必要があります。