# FPX の支払いを受け付ける

マレーシアで一般的な支払い方法である FPX を受け付ける方法について説明します。

# Checkout

> This is a Checkout for when payment-ui is checkout. View the full page at https://docs.stripe.com/payments/fpx/accept-a-payment?payment-ui=checkout.

> Stripe は、通貨、支払い方法の制限、その他のパラメーターを評価することで、適切な支払い方法を顧客に自動的に提示できます。
> 
> - [決済の受け付け](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=checkout&ui=stripe-hosted)ガイドに従って、[動的な決済手段](https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods.md)を使用するチェックアウトの統合機能を構築します。
- 動的な決済手段を使用しない場合は、チェックアウトの導入で、決済方法を手動で設定するために以下のステップに従ってください。

FPX は [1 回限りの使用](https://docs.stripe.com/payments/payment-methods.md#usage)の支払い方法です。FPX を使用して支払う場合、顧客はお客様のウェブサイトからリダイレクトされ、支払いの送信後に、ウェブサイトに戻ります。ここで、お客様は支払いが成功したか失敗したかについて[即時の通知](https://docs.stripe.com/payments/payment-methods.md#payment-notification)を受け取ります。

## 互換性を判断する

**顧客の居住地**: Malaysia

**対応可能な通貨**: `myr`

**取引通貨**: `myr`

**支払いモード**: Yes

**セットアップモード**: No

**サブスクリプションモード**: No

FPX 支払いに対応するには、Checkout セッションが次の条件をすべて満たしている必要があります。

- すべてのラインアイテムの*価格* (Prices define how much and how often to charge for products. This includes how much the product costs, what currency to use, and the interval if the price is for subscriptions)が、同じ通貨である必要があります。異なる通貨のラインアイテムが存在する場合は、通貨ごとに別の Checkout セッションを作成します。
- 使用できるのは単一の項目だけです (継続的な*サブスクリプション* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis)プランには対応していません)。

## 決済を受け付ける

> このガイドを使用する前に、まず Checkout で[決済を受け付ける](https://docs.stripe.com/payments/accept-a-payment.md?integration=checkout)ための実装を構築します。

このガイドでは、FPX を有効化する手順をご案内します。動的な決済方法を使用して支払いを受け付ける方法と、決済方法を手動で設定する方法との違いを明らかにしています。

### 支払い方法として FPX を有効にする

新しい [Checkout Session (セッション)](https://docs.stripe.com/api/checkout/sessions.md) を作成する際は、以下を行う必要があります。

1. `fpx` を `payment_method_types` のリストに追加します
1. すべての `line_items` が `myr` 通貨を使用していることを確認します

#### Stripe がオンラインで提供するページ

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "line_items[0][price_data][currency]=myr" \
  -d "line_items[0][price_data][product_data][name]=T-shirt" \
  -d "line_items[0][price_data][unit_amount]=2000" \
  -d "line_items[0][quantity]=1" \
  -d mode=payment \
  -d "payment_method_types[0]=card" \
  -d "payment_method_types[1]=fpx" \
  --data-urlencode "success_url=https://example.com/success"
```

#### 組み込みフォーム

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "line_items[0][price_data][currency]=myr" \
  -d "line_items[0][price_data][product_data][name]=T-shirt" \
  -d "line_items[0][price_data][unit_amount]=2000" \
  -d "line_items[0][quantity]=1" \
  -d mode=payment \
  -d "payment_method_types[0]=card" \
  -d "payment_method_types[1]=fpx" \
  --data-urlencode "return_url=https://example.com/return" \
  -d ui_mode=embedded_page
```

### 注文のフルフィルメント

決済受け付け後に、[注文のフルフィルメントを実行](https://docs.stripe.com/checkout/fulfillment.md)する方法を説明します。

### 確認ページ

FPX では、購入者が支払いを完了した後に、取引情報を購入者に表示する必要があります。成功ページをカスタマイズする場合は、[成功ページをカスタマイズする](https://docs.stripe.com/payments/checkout/custom-success-page.md)ためのガイドに従ってください。

カスタマイズする際は、Checkout セッションの PaymentIntent ID を使用して、[PaymentIntent (支払いインテント)](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-latest_charge) オブジェクトから直接 Charge オブジェクトを取得し、`success_url` ページに以下の情報を表示する必要があります。

| 情報        | 情報のソース                                                          |
| --------- | --------------------------------------------------------------- |
| 取引日時      | `Charge` オブジェクトの `created`。                                     |
| 金額        | `Charge` オブジェクトの `amount`。                                      |
| 売り手の注文番号  | `Charge` オブジェクトの `statement_descriptor`。                        |
| FPX 取引 ID | `Charge` オブジェクトの `payment_method_details[fpx][transaction_id]`。 |
| 買い手の銀行名   | `Charge` オブジェクトの `payment_method_details[fpx][bank]`。           |
| 取引ステータス   | `Charge` オブジェクトの `status`。                                      |

## 連携をテストする

Checkout の組み込みをテストする際は、支払い方法として FPX を選択して、**支払い**ボタンをクリックします。

## 返金および不審請求の申請に対応する

FPX の返金期間は、元の支払い日から最長 60 日間です。

不審請求の申請プロセスはありません。顧客は各自の銀行で認証を行います。

## See also

- [FPX の詳細](https://docs.stripe.com/payments/fpx.md)
- [Checkout のフルフィルメント](https://docs.stripe.com/checkout/fulfillment.md)
- [Checkout のカスタマイズ](https://docs.stripe.com/payments/checkout/customization.md)


# Elements

> This is a Elements for when payment-ui is elements. View the full page at https://docs.stripe.com/payments/fpx/accept-a-payment?payment-ui=elements.

> このセクションには*レガシー* (Technology that's no longer recommended)プロダクトについてのコンテンツが含まれています。最新の導入パスについては、代わりに[決済を受け付ける](https://docs.stripe.com/payments/accept-a-payment.md)のガイドを使用する必要があります。Stripe はこのプロダクトを引き続きサポートしていますが、プロダクトが非推奨になった場合にはサポートが終了する可能性があります。

FPX は [1 回限り](https://docs.stripe.com/payments/payment-methods.md#usage)の決済手段です。FPX を使用して支払う場合、顧客はお客様のウェブサイトからリダイレクトされ、支払いの送信後に、ウェブサイトに戻ります。ここで、お客様は支払いが成功したか失敗したかに関する[即時通知](https://docs.stripe.com/payments/payment-methods.md#payment-notification)を受け取ります。

FPX 決済を有効にするには、以下の手順に従います。

1. Go to the [Payment methods settings](https://dashboard.stripe.com/settings/payment_methods) in the Dashboard. If you haven’t already, [set up your Stripe account](https://docs.stripe.com/get-started/account/set-up.md).
1. **銀行へのリダイレクト**で FPX を探し、**有効にする**を選択します。
1. FPX の利用規約に同意します。

FPX を利用できるのは、マレーシアに拠点を置く事業者のみです。Stripe プロダクトと互換性のある国、通貨、決済手段について詳しくは[決済手段サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md)をご覧ください。

> FPX は 1 回限りの決済手段のため、継続的な決済や追加の決済には使用できません。FPX は現在 [Stripe Billing](https://stripe.com/billing) では対応していません。[Custom アカウント](https://docs.stripe.com/connect/custom-accounts.md)の FPX 決済への対応はベータです。サポートに関するご質問は、[Stripe サポート](https://support.stripe.com/contact)までお問い合わせください。

## Stripe を設定する [サーバ側]

まず、Stripe アカウントが必要です。[今すぐ登録](https://dashboard.stripe.com/register)してください。

アプリケーションから Stripe API にアクセスするには、Stripe の公式ライブラリを使用します。

#### Ruby

```bash
# Available as a gem
sudo gem install stripe
```

```ruby
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'
```

## PaymentIntent を作成する [サーバ側]

[PaymentIntent (支払いインテント)](https://docs.stripe.com/api/payment_intents.md) は、顧客から支払いを回収する意図を表すオブジェクトであり、支払いプロセスのライフサイクルの[各段階](https://docs.stripe.com/payments/paymentintents/lifecycle.md)を追跡します。金額が分かり次第 (決済プロセスの最初など)、PaymentIntent を作成してください。PaymentIntent を作成するには、次の値が必要です。

| パラメータ                  | 値                                                                                                                                                                       |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payment_method_types` | **fpx**                                                                                                                                                                 |
| `amount`               | [最小通貨単位](https://docs.stripe.com/currencies.md#zero-decimal)の正の整数で、顧客に請求する金額を表します (たとえば、RM10.99 の支払いの場合は **1099**)。Stripe は、取引ごとに最小額の RM2 から最大額の RM30,000 までをサポートしています。 |
| `currency`             | **myr** (FPX は常にリンギットを使用する必要があります)                                                                                                                                      |

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "payment_method_types[]=fpx" \
  -d amount=1099 \
  -d currency=myr
```

金額が後で (配送手数料や税金の計算時などに) 変更された場合、[amount (金額)](https://docs.stripe.com/api.md#payment_intent_object-amount) を [更新](https://docs.stripe.com/api.md#update_payment_intent)することもできます。

```curl
curl https://api.stripe.com/v1/payment_intents/pi_1DRuHnHgsMRlo4MtwuIAUe6u \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1499
```

## 支払い方法の詳細を収集する [クライアント側]

[Stripe Elements](https://docs.stripe.com/payments/elements.md) は支払い詳細を収集するための事前構築された UI コンポーネントのセットです。Elements は、Stripe.js の機能として自動的に使用可能になります。決済ページに Stripe.js スクリプトを含めるには、HTML ファイルの `head` にそのスクリプトを追加します。Stripe.js を常に js.stripe.com から直接読み込むことで、PCI への準拠が維持されます。スクリプトをバンドルに含めたり、そのコピーを自身でホストすることがないようにしてください。

```html
<head>
  <title>Checkout</title>
  <script src="https://js.stripe.com/dahlia/stripe.js"></script>
</head>
```

決済ページで以下の JavaScript を使用して、Elements のインスタンスを作成します。

```javascript
const stripe = Stripe('<<YOUR_PUBLISHABLE_KEY>>');
const elements = stripe.elements();
```

Elements には、支払いフォーム内の配置場所が必要です。支払いフォームに一意の ID を持つ空の DOM ノード (コンテナ) を作成し、それらの ID を Elements に渡します。

```html
<form id="payment-form">
  <div class="form-row">
    <div>
      <label for="fpx-bank-element">
        FPX Bank
      </label>
      <div id="fpx-bank-element">
        <!-- A Stripe Element will be inserted here. -->
      </div>
    </div>
  </div>

  <button id="fpx-button" data-secret="{{ CLIENT_SECRET }}">
    Submit Payment
  </button>

  <!-- Used to display form errors. -->
  <div id="error-message" role="alert"></div>
</form>
```

> このドキュメントでは、最新バージョンの Stripe.js では使用できなくなった*レガシー* (Technology that's no longer recommended)機能について説明しています。[Payment Element](https://docs.stripe.com/payments/payment-element.md)の使用をお勧めします。これは、40 以上の支払い方法を受け付け、入力を検証し、エラーを処理するウェブ用の UI コンポーネントです。

上記のフォームが読み込まれたら、`fpxBank` Element の[インスタンスを作成](https://docs.stripe.com/js/elements_object/create_element?type=fpxBank)し、それを上記で作成した Element コンテナーにマウントします。

```javascript
const style = {
  base: {
    // Add your base input styles here. For example:
    padding: '10px 12px',
    color: '#32325d',
    fontSize: '16px',
  },
};

// Create an instance of the fpxBank Element.
const fpxBank = elements.create(
  'fpxBank',
  {
    style: style,
    accountHolderType: 'individual',
  }
);

// Add an instance of the fpxBank Element into the container with id `fpx-bank-element`.
fpxBank.mount('#fpx-bank-element');
```

## Stripe に支払いを送信する [クライアント側]

クライアント側で支払いを作成するには、ステップ 1 で作成した `PaymentIntent` オブジェクトの [client secret](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-client_secret) を渡します。

[stripe.confirmFpxPayment](https://docs.stripe.com/js.md#stripe-confirm-fpx-payment) を使用し、お客様のページからのリダイレクトを処理して支払いを完了します。この機能に `return_url` を追加して、ユーザーが銀行のウェブサイトまたはモバイルアプリで支払いを完了した後に Stripe がユーザーをリダイレクトする場所を示します。

```javascript
const form = document.getElementById('payment-form');

form.addEventListener('submit', async function(event) {
  event.preventDefault();
  const fpxButton = document.getElementById('fpx-button');
  const clientSecret = fpxButton.dataset.secret;

  const result = await stripe.confirmFpxPayment(clientSecret, {
    payment_method: {
      fpx: fpxBank,
    },
    // Return URL where the customer should be redirected after the authorization
    return_url: `${window.location.href}`,
  });

  if (result.error) {
    // Inform the customer that there was an error.
    const errorElement = document.getElementById('error-message');
    errorElement.textContent = result.error.message;
  }
});
```

顧客が支払いを送信すると、Stripe は顧客を `return_url` にリダイレクトし、以下の URL クエリーパラメーターを含めます。返品ページでは、これらを使用して PaymentIntent のステータスを取得し、顧客に支払いステータスを表示できます。

`return_url` を指定する際に、返品ページで使用する独自のクエリパラメーターを追加することもできます。

| パラメーター                         | 説明                                                                                                                                                                                                                                                                                                             |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payment_intent`               | `PaymentIntent` の一意の識別子。                                                                                                                                                                                                                                                                                       |
| `payment_intent_client_secret` | `PaymentIntent` オブジェクトの [client secret](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-client_secret)。サブスクリプションの実装の場合、この client_secret は [`confirmation_secret`](https://docs.stripe.com/api/invoices/object.md#invoice_object-confirmation_secret) を通じて `Invoice` オブジェクトでも公開されます |

顧客が自社のサイトにリダイレクトされたら、`payment_intent_client_secret` を使用して PaymentIntent をクエリし、顧客に取引ステータスを表示できます。

## 組み込みをテストする

#### 認証の成功と失敗のケース

FPX の組み込みをテストするには、テスト API キーを使用して任意の銀行を選択し、リダイレクトページを表示します。支払い成功のケースをテストするには、リダイレクトページで支払いを認証します。PaymentIntent が `requires_action` から `succeeded` に移行します。

ユーザが認証に失敗するケースをテストするには、テスト API キーを使用して任意の銀行を選択します。リダイレクトページで**テスト支払い失敗**をクリックします。PaymentIntent が、`requires_action` から `requires_payment_method` に移行します。

#### 確認エラーのケース

発生する可能性のあるその他のエラーケースには、オフライン状態の銀行への接続や、確認時の処理エラーなどがあります。これらのエラーを発生させるには、確認の `fpx[bank]` 値を以下のいずれかのテストエラー銀行値に設定します。PaymentIntent のステータスは `requires_confirmation` になります。これらの[エラーコードの詳細についてはこちら](https://docs.stripe.com/payments/fpx/accept-a-payment.md#error-codes)をご覧ください。

| パラメータ       | 値                       | エラーコード                                      |
| ----------- | ----------------------- | ------------------------------------------- |
| `fpx[bank]` | `test_offline_bank`     | `offline_bank`                              |
| `fpx[bank]` | `test_processing_error` | `payment_method_processing_error_transient` |

## 支払い後のイベントを処理する [サーバ側]

支払いが完了すると、Stripe は [payment_intent.succeeded](https://docs.stripe.com/api/events/types.md#event_types-payment_intent.succeeded) イベントを送信します。ダッシュボード、カスタム *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests)、またはパートナーソリューションを使用してこれらのイベントを受信し、また、顧客への注文確認メールの送信、データベースでの売上の記録、配送ワークフローの開始などのアクションを実行します。

クライアントからのコールバックを待つのではなく、これらのイベントをリッスンします。クライアント側では、コールバックが実行される前に顧客がブラウザーのウィンドウを閉じたり、アプリを終了したりする可能性があります。また、悪意を持つクライアントがレスポンスを不正操作する恐れもあります。非同期型のイベントをリッスンするよう構築済みのシステムを設定することで、これ以降はより多くの決済手段を簡単に受け付けられるようになります。[サポートされているすべての決済手段の違い](https://stripe.com/payments/payment-methods-guide)をご確認ください。

- **ダッシュボードでイベントを手動で処理する**

  ダッシュボードを使用して、テスト決済を[ダッシュボードで表示](https://dashboard.stripe.com/test/payments)したり、メール領収書を送信したり、入金を処理したり、失敗した決済を再試行したりできます。

- **Custom Webhook を構築する**

  [Build a custom webhook](https://docs.stripe.com/webhooks/handling-payment-events.md#build-your-own-webhook) handler to listen for events and build custom asynchronous payment flows. Test and debug your webhook integration locally with the Stripe CLI.

- **構築済みアプリを導入する**

  パートナーアプリケーションを統合することで、[自動化](https://stripe.partners/?f_category=automation)や[マーケティング/セールス](https://stripe.partners/?f_category=marketing-and-sales)などの一般的なビジネスイベントを処理します。

## Optional: FPX 銀行 Element イベントを処理する

`fpxBank` Element の設定オプション (`style` など) は、[.update(options)](https://docs.stripe.com/js.md#other-methods) を使用して更新できます。

FPX 銀行 Element は、顧客が選択した銀行が変更されたときにその銀行を出力します。銀行の値を使用して追加のロジック (たとえば、フォーム検証用のフィールドの要求など) を実行する場合は、変更イベントをリッスンできます。

```javascript
fpxBank.on('change', function(event) {
  var bank = event.value;
  // Perform any additional logic here...
});
```

変更イベントには、その他の有用なパラメータも含まれています。

| パラメータ         | 説明                                                                                                                                |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `elementType` | Element の名前。デフォルト値は `fpxBank`。                                                                                                    |
| `empty`       | `true` の場合、値は空です。                                                                                                                 |
| `complete`    | `true` の場合、顧客が値を選択済みです。このパラメータを使用して、フォームの残りの部分を段階的に示したり、フォームの送信を有効にしたりできます。                                                       |
| `value`       | 顧客が Element から選択した FPX 銀行。銀行の完全なリストは [FPX ガイド](https://docs.stripe.com/payments/fpx/accept-a-payment.md#bank-reference)に掲載されています。 |

## Optional: FPX リダイレクトを手動で処理する

`confirmFpxPayment` で FPX リダイレクトと支払いを処理するには、Stripe.js を利用することをお勧めします。ただし、次の方法で顧客を手動でリダイレクトすることもできます。

1. 顧客が支払いを完了した後にリダイレクトされる URL を指定します。

   ```curl
   curl https://api.stripe.com/v1/payment_intents/pi_1DRuHnHgsMRlo4MtwuIAUe6u/confirm \
     -u "<<YOUR_SECRET_KEY>>:" \
     -d payment_method=pm_1EnPf7AfTbPYpBIFLxIc8SD9 \
     --data-urlencode "return_url=https://shop.example.com/crtA6B28E1"
   ```

   この時点で、Stripe は選択された銀行がオンラインで認証可能な状態かどうかを確認します。その銀行が利用できない場合、Stripe は以下のエラーコードとエラーメッセージを返します。

|  |
|  |
| `error_code`    | offline_bank                     |
| `error_message` | %{bank} は現在オフラインです。別の銀行をお試しください。 |

   次に、取引を完了するために別の銀行か、支払い方法を選択するように顧客に勧める必要があります。

   **オフラインの銀行のテスト** 以下の値を使用してステップ 2 で *PaymentMethod* (PaymentMethods represent your customer's payment instruments, used with the Payment Intents or Setup Intents APIs) を作成してから、上記のようにそれを PaymentIntent に関連付けることで、前出の `offline_bank` エラーをテストできます。

| パラメータ       | 値                   |
| ----------- | ------------------- |
| `fpx[bank]` | `test_offline_bank` |

1. `PaymentIntent` のステータスが `requires_action` であることを確認します。`next_action` のタイプは `redirect_to_url` になります。

   ```json
   "next_action": {
     "type": "redirect_to_url",
     "redirect_to_url": {
       "url": "https://hooks.stripe.com/...",
       "return_url": "https://example.com/checkout/complete"
     }
   }
   ```

1. `next_action` プロパティで指定された URL に顧客をリダイレクトします。

   ```javascript
   const action = intent.next_action;
   if (action && action.type === 'redirect_to_url') {
     window.location = action.redirect_to_url.url;
   }
   ```

支払いプロセスを完了した顧客は、`return_url` の指定先に送られます。`payment_intent` と `payment_intent_client_secret` の URL クエリパラメーターが含まれ、上記のように独自のクエリパラメーターを渡すことができます。

## チェックアウトおよび支払い確認の要件

決済ページでは、以下の要件に従う必要があります。

| 要件                                | 詳細                                                                                                                |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| FPX のロゴを表示する。                     | [FPX ロゴ](https://exchange.fpx.prod.inet.paynet.my/files/FPX%20Logo.zip)をダウンロードします。                                |
| ドロップダウンリストに、FPX の買い手の銀行の選択肢を作成する。 | 銀行名は、[取引銀行](https://docs.stripe.com/payments/fpx/accept-a-payment.md#bank-reference)に記載されている名前と一致している必要があります。     |
| FPX 利用規約の標準的な表現と URL を提示する。       | **標準的な表現:** **進む**ボタンをクリックすると、FPX の[利用規約](https://www.mepsfpx.com.my/FPXMain/termsAndConditions.jsp)に同意することになります。 |

銀行の認証完了後に顧客が戻る支払い確認ページには、以下の情報を表示する必要があります。

| 情報        | 情報のソース                                                          |
| --------- | --------------------------------------------------------------- |
| 取引日時      | `Charge` オブジェクトの `created`。                                     |
| 金額        | `Charge` オブジェクトの `amount`。                                      |
| 売り手の注文番号  | `Charge` オブジェクトの `statement_descriptor`。                        |
| FPX 取引 ID | `Charge` オブジェクトの `payment_method_details[fpx][transaction_id]`。 |
| 買い手の銀行名   | `Charge` オブジェクトの `payment_method_details[fpx][bank]`。           |
| 取引ステータス   | `Charge` オブジェクトの `status`。                                      |

この情報には、[Charge (支払い)](https://docs.stripe.com/api/charges/object.md) からアクセスできます。Charge オブジェクトは、`payment_intent.succeeded` イベントから取得できます。

API バージョン [2022-08-01](https://docs.stripe.com/upgrades.md#2022-08-01) 以前を使用するユーザー: この情報には、[Charge (支払い)](https://docs.stripe.com/api/charges/object.md) からアクセスできます。Charge オブジェクトは、`payment_intent.succeeded` イベントから、または直接 [PaymentIntent (支払いインテント)](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-charges-data) から取得できます。

#### Ruby

```ruby

# Don't put any keys in code. See https://docs.stripe.com/keys-best-practices.
# Find your keys at https://dashboard.stripe.com/apikeys.
client = Stripe::StripeClient.new('<<YOUR_SECRET_KEY>>')

intent = client.v1.payment_intents.retrieve('{{PAYMENT_INTENT_ID}}')
charges = intent.charges.data
```

## 取引銀行

| 銀行名                | 値                  |
| ------------------ | ------------------ |
| Affin Bank         | affin_bank         |
| Alliance Bank      | alliance_bank      |
| AmBank             | ambank             |
| Bank Islam         | bank_islam         |
| Bank Muamalat      | bank_muamalat      |
| Bank Rakyat        | bank_rakyat        |
| BSN                | bsn                |
| CIMB Clicks        | cimb               |
| Hong Leong Bank    | hong_leong_bank    |
| HSBC Bank          | hsbc               |
| KFH                | kfh                |
| Maybank2E          | maybank2e          |
| Maybank2U          | maybank2u          |
| OCBC Bank          | ocbc               |
| Public Bank        | public_bank        |
| RHB Bank           | rhb                |
| Standard Chartered | standard_chartered |
| UOB Bank           | uob                |

## エラーコード

一般的なエラーコードと対応する推奨アクションは以下のとおりです。

| エラーコード                                      | 推奨アクション                                                                                                                                        |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `invalid_amount`                            | FPX 取引は、RM2 より大きく、RM30,000 未満である必要があります。                                                                                                       |
| `invalid_bank`                              | 指定された銀行は FPX でサポートされていません。上記の [Bank Reference](https://docs.stripe.com/payments/fpx/accept-a-payment.md#bank-reference) からいずれかのオプションを使用してください。 |
| `invalid_currency`                          | FPX は MYR 取引にのみ対応しています。                                                                                                                        |
| `missing_parameter`                         | 必要なパラメータがありません。必要なパラメータの詳細については、`error_message` を確認してください。                                                                                     |
| `offline_bank`                              | 指定した銀行は現在オフラインです。別の銀行または支払い方法のタイプをお試しください。                                                                                                     |
| `payment_method_not_available`              | この支払い方法は現在使用できません。戻って別の支払い方法で処理するように、顧客に依頼してください。                                                                                              |
| `payment_method_processing_error_transient` | 予期しないエラーが発生したため、Payment Intent を確定できませんでした。Payment Intent の確定をもう一度お試しください。                                                                     |

## 入金と送金

法令遵守上の理由から、FPX の資金は独立したアカウントの `fpx` 残高で決済されます。つまり、1 日に FPX の資金に対するものとその他すべての資金に対するものの 2 件の自動*入金* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit)を別々に受け取る可能性があります。[Connect プラットフォーム](https://docs.stripe.com/connect.md)では、`source_type` として `fpx` を指定することにより、次のように、`fpx` 残高から[入金を作成](https://docs.stripe.com/api/payouts/create.md)または[送金](https://docs.stripe.com/api/transfers/create.md)することができます。

```curl
curl https://api.stripe.com/v1/payouts \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=5000 \
  -d currency=myr \
  -d source_type=fpx
```

また、残高を[取得](https://docs.stripe.com/api/balance/balance_retrieve.md)して、`available` および `pending` の Stripe 残高の内訳を `source_type` ごとに確認することもできます。


FPX は、マレーシアで利用可能な [1 回限り](https://docs.stripe.com/payments/payment-methods.md#usage)の決済手段です。FPX を使用して支払う場合、顧客はアプリからリダイレクトされ、お客様に支払いを送信し、その後アプリに戻ります。お客様は、支払いが成功したか失敗したかに関する[即時通知](https://docs.stripe.com/payments/payment-methods.md#payment-notification)を受け取ります。

FPX 決済を有効にするには、以下の手順に従います。

1. Go to the [Payment methods settings](https://dashboard.stripe.com/settings/payment_methods) in the Dashboard. If you haven’t already, [set up your Stripe account](https://docs.stripe.com/get-started/account/set-up.md).
1. **銀行へのリダイレクト**で FPX を探し、**有効にする**を選択します。
1. FPX の利用規約に同意します。

FPX を利用できるのは、マレーシアに拠点を置く事業者のみです。Stripe プロダクトと互換性のある国、通貨、決済手段について詳しくは[決済手段サポート](https://docs.stripe.com/payments/payment-methods/payment-method-support.md)をご覧ください。

FPX 決済を有効にしたら [Mobile Payment Element](https://docs.stripe.com/payments/accept-a-payment.md?payment-ui=mobile&platform=android) を組み込み、オンライン決済の受け付けを開始します。Android、iOS、React Native から選択できます。