このページは現在翻訳中です。

マルチカレンシー

- マルチカレンシーは現在ベータテスト中ですので、現在Omise Thailandご契約加盟店のみご利用可能いただけます。その他の国でOmiseをご利用中の加盟店には誠に恐縮ですが、ご提供開始まで今しばらくお待ちください。
- Omise Thailandのライブアカウントご利用加盟店様は、 APIをテスト運用いただくにあたり、事前に利用規約をご確認いただく必要がございます。お手数ですが、利用希望の旨を support@omise.co までご連絡ください。

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

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

Omiseはこの機能の利便性を高めるため、追加の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",

管理画面

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

Multi currency charge

返金

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

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

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

制限

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

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

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

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