Téléventes

Aperçu

L'API de paiement Télévente est une méthode efficace pour initier le processus de paiement Affirm. Cette fonctionnalité conviviale permet aux télévendeurs de lancer le processus de paiement pour les clients, en intégrant de manière transparente l’expérience avec le flux en magasin.

Comment ça fonctionne

Flux de clients

Lorsqu'un client effectue un paiement, il déclenche une redirection du navigateur ainsi qu'une requête webhook contenant le checkout_token pour l'autorisation.

Sécurité

Nous accordons la priorité à la confidentialité et à la sécurité de nos clients. Par conséquent, l’API de télévente exige que les clients présentent une demande à l’aide de leur propre appareil. Lors de la soumission d'une demande d'API, Affirm envoie un message texte ou un courriel au numéro de téléphone ou à l'adresse courriel fourni, contenant un lien vers la demande en ligne du client.

Utilisation des webhooks

For added efficiency and reliability, you can provide Affirm with a webhook address for server-to-server confirmation of the checkout_token (after the customer confirms their loan). While Affirm continues to POST the token to the user_confirmation_url, using a webhook can minimize the risk of client/browser errors and expedite the payment status update in your telesales system.

Étapes d'intégration

Étape 1 : Ajoutez Affirm comme option de paiement dans votre flux Telesales

When customers choose to pay with Affirm over the phone, your telesales agents selects Affirm as a payment option from your frontend (or agent dashboard). For details, see the sample frontend template and instructions.

Étape 2 : Appelez l'API /store pour initier l'appel de paiement Affirm

Lorsqu'un client choisit Affirm, envoyez les détails de la commande et du client à l'API /magasin d'Affirm. Cela invite Affirm à envoyer au client un lien par SMS et/ou par courriel pour terminer son paiement avec Affirm. Consultez l'exemple ci-dessous : \

POST /api/v2/checkout/store HTTP/1.1
Host: sandbox.affirm.com
Content-Type: application/json

{
      "merchant": {
        "public_api_key":               "PUBLIC_API_KEY",
        "user_cancel_url":              "https://www.cancelurl.com",
        "user_confirmation_url":        "https://www.confirmationurl.com",
        "user_confirmation_url_action": "POST",
       "name":                         "Telesales Affirm demo"
      },
      "billing":{
        "name":{
          "full":                        "John Doe"
        },
        "address":{
          "line1":                       "325 Pacific Ave",
          "city":                        "San Francisco",
          "state":                       "CA",
          "zipcode":                     "94112",
          "country":                     "USA"
        },
        "phone_number":                  "4155552222",
        "email":                         "[email protected]"
      },
  "metadata": {
    "entity_name": "Vignan 1234",
    "store_location": "Denver"
  },
      "order_id":                        "your_order_identifier_ABC_123",
      "total":                           5000         
  }

📘

Testing

The Store API sends SMS text messages only in the Affirm Live environment. During Sandbox environment testing, please rely on email messages to receive the Checkout URL to complete your Affirm purchase.

In the response, you receive the redirect_url that the customer was sent and an Affirm checkout_id, which is used for authorization.

Étape 3 : recevoir la confirmation de commande via Webhook

Once a user receives and confirms their loan, Affirm's server is notified of that event. The checkout_id is POSTed back to your server at the webhook URL that you provide your Technical Account Manager.

🚧

Configuration du webhook

You must configure a webhook URL to complete the in-store integration. Please reach out to Affirm through your Account team or the support widget.

Autoriser la transaction

Appelez l'API /transactions d'Affirm et passez le paramètre checkout_id au paramètre transaction_id et autorisez la commande. La commande doit être autorisée en toute sécurité avant de la sauvegarder ou de mettre à jour le statut de la commande sur le tableau de bord de l’agent.

Étape 4 : Mettre à jour l’interface de l’agent

Informez votre agent que la commande a été autorisée. À cette étape, l’agent de télévente peut finaliser la commande pour le client.

Étape 5 : Capturer et gérer la commande

With the persistent id received from authorization, you can initiate different transaction actions, such as capturing the order on fulfillment or issuing a refund depending on your internal processes.