AccueilCommencerSolutionsPlateformesIntégrations globales
DocsRéférence APIRéférence APIRecetteChangelog
AccueilCommencerSolutionsPlateformesIntégrations globalesSe connecter
Docs

Configurer une carte virtuelle sur Android

Découvrez comment configurer la carte virtuelle Affirm sur votre application Android.

Suggérer des modifications

Conditions préalables

É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 objet CardDetails. 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