# PayPal の入金の照合

ヨーロッパで一般的な支払い方法である PayPal で行われた支払いを照合する方法をご紹介します。

照合は、対応する PayPal の注文で受け取って処理した決済を突き合わせて確認するプロセスです。このプロセスは、売上を Stripe ではなく PayPal で受け取る利用者のみに適用されます。Stripe は入金前に PayPal の取引を自動的に[照合](https://docs.stripe.com/reports/payout-reconciliation.md)しますが、取引が Stripe のプラットフォーム以外で*売上として処理* (When funds are available in your Stripe balance)された場合は自動照合できません。Stripe のプラットフォーム以外で取引の売上として処理する場合は、PayPal アカウントで利用可能な PayPal のレポートか、sFTP を使用して照合してください。

PayPal の取引の照合には、次の 2 つの方法を使用できます。

- (推奨) [reference](https://docs.stripe.com/payments/paypal/payout-reconciliation.md#use-reference) フィールドを使用する。これは、自社で生成した注文 ID や請求書 ID がある場合に推奨される方法です。これらの ID は参照フィールドに入れることができます。支払いが行われて処理されると、PayPal 決済レポートで `Invoice ID` として `my_order_id` が表示されます。
- [Charge](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-paypal-transaction_id) オブジェクトの [transaction_id](https://docs.stripe.com/payments/paypal/payout-reconciliation.md#use-transaction-id) を使用します。支払いが処理されると、PayPal の売上処理レポートに `paypal_capture_id` が `Transaction ID` として表示されます。ビジネスで生成された注文 ID がない場合にのみ、この方法をお勧めします。

## 参照を使用する

[reference](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-payment_method_options-paypal-reference) フィールドを使用して、PayPal での支払いの注文に自社の参照を入力します。この一例として PayPal からの注文 ID を使用できます。この参照は、買い手とお客様の PayPal アカウントの [Settlement Report (売上処理レポート)](https://developer.paypal.com/docs/reports/sftp-reports/settlement-report/) に表示されます。`reference` を使用して売上を照合するには、PaymentIntent の作成時にこれを [payment_method_options](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-payment_method_options-paypal) パラメーターの一部として含めます。この `reference` を使用して、[PayPal 売上処理レポート](https://developer.paypal.com/docs/reports/sftp-reports/settlement-report/)で、Stripe で行われた支払いと対応する取引を突き合わせることができます。返金や不審請求の申請など、元の支払い取引に起因する後続の取引もすべて、指定された `reference` に関連付けられます。

次のコードサンプルは、`payment_method_options` 内に `reference` が設定された PaymentIntent の作成方法を示しています。

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]=paypal" \
  -d "payment_method_options[paypal][reference]=my_order_id"
```

支払いが行われて処理されると、[PayPal Settlement Report (PayPal 売上処理レポート)](https://developer.paypal.com/docs/reports/sftp-reports/settlement-report/) では `my_order_id` が請求書 ID として使用されます。

## Charge オブジェクトの取引 ID を使用する

[transaction_id](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-paypal-transaction_id) フィールドには PayPal が取引の識別に使用する ID が格納されます。`transaction_id` を使用して売上を照合するには、Charge オブジェクトの [payment_method_details](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-paypal) フィールドから `transaction_id` を取得します。`transaction_id` は、支払いがキャプチャーされた場合にのみ表示され、Stripe で行われた支払いと、[PayPal Settlement Report (PayPal 売上処理レポート)](https://developer.paypal.com/docs/reports/sftp-reports/settlement-report/) の対応する取引の照合に使用されます。

たとえば、次の方法で Charge オブジェクトから `transaction_id` を取得します。

#### Json

```json
{
  "amount": 1099,
  "amount_captured": 1099,"payment_method_details": {
    "paypal": {
      "transaction_id": "paypal_capture_id",
      "payer_id": "ZA889USQQDD37",
      "payer_email": "jenny@example.com",
      "payer_name": "Jenny Rosen"
    },
    "type": "paypal"
  },
  "balance_transaction": "txn_3MrOPxGsnWT9WMaQ19vg30v3",
  "billing_details": {
    "address": {
      "city": "Co. Kerry",
      "country": "IE",
      "line1": "Skellig Michael",
      "line2": "Great Skellig",
      "postal_code": "12345",
      "state": "Munster"
    },
    "email": "jenny@example.com",
    "name": null,
    "phone": null
  },
  "calculated_statement_descriptor": null,
  "captured": true,
  "created": 1680194094,
  "currency": "eur",
  "fraud_details": {},
  "id": "py_3MrOPxGsnWT9WMaQ1gwt6RSD",
  "invoice": null,
  "livemode": true,
  "metadata": {},
  "object": "charge",
  "on_behalf_of": null,
  "order": null,
  "outcome": {
      "network_status": "approved_by_network",
      "reason": null,
      "risk_level": "not_assessed",
      "seller_message": "Payment complete.",
      "type": "authorized"
  },
  "paid": true,
  "payment_intent": "pi_3MrOPxGsnWT9WMaQ1IrNlTiZ",
  "payment_method": "pm_1MrOPxGsnWT9WMaQ3XBSs7eY",
  "receipt_email": null,
  "receipt_number": null,
  "refunded": false
}
```

支払いが処理されると、[PayPal の売上処理レポート](https://developer.paypal.com/docs/reports/sftp-reports/settlement-report/) で `Transaction ID` として `paypal_capture_id` が表示されます。

## PayPal のレポートにアクセスする

PayPal の売上処理レポートや他のレポートは paypal.com からダウンロードできます。または PayPal に問い合わせて sFTP のレポート機能を有効にすることもできます。

売上処理レポートは、残高に影響する 24 時間以内に発生したすべての取引を包括的に把握できるレポートです。PayPal アカウントの資金移動イベントと、関連付けられた銀行口座に送金された資金を照合するために使用します。

売上処理へのアクセス方法:

1. PayPal ビジネスアカウントに[ログイン](https://www.paypal.com/signin)します。
1. **アクティビティー**で、**すべてのレポート**を選択します。
1. **取引 > 売上処理**を選択します。

詳細は [PayPal のレポートとダウンロード方法](https://www.paypal.com/us/cshelp/article/how-do-i-view-and-download-statements-and-reports-help145)をご覧ください。