Aktualisieren Sie Ihre onramp-IntegrationBeta
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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
transaction_
in den übergeordnetendetails POST /v1/crypto/onramp_
-Anfragetext integriertsessions - Die folgenden Felder in Onramp-API-Anfragen und -Ressourcen wurden umbenannt
supported_
ist jetztdestination_ currencies destination_
currencies supported_
ist jetztdestination_ networks destination_
networks source_
ist jetztexchange_ amount source_
amount destination_
ist jetztexchange_ amount destination_
amount
- Der Onramp-Angebotspfad wurde von
/v1/crypto/onramp/quotes
in/v1/crypto/onramp_
geändertquotes
Es folgen Beispiele dafür, wie die Änderungen in der Onramp-Anfrage und den Antworten aussehen:
Ein Onramp-Angebot abrufen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Führen Sie einen Befehl ähnlich dem folgenden aus, um ein Onramp-Angebot abzurufen:
curl -G https://api.stripe.com/v1/crypto/onramp_quotes \ curl -G https://api.stripe.com/v1/crypto/onramp/quotes \ -u
: \ -H "Stripe-Version: 2024-06-20;crypto_onramp_beta=v2" \ -d "source_amount"="200" \ -d "source_exchange_amount"="200" \sk_test_4eC39HqLyjWDarjtT1zdp7dc
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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Führen Sie zum Erstellen einer Onramp-Sitzung einen Befehl ähnlich dem folgenden aus:
curl -X POST https://api.stripe.com/v1/crypto/onramp_sessions \ -u
: \ -H "Stripe-Version: 2024-06-20;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"sk_test_4eC39HqLyjWDarjtT1zdp7dc
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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Beta
Wenn Sie Ihre API-Version aktualisieren möchten, geben Sie in Ihren Anfragen crypto_
als Teil des Stripe-Version
-Headers an.
Beta-Integrationen können jetzt eine crypto_
-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: 2024-06-20 | beta |
v1 | Stripe-Version: 2024-06-20;crypto_ | beta |
v2 | Stripe-Version: 2024-06-20;crypto_ | neueste |
Wenn Sie Ihre API-Version aktualisieren möchten, geben Sie in Ihren Anfragen crypto_
als Teil des Stripe-Version
-Headers an.