API

Un schéma d'URL simple et facile à utiliser pour intégrer votre entreprise à Payment for Stripe.

Redirigez facilement depuis n'importe quelle application ou site Web iOS, directement dans l'application de paiement pour être payé.

Remplir une nouvelle charge

Transmettez les données à Payment pour créer des frais: payment://new?

Ajouter un montant, en cents: payment://new?amount=2000

Choisissez une devise acceptée: payment://new?currency=usd

Ajoutez une description codée en URL pour le débit: payment://new?description=Cat+Sweater

Créer une facture avec des éléments de ligne

Vous pouvez également créer une facture Stripe par ligne: payment://cart?

Passez une paire d'identifiant de prix et de quantité: payment://cart?line_items=price_xxx:3

Ou transmettez plusieurs identifiants de prix et quantités: payment://cart?line_items=price_abc:3,price_xyz:2

De plus, vous pouvez appliquer un coupon: payment://cart?coupon=kZjFzekm

Fournir des informations sur le client (facultatif)

Ajoutez un nom encodé d'URL pour le client: payment://new?name=John+Doe

Indiquez une adresse e-mail pour un reçu: payment://new?[email protected]

Fournir une URL de rappel

Une fois la transaction réussie, l'application de paiement reviendra à votre application. payment://new?callback=https://foo.bar.com/hook

En plus d'iOS vous renvoyant automatiquement sur votre site Web, nous renverrons également quelques informations, notamment: https://foo.bar.com/hook?success=true&
  amount=2000&currency=usd&
  chargeId=pi_xxxxxx

En cas d'erreur, vous pouvez recevoir un message au format: https://foo.bar.com/hook?error[message]=Card+declined

https://foo.bar.com/hook?cancelled=true

Utiliser un client existant

Utilisez un client Stripe existant en transmettant son identifiant : payment://new?customer_id=cus_xxxxxx

Cela permet de présélectionner le client pour la transaction, afin que ses modes de paiement enregistrés soient disponibles.

Inclure des métadonnées personnalisées

Transmettez des métadonnées personnalisées à inclure dans la facturation Stripe : payment://new?metadata[order_id]=12345

Ajoutez plusieurs champs de métadonnées selon vos besoins : payment://new?metadata[order_id]=12345&
  metadata[source]=pos

Traitement automatique des paiements

Passez l'écran d'accueil et lancez la charge immédiatement : payment://new?amount=2000&auto=true

Le paiement démarrera automatiquement à l'ouverture de l'application. Si un lecteur de carte est connecté, l'application vous proposera immédiatement de payer.

Exemple complet

Voici un exemple qui combine tous ces éléments :

payment://new?amount=2000&
  currency=usd&
  customer_id=cus_xxxxxx&
  metadata[order_id]=12345&
  callback=myapp://payment&
  auto=true

Vous voulez quelque chose de plus de l'API?
Faites le nous savoir