Collecter les adresses physiques et les numéros de téléphone
Découvrez comment collecter des adresses et des numéros de téléphone dans votre application mobile.
Pour collecter des adresses complètes à des fins de facturation ou de livraison, utilisez l’Address Element.
Vous pouvez également utiliser l’Address Element pour :
- Collecter les numéros de téléphone des clients
- Activer l’autocomplétion
- Préremplir les informations de facturation dans le Payment Element en transmettant une adresse de livraison
Stripe combine les informations recueillies sur l’adresse et le moyen de paiement pour créer un PaymentIntent.

Configurer StripeCôté serveurCôté client
Pour commencer, vous devez créer un compte Stripe. Inscrivez-vous maintenant.
Le SDK React Native est disponible en open source et fait l’objet d’une documentation complète. En interne, il utilise des SDK Android et iOS natifs. Pour installer le SDK React Native de Stripe, exécutez l’une des commandes suivantes dans le répertoire de votre projet (selon le gestionnaire de paquets que vous utilisez) :
Ensuite, installez les autres dépendances requises :
- Pour iOS, accédez au répertoire ios et exécutez
pod install
pour vous assurer d’installer également les dépendances natives requises. - Pour Android, vous n’avez plus besoin d’installer de dépendances.
Initialisation de Stripe
Pour initialiser Stripe dans votre application React Native, wrappez votre écran de paiement avec le composant StripeProvider
ou utilisez la méthode d’initialisation initStripe
. Seule la clé publiable de l’API dans publishableKey
est nécessaire. L’exemple suivant montre comment initialiser Stripe à l’aide du composant StripeProvider
.
import { StripeProvider } from '@stripe/stripe-react-native'; function App() { return ( <StripeProvider publishableKey=
> // Your app code here </StripeProvider> ); }"pk_test_TYooMQauvdEDq54NiTphI7jx"
Remarque
Utilisez vos clés de test d’API lors de vos activités de test et de développement, et vos clés du mode production pour la publication de votre application.
Configurer des suggestions de remplissage automatique de l'adresse
Sur iOS, la saisie semi-automatique est activée par défaut. Pour activer les suggestions de saisie semi-automatique sur Android, vous devez inclure la dépendance SDK Google Places dans le fichier build.
de votre application :
Les suggestions de saisie semi-automatique d’adresse nécessitent une clé API Google Places. Suivez le guide de configuration du SDK Google Places pour générer votre clé API.
Configurer l'Address Element
Vous pouvez configurer l’Address Element en ajoutant des détails tels que l’affichage des valeurs par défaut, la définition des pays autorisés, la personnalisation de l’apparence, etc. Reportez-vous à la liste des options disponibles pour obtenir de plus amples informations.
<AddressSheet appearance={{ colors: { primary: '#F8F8F2', background: '#272822' } }} defaultValues={{ phone: '111-222-3333', address: { country: 'United States', city: 'San Francisco', }, }} additionalFields={{ phoneNumber: 'required', }} allowedCountries={['US', 'CA', 'GB']} primaryButtonTitle={'Use this address'} sheetTitle={'Shipping Address'} googlePlacesApiKey={'(optional) YOUR KEY HERE'} />
Afficher le composant Address Element et récupérer les informations
Récupérez les informations de l’adresse en définissant la propriété visible
sur true
et en ajoutant des méthodes de rappel pour les propriétés onSubmit
et onError
:
<AddressSheet visible={true} onSubmit={async (addressDetails) => { // Make sure to set `visible` back to false to dismiss the address element. setAddressSheetVisible(false); // Handle result and update your UI }} onError={(error) => { if (error.code === AddressSheetError.Failed) { Alert.alert('There was an error.', 'Check the logs for details.'); console.log(err?.localizedMessage); } // Make sure to set `visible` back to false to dismiss the address element. setAddressSheetVisible(false); }} />