# オンランプのシステムをアップグレードする

オンランプのベータのシステムをアップグレードする際の API の変更をご紹介します。

> 2023-06-21 より前にオンランプ API を導入した場合は、このガイドに従ってください。

公開リリースの一部として Stripe 法定通貨から暗号資産へのオンランプ API を変更しました。2023-06-21 より前にオンランプを導入している場合は、ベータのオンランプ API が使用されています。

このガイドでは、変更内容、構築済みのシステムに対する影響、この最新バージョンへの移行の手順について説明します。

## オンランプベータからの変更

- 上位の `POST /v1/crypto/onramp_sessions` リクエスト本文に `transaction_details` をフラット化しました
- オンランプの API リクエストとレスポンスの以下のフィールドの名前が変更されました
  - `supported_destination_currencies` は `destination_currencies` になりました
  - `supported_destination_networks` は `destination_networks` になりました
  - `source_exchange_amount` は `source_amount` になりました
  - `destination_exchange_amount` は `destination_amount` になりました
- オンランプの見積もりのパスを `/v1/crypto/onramp/quotes` から `/v1/crypto/onramp_quotes` に変更しました

オンランプのリクエストとレスポンスでの変更の例は以下のとおりです。

### オンランプの見積もりを取得する

オンランプの見積もりを取得するには、次のようなコマンドを実行します。

```bash
curl -G https://api.stripe.com/v1/crypto/onramp_quotes \
  -u <<YOUR_SECRET_KEY>>: \-H "Stripe-Version:2026-02-25.clover;crypto_onramp_beta=v2" \
  -d "source_amount"="200" \
```

次のようなレスポンスを受信します。

```json
{
  "id": "2e5818944df6a2325c7e9c1e72d27174b9bedfc8e64ace47c081370a5b982a7b",
  "rate_fetched_at": 1674265506.3408287,
  "destination_network_quotes": {
    "ethereum": [
      {
        "id": "d160a80828eabb6b6d4aeafac585eee62d95425c7fb7577866ab04b9a786df00",
        "destination_currency": "eth","destination_amount": "0.253568242640499553",
        "destination_network": "ethereum",
        "fees": {
          "network_fee_monetary": "1.45",
          "transaction_fee_monetary": "12.71"
        },
        "source_total_amount": "214.20"
      },
      {
        "id": "53f864cb28a42f11e1d9d5aff7e43ac96b056406f74cbf618399c6fa40f3d275",
        "destination_currency": "usdc","destination_amount": "200.00",
        "destination_network": "ethereum",
        "fees": {
          "network_fee_monetary": "5.80",
          "transaction_fee_monetary": "12.76"
        },
        "source_total_amount": "218.56"
      }
    ],
    ...
  },
  "livemode": true,
  "source_currency": "usd","source_amount": "200.00",
}
```

### オンランプセッションを作成する

オンランプセッションを作成するには、次のようなコマンドを実行します。

```bash
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -u <<YOUR_SECRET_KEY>>: \-H "Stripe-Version:2026-02-25.clover;crypto_onramp_beta=v2" \
  -d "wallet_addresses[ethereum]"="0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2" \
  -d "source_currency"="usd" \
  -d "destination_amount"="0.1" \
  -d "destination_currency"="eth" \
  -d "destination_network"="ethereum" \
  -d "destination_currencies[]"="eth" \
  -d "destination_networks[]"="ethereum" \
```

次のようなレスポンスを受信します。

```json
{
  "id": "cos_0MYvv9589O8KAxCGPm84FhVR",
  "object": "crypto.onramp_session",
  "client_secret": "cos_0MYvv9589O8KAxCGPm84FhVR_secret_IGBYKVlTlnJL8UGxji48pKxBO00deNcBuVc",
  "created": 1675794575,
  "livemode": false,
  "status": "initialized",
  "transaction_details": {
    "destination_currency": "eth",
    "destination_network": "ethereum",
    "fees": null,
    "lock_wallet_address": false,
    "source_currency": "usd","source_amount": null,
    "destination_amount": "0.100000000000000000",
    "destination_currencies": [
      "eth"
    ],
    "destination_networks": [
      "ethereum"
    ],
    "transaction_id": null,
    "wallet_address": null,
    "wallet_addresses": {
      "bitcoin": null,
      "ethereum": "0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2",
      "polygon": null,
      "solana": null,
      "stellar": null,
      "destination_tags": null
    }
  }
}
```

## 既存のシステムに対する影響

これらの変更は、既存のベータ版で構築されたシステムに影響しない方法でリリースされています。システムで問題が発生した場合は、[Stripe サポート](https://support.stripe.com)のフォームからお問い合わせください。

## ベータから最新のオンランプバージョンに移行する

> 以下の場合にのみ、このセクションに従ってください。
> 
> - Stripe は、オンランプの登録の申し込みを 2023-06-21 より前に承認しました。
- 2023-06-21 より前にオンランプを導入しました。
> 
> それ以外の場合、すでに最新のオンランプバージョンが使用されているため、ここに記載されている手順は不要です。

### バージョンの互換性

> API バージョンをアップグレードする場合、最初に、リクエストの `Stripe-Version` ヘッダーの一部として `crypto_onramp_beta=v2` を指定します。

ベータの導入では、`Stripe-Version` ヘッダーの一部として `crypto_onramp_beta` バージョンを渡すことで、ベータまたは最新のオンランプ API バージョンを利用できるようになりました。渡される `Stripe-Version` ヘッダーに基づいて想定される動作を判断するには、次のマトリックスを使用してください。

| バージョン | ヘッダー                                                      | 想定される API の動作 |
| ----- | --------------------------------------------------------- | ------------- |
| 未指定   | `Stripe-Version: 2026-02-25.clover`                       | ベータ           |
| `v1`  | `Stripe-Version: 2026-02-25.clover;crypto_onramp_beta=v1` | ベータ           |
| `v2`  | `Stripe-Version: 2026-02-25.clover;crypto_onramp_beta=v2` | 最新            |

API バージョンをアップグレードする場合、最初に、リクエストの `Stripe-Version` ヘッダーの一部として `crypto_onramp_beta=v2` を指定します。