Configurer une carte virtuelle sur Android
Découvrez comment configurer la carte virtuelle Affirm sur votre application Android.
Conditions préalables
- Consultez À propos de la carte virtuelle Affirm.
Étapes
1. Configurer Affirm sur Android
Remarque : le SDK Android est à code source ouvert et entièrement documenté.
Avec Gradle
Pour installer le SDK, ajoutez affirm-merchant-sdk-android
au bloc de dépendances de votre fichier app/build.gradle:
apply plugin: 'com.android.application'
android { ... }
dependencies {
// ...
// Affirm Android SDK
implementation 'com.affirm:affirm-android-sdk:2.0.7'
}
Avec Maven
Ajoutez la dépendance Affirm à votre fichier pom.xml :
<dependency>
<groupId>com.affirm</groupId>
<artifactId>affirm-android-sdk</artifactId>
<version>2.0.1</version>
</dependency>
Versions du SDK
Pour en savoir plus sur la dernière version du SDK et les versions antérieures, consultez la page des versions sur GitHub. Pour recevoir des notifications lorsqu'une nouvelle version est publiée, surveillez communiqués pour le dépôt.
2. Initialiser Affirm
Configurez le SDK avec votre clé API publique Affirm afin qu'il puisse effectuer des requêtes vers le serveur Affirm :
Affirm.initialize(new Affirm.Configuration.Builder("public key")
.setEnvironment(Affirm.Environment.SANDBOX)
.setName("merchant name")
.setUseVcn("true")
.setReceiveReasonCodes("true")
.setLogLevel(Affirm.LOG_LEVEL_DEBUG)
.setCheckoutRequestCode(8001)
.setVcnCheckoutRequestCode(8002)
.setPrequalRequestCode(8003)
.build()
3. Rendu du paiement Affirm
La création de paiement est le processus par lequel un client utilise Affirm pour payer un achat intégré à l’application. Créer un objet checkout
et lancer le paiement Affirm à l'aide de cette fonction Checkout
:
final Checkout checkout = Checkout.builder()
.setOrderId("order id")
.setItems(items)
.setBilling(shipping)
.setShipping(shipping)
.setShippingAmount(0f)
.setTaxAmount(100f)
.setTotal(1100f)
.build();
Affirm.startCheckout(this, checkout, false);
Flottants
L’objet de paiement contient des détails sur la commande.
Les montants doivent être des montants en dollars représentés sous forme de flotteurs.
4. Gérer les rappels
Remplacez onActivityResult
puis appelez la méthode handleCheckoutData. Cela renvoie l'objet CardDetails
, qui contient les détails de la carte Affirm. Si vous avez des préoccupations concernant la norme PCI, vous pouvez également choisir de ne récupérer que les détails de la carte depuis votre serveur via le checkout_id
.
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
if (Affirm.handleVcnCheckoutData(this, requestCode, resultCode, data)) {
return;
}
super.onActivityResult(requestCode, resultCode, data);
}
Fonctions de gestionnaire supplémentaires disponibles :
@Override
public void onAffirmVcnCheckoutCancelled() {
Toast.makeText(this, "Vcn Checkout Cancelled", Toast.LENGTH_LONG).show();
}
@Override
public void onAffirmVcnCheckoutError(@Nullable String message) {
Toast.makeText(this, "Vcn Checkout Error: " + message, Toast.LENGTH_LONG).show();
}
@Override
public void onAffirmVcnCheckoutSuccess(@NonNull CardDetails cardDetails) {
Toast.makeText(this, "Vcn Checkout Card: " + cardDetails.toString(), Toast.LENGTH_LONG).show();
}
Une fois que le paiement a été confirmé par l'utilisateur, l'objet
AffirmCheckoutDelegate
reçoit un objetCardDetails
. Les détails de la carte sont ensuite transmis à votre serveur afin d'être utilisés avec vos systèmes de paiement par carte existants.
Sujets recommandés
Mis à jour about 1 month ago