Adobe Commerce (Magento) Telesales Integration

Aperçu

This guide describes how to add the Affirm Telesales Add-on module for Adobe Commerce (Magento). The module allows your phone representatives and administrators to provide Affirm as a payment option when creating orders in Adobe Commerce (Magento). When they create an order using the Telesales option, Affirm sends the customer a link via email and SMS to begin their loan application process.

Before You Begin

Before adding the module, you should have already installed and configured Affirm for Adobe Commerce (Magento).

Cliquez ici pour consulter les notes de mise à jour du module Adobe Commerce Telesales.

Sandbox Development

Développez et testez l'intégration d'Affirm dans votre environnement de développement connecté à notre bac à sable. Pour utiliser notre bac à sable, récupérez vos clés API sandbox sur https://sandbox.affirm.com/dashboard/#/apikeys à utiliser pendant l'intégration.

Notez que nous n'envoyons des SMS avec le lien de paiement que depuis l'environnement Affirm Live. Pendant les tests en environnement Sandbox, utilisez des courriels pour le lien de caisse.

Après le développement et les tests, vous devrez mettre à jour votre intégration pour utiliser vos clés API en direct, que vous trouverez à l'adresse https://affirm.com/dashboard/#/apikey.

1. Install the Adobe Commerce (Magento) Telesales module

Download the Adobe Commerce (Magento) Telesales Add-on module here.

Installation à l'aide de Composer

Accédez à MAGENTO_ROOT et exécutez la commande suivante :

composer require affirm/magento2-telesales

Mettez à jour le module en exécutant les commandes suivantes :

composer update
php bin/magento setup:upgrade
php bin/magento setup:di:compile

2. Configure the Adobe Commerce (Magento) Telesales module

After installing the Adobe Commerce (Magento) Telesales module, enable it by updating Adobe Commerce (Magento) configurations:

Sign in to your Adobe Commerce (Magento) admin portal.
Accédez à Magasins > Configuration > Ventes > Modes de paiement > Affirm > Extension Affirm Televentes.
Définissez Activé sur Oui.
Sous Affirm, gardez le mode réglé sur Sandbox (pour le développement et les tests) et assurez-vous que le reste des paramètres est configuré, comme la clé API publique et la clé API privée que vous avez récupérées dans le tableau de bord marchand Affirm environnement de test.
Si votre processus de caisse capture automatiquement les frais, définissez Action de paiement sur Autoriser et capturer.

3. Test the Module

Nous envoyons uniquement des SMS avec le lien de paiement de l'environnement Affirm Live. Pendant les tests en environnement Sandbox, utilisez des courriels pour le lien de caisse.

Dans votre système de gestion des commandes, créez une commande.
Saisissez une adresse et un numéro de téléphone mobile valides aux États-Unis (Affirm ne fonctionnera pas avec une fausse adresse ou un faux numéro de téléphone).
Sélectionnez Affirm comme option de paiement.

Cliquez sur Soumettre la commande pour la placer dans un état En attente.
Sous Informations de paiement, cliquez sur le bouton Envoyer le lien de caisse Affirm.

Trouvez le courriel contenant le lien de paiement et cliquez dessus.
Si vous disposez d'un compte existant, cliquez sur Se connecter.
Si vous n'avez pas de compte existant, créez-en un avec les éléments suivants :

Tout prénom et nom de famille.
Une adresse courriel avec un format valide.
Un numéro de téléphone cellulaire américain valide (vous n'avez pas besoin d'accéder à ce numéro) que vous utiliserez lors de toutes les tentatives de paiement ultérieures
Une date de naissance datant de plus de 18 ans.
Quatre chiffres quelconques.

Saisissez 1234 pour le code de vérification et cliquez sur VERIFY CODE.
Complétez le processus de paiement et cliquez sur CONFIRMER LE PRÊT.
Vérifiez que la commande est traitée ou complétée dans votre tableau de bord de gestion des commandes.
Vérifiez que la transaction apparaît dans le panneau d'administration de votre plateforme et sur sandbox.affirm.com/dashboard.

4. Go Live

Step 1: Sandbox Development

Avant de mettre en œuvre votre intégration Affirm, nous vous suggérons de la tester dans votre environnement de développement connecté à notre bac à sable. Pour utiliser notre bac à sable, récupérez vos clés API sandbox sur https://sandbox.affirm.com/dashboard/#/apikeys à utiliser pendant l'intégration.

Après le développement et les tests, vous devrez mettre à jour votre intégration pour utiliser vos clés API en direct, que vous trouverez à l'adresse https://affirm.com/dashboard/#/apikey.

Step 2: Connect to the Live Affirm Environment

Récupérez vos clés API en direct sur https://affirm.com/dashboard/#/apikey.
Dans le panneau d'administration Magento 2, accédez à Magasins > Configuration > Ventes > Modes de paiement > Affirm.
Définissez le Mode sur Production.
Saisissez la clé API publique et la clé secrète (clé privée) que vous venez de récupérer dans le tableau de bord des Commerçants d'Affirm.

Step 3: Go Live!

Une fois que vous êtes connecté à notre environnement réel et que nous avons testé votre intégration, vous êtes prêt à passer à l'action et à proposer Affirm comme option de paiement à vos clients.

FAQ and Other Known Issues

Comment résoudre les problèmes de compatibilité avec Magento 2.2.x
La version Magento 2.2.x ou inférieure devra remplacer les fonctions suivantes :
addCommentToStatusHistory --> addStatusHistoryComment

// Update order history comment
$order->addStatusHistoryComment('Affirm checkout has been sent to the customer. Checkout token: '.$checkout_token, false, false);

Les modifications liées à CsrfAwareActionInterface devront être supprimées :
class Confirm extends Action implements CsrfAwareActionInterface --> class Confirm extends Action

class Confirm extends Action

Comment résoudre le problème de page d'erreur d'administration vide lors de l'installation sous MAGENTO_ROOT/app/code/
Magento 2.2.x :

{
    $realPath = str_replace('\\', '/', $this->fileDriver->getRealPath($path));
    if (!is_array($directories)) {
        $directories = (array)$directories;
    }
    foreach ($directories as $directory) {
        if (0 === strpos($realPath, $directory)) {
            return true;
        }
    }
    return false;
}

Magento 2.3.x :

$realPath = str_replace('\\', '/', $this->fileDriver->getRealPath($path));