API développeur
Intégrer avec schémas d'URL
Lancez Payment for Stripe depuis votre application ou site web pour traiter les transactions. Transmettez les données client, les montants et les informations produit, puis gérez le rappel une fois la transaction terminée.
Comment ça marche
Votre application ouvre un paiement:// URL avec paramètres
Le paiement pour 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 d'extrémité
Créer une charge
payment://new?Effectuer un paiement unique avec montant, devise et description.
Paramètres
| Nom | Taper | 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 des frais encodée en URL |
customer | string | Non | Identifiant client Stripe existant |
email | string | Non | Courriel du client pour la réception |
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 la charge immédiatement. |
Créer une facture
payment://cart?Créez une facture Stripe avec des lignes de produits issues de votre catalogue.
Paramètres
| Nom | Taper | Requis | Description |
|---|---|---|---|
prices | string | Oui | Identifiants de prix séparés par des virgules avec les quantités (par exemple, prix_abc:2,prix_xyz:1) |
customer | string | Non | Identifiant client Stripe existant |
email | string | Non | Courriel du client pour la réception |
name | string | Non | Nom du client encodé en URL |
callback | string | Non | URL vers laquelle revenir une fois terminé |
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.
Paramètres de rappel
| Paramètre | Valeurs | Description |
|---|---|---|
status | success | error | cancelled | Résultat de la transaction |
charge_id | string | Identifiant de la transaction Stripe (en cas de succès) |
error | string | Message d'erreur (en cas d'erreur) |
Exemples
Charge simple
Facturez 10,00 $ avec un montant unique
payment://new?amount=1000Charge avec description
Facturer 25,00 € avec une description
payment://new?amount=2500¤cy=eur&description=Coffee%20and%20pastryFacturation avec nouveau client
Facturez 50,00 $ et créez un dossier client.
payment://new?amount=5000&name=John%20Smith&[email protected]Facturer le client existant
Facturer 75,00 $ à un client Stripe existant
payment://new?amount=7500&customer=cus_ABC123xyzCharge avec métadonnées
Facturez 100,00 $ avec des métadonnées personnalisées pour vos enregistrements
payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7DTraitement automatique avec rappel
Ignorez l'écran d'accueil et retournez à votre application une fois terminé.
payment://new?amount=3500&autoprocess=true&callback=myapp://payment-completeFacture 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]Exemple complet
Tous les paramètres combinés pour un flux entièrement intégré
payment://new?amount=15000¤cy=usd&description=Service%20Fee&customer=cus_ABC123xyz&metadata=%7B%22invoice%22%3A%22INV-2024-001%22%7D&autoprocess=true&callback=myapp://payment-resultEncodage 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.
Prêt à intégrer ?
Téléchargez l'application et commencez dès aujourd'hui à tester votre intégration.