# カスタムの決済アプリケーション

Stripe Connector for NetSuite を使用して支払いを記録および適用する方法をカスタマイズする場合の方法をご紹介します。

Stripe Connector for NetSuite の詳細を確認し、デモを入手するには、[Stripe App Marketplace](https://marketplace.stripe.com/apps/netsuite-connector) に移動して、**Install app (アプリをインストール)** をクリックします。

Stripe Connector for NetSuite は、Stripe の支払いアクティビティーをカスタムまたは事前に構築されたサードパーティーの連携から NetSuite に照合する方法を提供します。以下のツールを使用して、コネクターが NetSuite で支払いを記録および照合する方法をカスタマイズできます。

- [Stripe メタデータ](https://docs.stripe.com/use-stripe-apps/netsuite/custom-payment-application.md#stripe-metadata)
- [決済の請求書](https://docs.stripe.com/use-stripe-apps/netsuite/custom-payment-application.md#invoices-payments)
- [コネクターアドオン](https://docs.stripe.com/use-stripe-apps/netsuite/custom-payment-application.md#connector-addons)

## Stripe メタデータ

Stripe メタデータを使用して、Stripe アクティビティーが NetSuite で正しく表示されているか確認できます。

### Stripe オブジェクトを NetSuite レコードに関連付ける

Stripe オブジェクトにメタデータを追加して、既存の NetSuite レコードに関連付けます。このメタデータの追加は、同期時、または Stripe オブジェクトが NetSuite に同期する前、あるいは同期タイミングを変更する制御と組み合わせて行うことができます。

以下の方法でレコードを関連付けることができます。

- Stripe の支払いに `netsuite_invoice_id: 12345` を追加して、コネクターが内部 ID `12345` の NetSuite 請求書に顧客の支払いを適用できるようにします。
- Stripe の返金に `netsuite_credit_memo_id: 67890` を追加して、コネクターが内部 ID `67890` の NetSuite クレジットメモに顧客の返金を適用できるようにします。
- Stripe の支払いに `netsuite_customer_id: 101010` を追加して、コネクターが内部 ID `101010` の NetSuite 顧客で顧客の支払いを作成できるようにします。

### 同期タイミングを上書きする

レコードが NetSuite に同期されるタイミングをプログラムで管理することにより、デフォルトの同期タイミングを上書きすることができます。レコードの同期タイミングを上書きするには、拒否リストにレコードを追加するか、許可リストにレコードを追加するかの 2 つの方法があります。

#### 拒否リストにレコードを追加する

メタデータを追加すると、コネクターによる NetSuite へのレコードの同期が一時的に停止されます。これは、Stripe とのバックエンド連携で NetSuite と同期する前にレコードにデータを追加する必要がある場合に役立ちます。

拒否リストを使用して、NetSuite への顧客の同期のタイミングを管理します。

1. 実装パートナーに、Stripe アプリ設定で**支払いと返金の拒否リスト**の機能を有効にするよう依頼します。会計および技術的な影響のすべてを理解するには、実装パートナーにご相談ください。
1. 任意の Stripe オブジェクトのメタデータに `netsuite_block_integration: true` を追加します。
1. レコードの同期を再度許可するには、`true` を `nil` に置き換えます。

支払いまたは支払い関連のレコードを拒否リストに永久に追加することはできません。2 日後に、コネクターは Stripe 入金用に銀行入金の作成を自動的に試みます。支払いまたはレコードを拒否リストから削除するまで、入金の自動化は失敗し、支払いまたはレコードを NetSuite と同期できません。

#### サンプル

拒否リストの使用が必要になる状況の例を次に示します。

**例 1**: Stripe の顧客が登録プロセスを開始して前払いを行ったときに、システムによって作成された顧客レコードがあるとします。後でその顧客の住所データを収集します。通常、コネクターは顧客と支払いデータを NetSuite に即時に同期します。ただし、顧客のすべてのデータの収集を終了するまで、NetSuite への同期を遅延させることができます。

**例 2**: Stripe アカウントには Stripe Billing と E コマースアプリが含まれます。E コマースアプリからの支払いを NetSuite の注文に関連付け、サブスクリプションの請求書と支払いを自動的に同期したいとします。これを行うには、E コマースシステムからの支払いにメタデータを追加します。コネクターは、Stripe Billing の請求書と支払いを NetSuite に同期します。 Netsuite の注文または請求書 ID のない E コマース支払いは、関連付けられた注文または請求書が NetSuite アカウントにインポートされるまで同期されません。注文の詳細が追加されたら、拒否リストのメタデータを削除し、NetSuite の請求書 ID を追加してレコードに関連付けることができます。

#### 許可リストにレコードを追加する

メタデータを追加して、権限が付与されるまでコネクターによる NetSuite へのレコードの同期を停止できます。これは、Stripe を使用して請求書が NetSuite で作成される前に決済を処理する EC システムを使用している場合に役立ちます。

許可リストを使用して、NetSuite へのレコードの同期を以下の方法で管理します。

1. 実装パートナーに、Stripe アプリ設定で**許可リストの支払い**機能を有効にするよう依頼します。会計および技術的な影響のすべてを理解するには、実装パートナーにご相談ください。
1. `netsuite_allow_integration: true` をレコードのメタデータに追加します。

以下のいずれかが該当する場合は、許可リストを使用しないでください。

- Stripe Billing を利用している場合。ほとんどの場合、Stripe は請求書を自動的に生成するため、請求書が許可リストに追加されていることを確認することが困難です。Stripe Billing に関連しない支払いには拒否リストを使用できます。
- Stripe アカウントのすべての支払いを考慮した、カスタムの総合的なシステムを使用していない場合。 Stripe アカウントの支払いが NetSuite に同期されていない場合、支払いが同期されるまで、入金の自動化は失敗します。

#### NetSuite レコードの作成を上書きする

コネクターのレコードの同期プロセスを部分的に上書きするには、Stripe オブジェクトにメタデータを追加して、既存の NetSuite レコードに関連付けます。このメタデータの追加は、同期時、または Stripe オブジェクトが NetSuite に同期する前、あるいは同期タイミングを変更する制御と組み合わせて行うことができます。これにより、コネクターは NetSuite でそのレコードを作成できなくなります。

たとえば、顧客を作成する既存のシステムがあり、これをコネクターと併用したいとします。NetSuite の顧客の内部 ID を Stripe の顧客に渡すと、コネクターが新しい顧客を作成するのではなく、2 つの間にリンクを作成できるようになります。同じプロセスを使用して、Stripe 価格を既存の NetSuite アイテムに関連付けることもできます。

レコードを関連付けてレコードの作成を上書きするための[メタデータキー](https://docs.stripe.com/use-stripe-apps/netsuite/custom-payment-application.md#metadata-keys)のリストについては、以下をご覧ください。

[プライスマッチ設定](https://docs.stripe.com/use-stripe-apps/netsuite/stripe-prices-coupons-netsuite.md#how-netsuite-represents-products-and-prices)を使用すると、Price オブジェクトに `netsuite_service_sale_item_id` メタデータキーを追加する方法が上書きされます。

> 売掛金に影響するコネクターのレコードの同期プロセスを部分的に上書きすると、会計が不正確になる場合があります。Stripe のシステムでは作成されたレコードの正確性を保証しますが、別のシステムで作成されたレコードの正確性は保証できません。

### コネクターのメタデータキー

コネクターは、メタデータキーを使用して、Stripe オブジェクトを既存の NetSuite レコードに関連付けます。このメタデータの追加は、同期時、または Stripe オブジェクトが NetSuite に同期する前、あるいは同期タイミングを変更する制御と組み合わせて行うことができます。

| Stripe レコード       | Stripe メタデータキー                          | NetSuite レコード                                                       |
| ----------------- | --------------------------------------- | ------------------------------------------------------------------- |
| 顧客                | `netsuite_customer_id`                  | 顧客                                                                  |
| Invoice (請求書)     | `netsuite_invoice_id`                   | Invoice (請求書)                                                       |
| Price (価格)        | `netsuite_service_sale_item_id`         | サービス販売アイテム

  指定されない場合、これはコネクターが新しいアイテムを作成するために使用するデフォルトのアイテムタイプです。 |
| Price (価格)        | `netsuite_service_resale_item_id`       | サービスの再販アイテム

  サービス販売アイテムの代わりにこのアイテムタイプを使用できます。                     |
| Price (価格)        | `netsuite_non_inventory_sale_item_id`   | 非在庫販売アイテム

  サービス販売アイテムの代わりにこのアイテムタイプを使用できます。                       |
| Price (価格)        | `netsuite_non_inventory_resale_item_id` | 在庫以外の再販アイテム

  サービス販売アイテムの代わりにこのアイテムタイプを使用できます。                     |
| Price (価格)        | `netsuite_discount_item_id`             | 割引アイテム

  ラインアイテムの金額がマイナスの場合にのみ適用されます。                              |
| 請求書のラインアイテム       | `netsuite_discount_item_id`             | 割引アイテム

  ラインアイテムの金額がマイナスの場合にのみ適用されます。                              |
| クーポン              | `netsuite_discount_item_id`             | 割引アイテム                                                              |
| 支払い               | `netsuite_customer_payment_id`          | 顧客の支払い                                                              |
| 支払い               | `netsuite_customer_deposit_id`          | 顧客の入金                                                               |
| 返金                | `netsuite_customer_refund_id`           | 顧客への返金                                                              |
| 返金                | `netsuite_credit_memo_id`               | クレジットメモ

  返金の支払いが Stripe が作成した請求書に関連付けられている場合にのみ適用されます。            |
| 不審請求の申請 (チャージバック) | `netsuite_customer_refund_id`           | 顧客への返金                                                              |
| 入金                | `netsuite_deposit_id`                   | 頭金                                                                  |

## 支払いの請求書

システムが決済処理に Stripe を使用していて、請求書に関連付けられていない決済を Stripe で作成する場合は、コネクターが決済の情報を使用して請求書を作成可能にすることを選択できます。次に、コネクターは、その取引の収益と現金を表すために顧客の決済を適用します。

このワークフローは、割引や複数のラインアイテム、その他の複雑なシステムには対応していません。

### 仕組みについて

1. コネクターは、Stripe での支払いごとに NetSuite の請求書を作成し、請求書のメモに支払いの説明を含めます。フィールドマッピングを使用して、Stripe メタデータフィールドのデータを請求書に追加することができます。
1. 請求書では、1 つのラインアイテムを使用して、 Stripe の支払い全体で得られた売上を表します。デフォルトでは、Stripe アカウントのすべての支払いで同じ NetSuite アイテムが使用されます。これはカスタマイズできます。
1. コネクターは支払いを作成して、それを請求書に適用します。支払いは銀行入金に対して自動的に照合され、手数料が記録されます。
1. 返金と不審請求の申請は、自動的にクレジットメモと返金として表されます。

### NetSuite ラインアイテムをカスタマイズする

支払いから生成されたすべての請求書は、同じ NetSuite アイテム (Stripe の一般的なラインアイテム) をデフォルトで使用します。支払いが自社のアプリで複数のタイプの商品購入に使用される場合、一意の NetSuite アイテムに対してさまざまな商品の売上を記録する必要があります。これにより、アイテム別の売上や販売アイテムの数量などに基づいて、NetSuite で詳細なレポートを作成できます。

支払い情報を使用して請求書を作成する場合、1 つの請求書に複数のラインアイテムを含めることはできません。コネクターは、Stripe の支払いに関するメタデータ情報を使用して複数のアイテムに売上を分配することはできません。NetSuite の請求書で複数のラインアイテムを使用する必要がある場合は、Stripe の請求書を使用してラインアイテムの詳細を同期できます。

Stripe の支払いのメタデータまたは標準フィールドを使用して、NetSuite アイテムを選択できます。コネクターは、Stripe メタデータまたはフィールドを使用して NetSuite アイテムのフィールドを検索します。一致が見つからない場合、コネクターは Stripe の一般的なラインアイテムを使用します。一致では大文字と小文字が区別されません。

たとえば、Stripe の支払いを作成して、NetSuite アイテムの名前が含まれた `product_name` メタデータを追加するとします。コネクターは、Stripe の `product_name` に一致するアイテムを NetSuite で検索します。一致を見つけた場合、その支払い用に作成された請求書のそのアイテムを使用します。

決済フローに請求書を使用するには、以下を行います。

1. 実装パートナーに、Stripe アプリ設定で**支払いの請求書を作成する**機能を有効にするよう依頼します。会計および技術的な影響のすべてを理解するには、実装パートナーにご相談ください。
1. コネクターが照合に使用できるように、以下を追加します。
   - アイテムレコードに NetSuite フィールドを追加する
   - 対応する Stripeフィールド を `Charge` オブジェクトに追加する

たとえば、Stripe の支払いにメタデータキーを追加して、NetSuite アイテムに `itemid` または `displayName` を追加できます。

## コネクターのアドオン

コネクターの詳細や、コネクターのアドオンのご使用開始については、[お問い合わせください](http://stripe.com/sales) 。

コネクターは、一般的なユースケースに対応し、コアワークフローでのシームレスな運用を可能にする NetSuite アドオン (バンドル) を提供します。公式の実装パートナーと連携して、NetSuite 専用のアドオンを使用してシステムをカスタマイズできます。

アドオンを基盤に新しいワークフローを開発したり、ビジネスニーズに合わせて既存のワークフローを変更したりすることで、アドオンをカスタマイズできます。たとえば、主要なコネクターの自動化を使用しながら、支払いと照合のプロセスを貴社独自の NetSuite 設定に合わせることができます。

### Autopay アドオン

Autopay アドオンを使用すると、顧客の保存済みの支払い方法に自動的に請求し、NetSuite で未払いの請求書を支払うことができます。請求書が正しく請求されるように、サイクルやパラメーターなどの請求の詳細を変更することができます。

### NetSuite Initiated Refunds アドオン

NetSuite Initiated Refunds アドオンを使用して、Stripe ダッシュボードや API ではなく、NetSuite から [Stripe 返金](https://docs.stripe.com/use-stripe-apps/netsuite/stripe-refunds-netsuite.md)をトリガーします。NetSuite レコードは、複数のシナリオで Stripe 返金を全面的に表すために自動的にリンクまたは作成されます。

### Payment Linker アドオン

Stripe を E-コマースサイトなどのサードパーティーサービスと連携させる場合、Payment Linker アドオンを使用して、NetSuite の販売注文に適用された顧客の預金、または NetSuite の請求書に適用される支払いとして Stripe での支払いを自動的に同期できます。Stripe は、総額前払いキャプチャーまたはオーソリキャプチャーのフローをサポートします。

## See also

- [フィールドとリファレンス](https://docs.stripe.com/use-stripe-apps/netsuite/fields-references.md)
- [フィールドマッピング](https://docs.stripe.com/use-stripe-apps/netsuite/field-mappings.md)
- [データの同期](https://docs.stripe.com/use-stripe-apps/netsuite/sync-data.md)