Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous
AperçuMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usageManaged Payments
Moyens de paiement
Interfaces de paiement
Scénarios de paiement
Paiements par TPE
Autres produits Stripe

Utiliser l'API Onramp QuotesVersion bêta publique

Affichez des devis dans l'interface utilisateur de votre produit.

Copier la page

L’API Onramp Quotes permet aux plateformes de récupérer des devis estimatifs pour les conversions de la rampe d’accès dans diverses cryptomonnaies sur les différents réseaux concernés. Vous pouvez spécifier un montant source ou de destination fixe et limiter les devis à un sous-ensemble de devises ou de réseaux de destination. Cette API vous permet d’afficher les devis dans l’interface utilisateur de votre produit avant de rediriger l’utilisateur vers le widget de la rampe d’accès. Si le devis expire avant que l’utilisateur n’ait accédé au widget, un devis légèrement différent pourra s’afficher dans le widget de la rampe d’accès.

Obtenir un devis de conversion

Utilisez l’endpoint GET /v1/crypto/onramp_quotes pour obtenir un devis de conversion. Le tableau suivant présente tous les paramètres disponibles pour cet endpoint :

ParamètreTypePar défautDétails
source_currencyChaîne (facultatif)usdLe code de devise ISO-4217. Actuellement, seules les devises suivantes sont prises en charge : usd et eur.
source_amountChaîne (facultatif)100.00Représentation sous forme de chaîne du montant fiduciaire à prendre en compte pour la conversion. Si source_amount est défini, destination_amount doit être nul (les deux paramètres s’excluent mutuellement, car vous ne pouvez définir un montant fixe que pour un côté de la transaction).
destination_amountChaîne (facultatif)nullReprésentation sous forme de chaîne du montant de destination_currency à acheter. Si destination_amount est défini, source_amount doit être nul. Lorsque vous renseignez ce champ, vous devez également définir une valeur unique pour destination_currencies et une valeur unique pour destination_networks (afin que nous sachions quelle cryptomonnaie doit figurer sur le devis).
destination_currenciesTableau<String> (facultatif)null
  • ['usdc', 'ethereum']
Liste des cryptomonnaies pour lesquelles vous souhaitez générer des devis. Si la valeur est null, nous récupérons des devis pour toutes les destination_currencies prises en charge par destination_networks.
  • Devises : btc, eth, sol, matic, usdc, xlm
destination_networksTableau<String> (facultatif)null
  • ['polygon', 'bitcoin', 'solana', 'ethereum']
Liste des réseaux de cryptomonnaies pour lesquels vous souhaitez générer des devis. Si la valeur est null, nous récupérons des devis pour destination_currencies sur tous les réseaux.
  • Réseaux : bitcoin, ethereum, solana, polygon , stellar

Exemples de demandes de devis

Pour récupérer toutes les paires devise-réseau de destination avec un montant source par défaut de 100 USD, exécutez la commande suivante :

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp_quotes \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

Vous recevez une réponse semblable à ce qui suit :

{
  "id": "cd35838481497f403988360cc0ff5ce5c5ce7451ce8938f86d379dff7157d33d",
  "rate_fetched_at": 1674265380.6883376,
  "destination_network_quotes": {
    "ethereum": [
      {
        "id": "7eb9ccb7c1bffadf3773ca1f56ba3a352fe4a226328e72142925a80e7242b70c",
        "destination_currency": "eth",
        "destination_amount": "0.060232255577506866",
        "destination_network": "ethereum",
        "fees": {
          "network_fee_monetary": "1.41",
          "transaction_fee_monetary": "3.03"
        },
        "source_total_amount": "104.44"
      },
      {
        "id": "398de047128b6dff1abbc41519811db68dd8bcb69939b87c4a4621b1740a1c5b",
        "destination_currency": "usdc",
        "destination_amount": "100.00",
        "destination_network": "ethereum",
        "fees": {
          "network_fee_monetary": "5.63",
          "transaction_fee_monetary": "3.07"
        },
        "source_total_amount": "108.70"
      }
    ],
    ...
  },
  "livemode": true,
  "source_currency": "usd",
  "source_amount": "100.00"
}

Pour récupérer toutes les paires devise-réseau de destination avec un montant source de 200 USD, exécutez la commande suivante :

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp_quotes \
    -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
    -d "source_amount"="200"

Vous recevez une réponse semblable à ce qui suit :

{
  "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"
}

Pour récupérer des devis pour ETH et SOL sur les réseaux Ethereum et Solana, exécutez la commande suivante (qui donne ETH sur Ethereum et SOL sur Solana). Lorsque vous spécifiez destination_currencies et destination_networks, chaque paire devise-réseau valide dans leur produit croisé renvoie un devis. La valeur par défaut pour destination_currencies correspond à toutes les devises et la valeur par défaut pour destination_networks correspond à tous les réseaux.

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp_quotes \
      -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
      -d "source_amount"="200" \
      -d "destination_currencies[]"="eth" \
      -d "destination_currencies[]"="sol" \
      -d "destination_networks[]"="ethereum" \
      -d "destination_networks[]"="solana"

Vous recevez une réponse semblable à ce qui suit :

{
  "id": "c9ab6fd14f87290ef94b583f0dd346de8e197321e029776c12b7790cd83fb78c",
  "rate_fetched_at": 1674265576.8238478,
  "destination_network_quotes": {
    "bitcoin": [],
    "ethereum": [
      {
        "id": "97bbd7b9f8bc1a029264cdc28b47b636e989f8bcab96a80a3bded2094131e311",
        "destination_currency": "eth",
        "destination_amount": "0.253433817682353791",
        "destination_network": "ethereum",
        "fees": {
          "network_fee_monetary": "1.46",
          "transaction_fee_monetary": "12.71"
        },
        "source_total_amount": "214.17"
      }
    ],
    "polygon": [],
    "solana": [
      {
        "id": "79f00923b96543aa69d140172c7cefd0e73a2ed089d8935e63dcf21028698e23",
        "destination_currency": "sol",
        "destination_amount": "16.767237943",
        "destination_network": "solana",
        "fees": {
          "network_fee_monetary": "0.01",
          "transaction_fee_monetary": "12.70"
        },
        "source_total_amount": "212.71"
      }
    ]
  },
  "livemode": true,
  "source_currency": "usd",
  "source_amount": "200.00"
}

Pour récupérer des devis pour l’USDC sur Ethereum et Solana, exécutez la commande suivante :

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp_quotes \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "source_amount"="200" \
  -d "destination_currencies[]"="usdc" \
  -d "destination_networks[]"="ethereum" \
  -d "destination_networks[]"="solana"

Vous recevez une réponse semblable à ce qui suit :

{
  "id": "8727e8de9a22915aea079973028054e31d362a328758a5953cee6ba1b6f22569",
  "rate_fetched_at": 1674268717.432479,
  "destination_network_quotes": {
    "bitcoin": [],
    "ethereum": [
      {
        "id": "603f29933c921d59b169572cf2d61da7d88f2a6973da0d6fcb686b3dec3de223",
        "destination_currency": "usdc",
        "destination_amount": "200.00",
        "destination_network": "ethereum",
        "fees": {
          "network_fee_monetary": "5.88",
          "transaction_fee_monetary": "12.76"
        },
        "source_total_amount": "218.64"
      }
    ],
    "polygon": [],
    "solana": [
      {
        "id": "38b8388072e6272e7a0c0d5ee1161d3d747362a574f54fe76f1554ff60e3a007",
        "destination_currency": "usdc",
        "destination_amount": "200.00",
        "destination_network": "solana",
        "fees": {
          "network_fee_monetary": "0.01",
          "transaction_fee_monetary": "12.70"
        },
        "source_total_amount": "212.71"
      }
    ]
  },
  "livemode": true,
  "source_currency": "usd",
  "source_amount": "200.00"
}

Pour récupérer un devis pour une paire devise-réseau de destination (ETH sur Ethereum) avec destination_amount spécifié, exécutez la commande suivante :

Command Line
curl -G https://api.stripe.com/v1/crypto/onramp_quotes \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "destination_amount"="0.42" \
  -d "destination_currencies[]"="eth" \
  -d "destination_networks[]"="ethereum"

Vous recevez une réponse semblable à ce qui suit :

{
  "id": "74f73859a8836293ce4f1e6757dc258c9f1016deea7b075faba8b5755d163168",
  "rate_fetched_at": 1674268804.6989243,
  "destination_network_quotes": {
    "bitcoin": null,
    "ethereum": [
      {
        "id": "f1adad5680b081031b03b89c174d25ce6b609416fc82f976423e95a089a10334",
        "destination_currency": "eth",
        "destination_amount": "0.420000000000000000",
        "destination_network": "ethereum",
        "fees": {
          "network_fee_monetary": "1.45",
          "transaction_fee_monetary": "21.06"
        },
        "source_total_amount": "719.53"
      }
    ],
    "polygon": null,
    "solana": null
  },
  "livemode": true,
  "source_currency": "usd",
  "source_amount": "697.02"
}
Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc