Accepter un paiement Affirm

Une session Checkout doit remplir toutes les conditions suivantes pour prendre en charge les paiements Affirm :

• Vous ne pouvez utiliser que les postes ponctuels. Affirm ne prend pas en charge les plans d’abonnement récurrents.
• Les tarifs doivent être exprimés dans la devise locale.

Suivez ce guide pour savoir comment activer Affirm et découvrir les différences entre l’acceptation d’un paiement par carte et l’utilisation d’Affirm.

Activer le moyen de paiement Affirm

Lors de la création d’une nouvelle session Checkout, vous devez :

1. Ajoutez affirm à la liste payment_method_types.
2. Veillez à ce que tous vos line_items utilisent votre devise locale.
3. Nous vous recommandons de collecter les adresses de livraison en ajoutant votre pays au paramètre shipping_address_collection[allowed_countries]. Si vous ne souhaitez pas collecter l’adresse de livraison avec Checkout, vous pouvez également la fournir à l’aide de payment_intent_data[shipping]. Ces informations sont utiles pour le calcul des taux d’approbation de prêt.

Stripe::Checkout::Session.create({
      mode: 'payment',
      payment_method_types: ['card'],
      payment_method_types: ['card', 'affirm'],
      line_items: [{
        price_data: {
          currency: 'usd',
          product_data: {
            name: 'T-shirt',
          },
          # Make sure the total amount fits within Affirm's transaction amount limits
          unit_amount: 5000,
        },
        quantity: 1,
      }],
      shipping_address_collection: {
        # Shipping address is optional but recommended to pass in
        # Specify which shipping countries Checkout should provide as options for shipping locations
        allowed_countries: ['CA', 'US'],
      },
      # If you already have the shipping address, provide it in payment_intent_data:
      # payment_intent_data: {
      #   shipping: {
      #     name: 'Jenny Rosen',
      #     address: {
      #       line1: '1234 Main Street',
      #       city: 'San Francisco',
      #       state: 'CA',
      #       country: 'US',
      #       postal_code: '94111',
      #     },
      #   },
      # },
      success_url: 'https://example.com/success',
      cancel_url: 'https://example.com/cancel',
    })

Traiter vos commandes

Utilisez une méthode telle que les webhooks pour gérer le traitement de la commande plutôt que d’attendre que votre client revienne sur la page de l’état du paiement.

Les événements suivants sont envoyés lorsque l’état du paiement change :

En savoir plus sur le traitement des commandes.

Lors du test de votre intégration Checkout, sélectionnez le moyen de paiement Affirm, puis cliquez sur le bouton Payer.

Testez votre intégration Affirm en affichant la page de redirection à l’aide de vos clés API de test. Vous pouvez tester la réussite de paiement en l’authentifiant sur la page de redirection. Le PaymentIntent passe alors de l’état requires_action à succeeded.

Pour tester un échec d’authentification de l’utilisateur, utilisez vos clés API de test et accédez à la page de redirection. Sur cette page, fermez la fenêtre modale Affirm et vérifiez que le paiement n’a pas fonctionné. Votre PaymentIntent passe donc de l’état requires_action à requires_payment_method.

Lors de la redirection vers le bac à sable Affirm, Affirm peut demander les quatre derniers chiffres de votre numéro de sécurité sociale. Affirm suggère d’utiliser '0000' ou '5678'.

Pour les PaymentIntents à capture manuelle en mode test, le PaymentIntent non capturé expire automatiquement 10 minutes après l’aboutissement de l’autorisation.