Ouvrir la fonction de paiement Affirm

Aperçu

En utilisant la fonction affirm.checkout.open(), vous pouvez diriger vos clients vers le portail de paiement sécurisé d'Affirm. Ce guide décrit les étapes d'exécution de cette entité.

Étapes de mise en œuvre

Utilisation de JavaScript pour l'initialisation

Lancez le processus de paiement en créant votre objet de paiement avec affirm.checkout(). Pour faire passer le client au portail de paiement Affirm, appelez affirm.checkout.open().

affirm.ui.ready(function(){
   affirm.checkout(checkoutObject);
   affirm.checkout.open();
})

Exemple

Voici un exemple de code pour vous guider tout au long du processus :

affirm.checkout({
 
      "merchant": {
        "user_confirmation_url": "https://merchantsite.com/confirm",
        "user_cancel_url": "https://merchantsite.com/cancel",
        "user_confirmation_url_action": "POST",
        "name": "Your Customer-Facing Merchant Name"
      },
      "shipping":{
        "name":{
          "first":"Joe",
          "last":"Doe"
        },
        "address":{
          "line1":"633 Folsom St",
          "line2":"Floor 7",
          "city":"San Francisco",
          "state":"CA",
          "zipcode":"94107",
          "country":"USA"
        },
        "phone_number": "4153334567",
        "email": "[email protected]"
      },
      "billing":{
        "name":{
          "first":"Joe",
          "last":"Doe"
        },
        "address":{
          "line1":"633 Folsom St",
          "line2":"Floor 7",
          "city":"San Francisco",
          "state":"CA",
          "zipcode":"94107",
          "country":"USA"
        },
        "phone_number": "4153334567",
        "email": "[email protected]"
      },
      "items": [{
        "display_name":         "Awesome Pants",
        "sku":                  "ABC-123",
        "unit_price":           1999,
        "qty":                  3,
        "item_image_url":       "http://merchantsite.com/images/awesome-pants.jpg",
        "item_url":             "http://merchantsite.com/products/awesome-pants.html",
        "categories": [
            ["Home", "Bedroom"],
            ["Home", "Furniture", "Bed"]
        ]
      }
   ],
      "discounts":{
         "RETURN5":{
            "discount_amount":500,
            "discount_display_name":"Returning customer 5% discount"
        },
        "PRESDAY10":{
            "discount_amount":1000,
            "discount_display_name":"President's Day 10% off"
      }
   },
   "metadata":{
      "shipping_type":"UPS Ground",
      "mode":"modal"
   },
   "order_id":"JKLMO4321",
   "currency":"USD",  
   "financing_program":"flyus_3z6r12r",
   "shipping_amount":1000,
   "tax_amount":500,
   "total":100000
});

affirm.checkout.open();

Pour obtenir plus d'informations, veuillez consulter notre page Objet de paiement ou la recette de l'objet de paiement dont le lien figure ci-dessous.

📚

Configurer l'objet Checkout

Ouvrir la recette

Paramètres et rappels

Arguments de méthode

Paramètre	Type	Description
`checkoutObject`	Requis	L'objet contenant la charge utile des données pour le paiement du client.

Mécanismes de rappel

Notez que cette méthode ne renvoie généralement pas de valeur. Définir les URL de redirection à l'aide de l'objet de paiement. Si votre paramètre de métadonnées est « modal », mettez en œuvre les fonctions de rappel suivantes :

onFail: Appelé lorsque le client quitte, annule ou est refusé dans le flux de paiement Affirm.
onSuccess: Déclenché lors de la confirmation réussie du prêt Affirm. Cette fonction donne un objet de réussite, qui contient un checkout_id. Notez que ce checkout_id sera la valeur utilisée pour autoriser le prêt dans la demande d'autorisation suivante. Le onSuccess par défaut remplira une soumission de formulaire à user_confirmation_url avec la méthode définie par user_confirmation_url_action. La spécification d'un rappel onSuccess remplacera la fonctionnalité par défaut.
onOpen: appelé lorsque le passage à la caisse d'Affirm est initialisé avec succès sur l'interface utilisateur.
OnValidationError: vous alerte en cas d'erreur de validation lors de la demande de paiement.

// Callback example
affirm.checkout.open({
    onFail: function(error) {
      // Error handling
    },
    onSuccess: function(checkout) {
      // Success procedures
    },
    onOpen: function(token) {
      // Initialization successful
    },
    onValidationError: function(checkout_validation_error) {
      // Validation error handling
    }
});