Développer et tester votre application

Suivez les conseils ci-dessous pour les intégrations Apps on Devices.

Détecter un lecteur et s’y connecter

private fun discoverReaders() {
    Terminal.getInstance().discoverReaders(
        config = HandoffDiscoveryConfiguration(),
        discoveryListener = object : DiscoveryListener {
            override fun onUpdateDiscoveredReaders(readers: List<Reader>) {
                // In handoff discovery, the list will
                // contain a single reader. Connect to
                // the reader after it is discovered.
                readers.firstOrNull()?.let { reader ->
                    connectReader(reader)
                }
            }
        },
        callback = object : Callback {
            override fun onSuccess() {
                // Handle successfully discovering readers
            }

            override fun onFailure(e: TerminalException) {
                // Handle exception while discovering readers
            }
        }
    )
}

private fun connectReader(reader: Reader) {
    Terminal.getInstance().connectReader(
        reader,
        ConnectionConfiguration.HandoffConnectionConfiguration(
            object : HandoffReaderListener {
                override fun onDisconnect(reason: DisconnectReason) {
                    // Optionally get notified about reader disconnects (for example, reader was rebooted)
                }

                override fun onReportReaderEvent(event: ReaderEvent) {
                    // Optionally get notified about reader events (for example, a card was inserted)
                }
            }
        ),
        object : ReaderCallback {
            override fun onSuccess(reader: Reader) {
                // Handle successfully connecting to the reader
            }

            override fun onFailure(e: TerminalException) {
                // Handle exception when connecting to the reader
            }
        }
    )
}

Encaisser des paiements

Après vous être connecté au lecteur en mode transfert, vous pouvez commencer à encaisser les paiements.

L’application de lecteur Stripe gère l’encaissement des paiements et d’autres opérations de paiement, telles que l’enregistrement d’une carte bancaire. Lorsqu’une opération de paiement est initiée, l’application de lecteur Stripe passe au premier plan et en plein écran. Ensuite, elle guide le client tout au long du processus et, une fois l’opération terminée (qu’elle ait abouti ou non) ou annulée par le client, replace votre application au premier plan. Lorsque votre application est au premier plan, l’application de lecteur Stripe continue de s’exécuter en arrière-plan.

Obtenez un exemple de collecte des paiements dans une application Apps on Devices.

Encaisser des paiements hors ligne Beta

Apps on Devices prend en charge la collecte des paiements hors ligne.

Vous pouvez accéder aux paramètres d’administration de l’appareil en lançant l’URI de lien profond stripe://settings/ depuis votre application.

Obtenez un exemple de lancement de l’URI de lien profond pour accéder aux paramètres d’administration.

startActivity(
    Intent(Intent.ACTION_VIEW)
        .setData(Uri.parse("stripe://settings/"))
)

Stripe ne fournit pas de solution d’instrumentation au niveau de l’application. Pour garder une trace des crashs et autres logs de votre application, vous pouvez utiliser une bibliothèque tierce telle que Sentry ou Crashlytics.

La valeur renvoyée par Locale.getDefault() dépend de la langue choisie par l’utilisateur de l’appareil (et non du pays). Vous pouvez modifier la langue de l’appareil dans les paramètres d’administration.

Les appareils Android Stripe ont le paramètre Auto-rotation de l’écran activé par défaut. Votre application peut remplacer ce paramètre en verrouillant l’interface utilisateur sur une orientation d’écran donnée.

Pour ce faire, il suffit de définir l’attribut screenOrientation sur les balises <activity> correspondantes dans le manifeste.

<activity
    android:name=".MainActivity"
    android:screenOrientation="portrait">
</activity>

L’orientation peut également être définie de manière programmatique à l’aide de Activity::setRequestedOrientation dans votre classe Activity.

class MainActivity : Activity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Lock to portrait orientation
        requestedOrientation = ActivityInfo.SCREEN_ORIENTATION_PORTRAIT

        // Or, lock to landscape orientation
        // requestedOrientation = ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE
    }
}

Les appareils Stripe Android n’affichent pas d’interface utilisateur système, de bouton de retour ni de barre d’état.

Si votre application doit communiquer un niveau de batterie, un état de charge ou un état de connexion à l’utilisateur, consultez la documentation suivante dédiée à l’API Android pour obtenir des conseils :

• Suivre le niveau et l’état de charge de la batterie
• Suivre l’état de la connectivité et des mesures de connexion

Lorsque le lecteur Stripe se connecte ou se déconnecte d’une station d’accueil, le système d’exploitation Android déclenche un changement de configuration.

Par défaut, l’activité de votre application est automatiquement recréée lors d’un changement de configuration.

Pour désactiver la recréation automatique de l’activité lors de la connexion ou de la déconnexion d’une station d’accueil, ajoutez android:configChanges="uiMode" dans l’entrée <activity> de votre fichier AndroidManifest.xml.

<activity
    android:name=".MyActivity"
    android:configChanges="uiMode" />

Votre activité peut être notifiée des changements de configuration en implémentant Activity::onConfigurationChanged. Cette méthode n’est appelée que si vous avez spécifié les configurations que vous souhaitez gérer avec l’attribut android:configChanges dans votre manifeste.

class MainActivity : Activity() {
    override fun onConfigurationChanged(newConfig: Configuration) {
        super.onConfigurationChanged(newConfig)
        // implement custom configuration change handling logic
    }
}