API développeur

Intégrez et personnalisez

Lancez Payment for Stripe depuis votre propre application ou site web via les schémas d'URL, et contrôlez quels produits apparaissent dans l'application directement depuis votre tableau de bord Stripe.

Intégration par schémas d'URL

Déclenchez des paiements depuis votre application ou site web, transmettez les données client et gérez les callbacks.

Masquer des produits par métadonnées

Excluez de l'application les produits vendus uniquement en ligne avec une seule clé de métadonnées.

Intégration par schémas d'URL

Comment ça marche

Votre application ouvre un payment:// URL avec paramètres

Payment for Stripe lance et traite la transaction

Une fois l'opération terminée, l'application redirige vers votre URL de rappel avec le résultat.

Points de terminaison

Créer un paiement

payment://new?

Effectuer un paiement unique avec montant, devise et description.

Paramètres

Nom	Type	Requis	Description
`amount`	integer	Oui	Montant en centimes (ex. : 1000 = 10,00 $)
`currency`	string	Non	Code monétaire ISO à trois lettres (par défaut : USD)
`description`	string	Non	Description du paiement encodée en URL
`customer`	string	Non	Identifiant client Stripe existant
`email`	string	Non	E-mail du client pour le reçu
`name`	string	Non	Nom du client encodé en URL
`metadata`	string	Non	Paires clé-valeur personnalisées (JSON encodé en URL)
`callback`	string	Non	URL vers laquelle revenir une fois terminé
`autoprocess`	boolean	Non	Passez l'écran d'accueil et lancez le paiement immédiatement.
`auto_return`	boolean	Non	Déclencher la fonction de rappel dès le chargement du résultat, sans attendre que le commerçant ferme la boîte de dialogue de résultats. Valeur par défaut : false.

Créer une facture

payment://cart?

Créez une facture Stripe avec des lignes de produits issues de votre catalogue.

Paramètres

Nom	Type	Requis	Description
`prices`	string	Oui	Identifiants de prix séparés par des virgules avec les quantités (par exemple, price_abc:2,price_xyz:1)
`customer`	string	Non	Identifiant client Stripe existant
`email`	string	Non	E-mail du client pour le reçu
`name`	string	Non	Nom du client encodé en URL
`callback`	string	Non	URL vers laquelle revenir une fois terminé
`auto_return`	boolean	Non	Déclencher la fonction de rappel dès le chargement du résultat, sans attendre que le commerçant ferme la boîte de dialogue de résultats. Valeur par défaut : false.

Payer une facture existante (iOS uniquement)

payment://invoice?

Encaissez un paiement en personne correspondant à une facture Stripe existante. Le montant, la devise, le client et la taxe sont extraits de la facture. Toute modification de ces informations est refusée. Le commerçant encaisse la carte via un lecteur, Tap to Pay ou la saisie manuelle. En cas de succès, la facture est marquée comme payée hors bande et associée via les métadonnées charge_id et payment_intent_id. Les factures comportant des abonnements, un default_payment_method ou un statut autre que « open » sont refusées avec un message d'erreur indiquant la marche à suivre.

Paramètres

Nom	Type	Requis	Description
`id`	string	Oui	Identifiant de facture Stripe (doit commencer par in_)
`callback`	string	Non	URL de retour après traitement. Reçoit invoice_id et payment_intent_id en cas de succès.
`metadata`	string	Non	Paires clé-valeur personnalisées (JSON encodé en URL) fusionnées dans les métadonnées PaymentIntent
`autoprocess`	boolean	Non	Passez l'écran d'accueil et lancez le paiement immédiatement.
`auto_return`	boolean	Non	Déclencher la fonction de rappel dès le chargement du résultat, sans attendre que le commerçant ferme la boîte de dialogue de résultats. Valeur par défaut : false.

Gestion des rappels

Une fois la transaction terminée, Payment for Stripe redirige vers votre URL de rappel avec des paramètres de requête indiquant le résultat. Par défaut, la redirection s'effectue après que le commerçant a fermé la boîte de dialogue de résultat afin qu'il puisse effectuer des actions post-transaction (envoi d'un reçu par e-mail, remboursement). Passez auto_return=true pour que la redirection s'effectue dès que le résultat est connu. Compatible avec iOS et Android.

Paramètres de rappel

Paramètre	Valeurs	Description
`status`	success \| error \| cancelled	Résultat de la transaction
`charge_id`	string	Identifiant du paiement Stripe (en cas de succès)
`invoice_id`	string	ID de facture Stripe (en cas de succès, flux payment://invoice uniquement)
`payment_intent_id`	string	ID d'intention de paiement Stripe (en cas de succès, flux payment://invoice uniquement)
`error`	string	Message d'erreur (en cas d'erreur)

Exemples

Paiement simple

Encaissez 10,00 $ avec un simple montant

payment://new?amount=1000

Paiement avec description

Encaissez 25,00 € avec une description

payment://new?amount=2500&currency=eur&description=Coffee%20and%20pastry

Paiement avec nouveau client

Encaissez 50,00 $ et créez une fiche client

payment://new?amount=5000&name=John%20Smith&[email protected]

Paiement d'un client existant

Encaissez 75,00 $ auprès d'un client Stripe existant

payment://new?amount=7500&customer=cus_ABC123xyz

Paiement avec métadonnées

Encaissez 100,00 $ avec des métadonnées personnalisées pour votre suivi

payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7D

Traitement automatique avec rappel

Ignorez l'écran d'accueil et retournez à votre application une fois terminé.

payment://new?amount=3500&autoprocess=true&callback=myapp://payment-complete

Retour automatique sur résultat

Déclenchez la fonction de rappel dès que le résultat est connu, au lieu d'attendre que le commerçant ferme la boîte de dialogue de résultat.

payment://new?amount=3500&autoprocess=true&auto_return=true&callback=myapp://payment-complete

Facture avec lignes de détail

Créez une facture avec les produits de votre catalogue Stripe

payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]

Payer une facture existante (iOS)

Encaisser un paiement en personne pour une facture Stripe existante. Renvoie invoice_id et payment_intent_id en cas de succès.

payment://invoice?id=in_1ABC123xyz&autoprocess=true&callback=myapp://invoice-paid

Exemple complet

Tous les paramètres combinés pour un flux entièrement intégré

payment://new?amount=15000&currency=usd&description=Service%20Fee&customer=cus_ABC123xyz&metadata=%7B%22invoice%22%3A%22INV-2024-001%22%7D&autoprocess=true&callback=myapp://payment-result

Encodage URL

N'oubliez pas d'encoder les caractères spéciaux des valeurs de paramètres en URL. Les espaces deviennent %20, les accolades deviennent %7B et %7D.

Masquer des produits par métadonnées

Masquer des produits dans l'application

L'application affiche les produits et les tarifs de votre compte Stripe. Pour en exclure un de l'application (par exemple, des articles vendus uniquement via votre boutique en ligne), ajoutez cette clé de métadonnées au produit ou au tarif dans le tableau de bord Stripe :

payment_hidden = true

Sur un produit : masque le produit et tous ses tarifs.

Sur un tarif : masque uniquement ce tarif.

Supprimez la clé, ou définissez-la sur false, pour l'afficher à nouveau. Les changements s'appliquent au prochain chargement de votre liste de produits dans l'application.

Les liens de panier continuent de fonctionner

Le masquage n'affecte que la liste de produits dans l'application. Les URL payment://cart qui référencent un tarif masqué continuent de fonctionner, et les abonnements existants ne sont pas affectés.

Prêt à intégrer ?

Téléchargez l'application et commencez dès aujourd'hui à tester votre intégration.

Télécharger pour iOS Télécharger pour Android

Contacter l'assistance