Aktualisieren Sie Ihre onramp-IntegrationÖffentliche Vorschau

Erfahren Sie mehr über die API-Änderungen beim Upgrade Ihrer Onramp-Beta-Integration.

Vorsicht

Befolgen Sie diese Anleitung, wenn Sie die Onramp API vor dem 2023-06-21 integriert haben.

Wir haben im Rahmen unserer Veröffentlichung Änderungen an der Stripe fiat-to-crypto onramp API vorgenommen. Wenn Sie vor dem 2023-06-21 eine Integration mit Onramp vorgenommen haben, verfügen Sie über eine Integration mit der Beta der Onramp API.

Dieser Leitfaden behandelt die vorgenommenen Änderungen, die Auswirkungen auf bestehende Integrationen und Anweisungen für die Migration auf diese neueste Version.

Änderungen gegenüber der Onramp-Beta

transaction_details in den übergeordneten POST /v1/crypto/onramp_sessions-Anfragetext integriert
Die folgenden Felder in Onramp-API-Anfragen und -Ressourcen wurden umbenannt
- supported_destination_currencies ist jetzt destination_currencies
- supported_destination_networks ist jetzt destination_networks
- source_exchange_amount ist jetzt source_amount
- destination_exchange_amount ist jetzt destination_amount
Der Onramp-Angebotspfad wurde von /v1/crypto/onramp/quotes in /v1/crypto/onramp_quotes geändert

Es folgen Beispiele dafür, wie die Änderungen in der Onramp-Anfrage und den Antworten aussehen:

Ein Onramp-Angebot abrufen

Führen Sie einen Befehl ähnlich dem folgenden aus, um ein Onramp-Angebot abzurufen:

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp_quotes \
curl -G https://api.stripe.com/v1/crypto/onramp/quotes \
  -usk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -H "Stripe-Version: 2025-04-30.basil;crypto_onramp_beta=v2" \
  -d "source_amount"="200" \
  -d "source_exchange_amount"="200" \

Sie erhalten eine Antwort ähnlich der folgenden:

{
  "id": "2e5818944df6a2325c7e9c1e72d27174b9bedfc8e64ace47c081370a5b982a7b",
  "rate_fetched_at": 1674265506.3408287,
  "destination_network_quotes": {
    "ethereum": [
      {
        "id": "d160a80828eabb6b6d4aeafac585eee62d95425c7fb7577866ab04b9a786df00",
        "destination_currency": "eth",
        "destination_amount": "0.253568242640499553",
        "destination_exchange_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_exchange_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",
  "source_exchange_amount": "200.00"
}

Eine Onramp-Sitzung erstellen

Führen Sie zum Erstellen einer Onramp-Sitzung einen Befehl ähnlich dem folgenden aus:

Command Line
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \
  -usk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -H "Stripe-Version: 2025-04-30.basil;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" \
  -d "transaction_details[wallet_addresses][ethereum]"="0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2" \
  -d "transaction_details[source_currency]"="usd" \
  -d "transaction_details[destination_exchange_amount]"="10" \
  -d "transaction_details[destination_currency]"="eth" \
  -d "transaction_details[destination_network]"="ethereum" \
  -d "transaction_details[supported_destination_currencies][]"="eth" \
  -d "transaction_details[supported_destination_networks][]"="ethereum"

Sie erhalten eine Antwort ähnlich der folgenden:

{
  "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"
    ],
    "source_exchange_amount": null,
    "destination_exchange_amount": "0.100000000000000000",
    "supported_destination_currencies": [
      "eth"
    ],
    "supported_destination_networks": [
      "ethereum"
    ],
    "transaction_id": null,
    "wallet_address": null,
    "wallet_addresses": {
      "bitcoin": null,
      "ethereum": "0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2",
      "polygon": null,
      "solana": null,
      "stellar": null,
      "destination_tags": null
    }
  }
}

Auswirkungen auf bestehende Integrationen

Wir haben diese Änderungen auf eine Weise veröffentlicht, die bestehende Beta-Integrationen nicht beeinträchtigt. Wenn Sie Probleme mit Ihrer Integration haben, wenden Sie sich bitte an den Stripe-Support.

Umstellung von der Beta- auf die aktuelle Onramp-Version

Häufiger Fehler

Befolgen Sie diesen Abschnitt nur, wenn:

Stripe hat Ihren Onramp-Onboarding-Antrag wurde vor dem 2023-06-21 genehmigt.
Sie haben vor dem 2023-06-21 eine Integration mit Onramp vorgenommen.

Andernfalls gelten diese Anweisungen nicht für Sie, da Sie bereits die neueste Version von Onramp nutzen.

Versionskompatibilität

Öffentliche Vorschau

Wenn Sie Ihre API-Version aktualisieren möchten, geben Sie in Ihren Anfragen crypto_onramp_beta=v2 als Teil des Stripe-Version-Headers an.

Beta-Integrationen können jetzt eine crypto_onramp_beta-Version als Teil des Stripe-Version-Headers übergeben, um entweder die Beta- oder die neueste Onramp-API-Version zu nutzen. Verwenden Sie die folgende Matrix, um das zu erwartende Verhalten basierend auf dem übergebenen Stripe-Version-Header zu bestimmen.

Version	Kopfzeile	Erwartetes API-Verhalten
nicht näher bezeichnet	`Stripe-Version: 2025-04-30.basil`	beta
`v1`	`Stripe-Version: 2025-04-30.basil;crypto_onramp_beta=v1`	beta
`v2`	`Stripe-Version: 2025-04-30.basil;crypto_onramp_beta=v2`	neueste

Wenn Sie Ihre API-Version aktualisieren möchten, geben Sie in Ihren Anfragen crypto_onramp_beta=v2 als Teil des Stripe-Version-Headers an.