Linxo Connect
Introduction
Linxo Connect est une méthode de paiement bancaire en temps réel proposée par le groupe bancaire français Crédit Agricole.
Étant donné que Linxo Connect est directement intégré dans des applications bancaires établies, vos clients peuvent utiliser cette méthode de paiement sans effort supplémentaire. Ainsi, Linxo Connect vous permet de canaliser les paiements directement depuis votre site web de manière transparente et sécurisée.
Vous envoyez une requête standard à notre plateforme pour rediriger vos clients vers le portail Linxo Connect pour ouvrir l'application bancaire.
L'intégration est très simple, car vous n'avez besoin d'envoyer que quelques propriétés supplémentaires avec votre demande.
Avantages clés
- Exigences PCI basses (aucune donnée sensible ou personnelle partagée)
- Intégration facile
- Services bancaires en temps réel
Activation
Pour activer Linxo Connect dans votre compte en direct, suivez ces étapes :
- Signez un contrat avec Linxo Connect et recevez en retour des identifiants d'activation.
- Entrez les identifiants dans le Merchant Portal et activez Linxo Connect comme décrit dans notre guide.
France
Intégration
Redirigez vos clients vers Linxo Connect via les modes d'intégration Hosted Checkout Page ou Server-to-server. Trouvez un aperçu général dans le chapitre "Cinématique".
Ajoutez les propriétés suivantes à une requête standard CreateHostedCheckout/CreatePayment :
{
"order":{
"amountOfMoney":{
"currencyCode":"EUR",
"amount":980
},
"customer":{
"merchantCustomerId":"your-customer-id",
"contactDetails":{
"emailAddress":"customer.email@address.com"
},
"locale":"fr_FR"
},
"references":{
"descriptor":"your-payment-description",
"merchantReference":"your-payment-reference"
}
},
"hostedCheckoutSpecificInput":{
"locale":"fr_FR"
},
"redirectPaymentMethodSpecificInput":{
"paymentProductId":5003,
"requiresApproval":false
}
}| Propriétés | Description |
|---|---|
|
order.amountOfMoney |
amount : Le montant brut que vous souhaitez facturer pour cette commande. |
|
customer |
merchantCustomerId : Un identifiant unique de votre client. Utilisé par Linxo Connect pour envoyer des notifications. emailAddress : L'adresse e-mail de vos clients. Utilisée par Linxo Connect pour envoyer des notifications. locale : Tout comme le Hosted Checkout Page, Linxo Connect est disponible en plusieurs langues. Remplissez-le en conséquence pour afficher le portail Linxo Connect dans la langue de votre choix client. La valeur est une combinaison de ISO 639-1 (langue) et ISO 3166-1 (pays) :
|
|
references |
descriptor : Un descripteur dynamique apparaissant sur le relevé bancaire de vos clients. merchantReference : Votre référence unique pour cette commande. |
|
hostedCheckoutSpecificInput.locale |
Notre Hosted Checkout Page est disponible en plusieurs langues. La valeur est une combinaison de ISO 639-1 (langue) et ISO 3166-1 (pays). Trouvez une liste de toutes les valeurs possibles dans notre guide Hosted Checkout Page. |
|
redirectPaymentMethodSpecificInput |
paymentProductId : L'identifiant numérique de la méthode de paiement sur notre plateforme. Trouvez cet id dans le chapitre "Aperçu". Pour les paiements demandés via CreateHostedCheckout, il informe notre plateforme d'envoyer directement vos clients à la version Linxo Connect de notre Hosted Checkout Page. Si omis, notre plateforme envoie vos clients au Hosted Checkout Page à la place, leur permettant ainsi de choisir cette méthode de paiement ou toute autre méthode active dans votre compte. requiresApproval : Réglez sur "false" car cette méthode de paiement permet uniquement le mode de Direct Sale. |
Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI.
Cinématique
Selon le(s) appareil(s) utilisé(s) par vos clients, des différences s'appliquent :
Avec un ordinateur de bureau et un appareil mobile
- Vos clients finalisent une commande sur leur appareil de bureau dans votre boutique et sélectionnent Linxo Connect.
- Vous envoyez cette requête CreateHostedCheckout/CreatePayment à notre plateforme.
- Vous redirigez vos clients sur l'appareil de bureau via le redirectUrl (Pour les requêtes CreateHostedCheckout) ou merchantAction.redirectData.redirectURL (Pour les requêtes CreatePayment) vers le portail Linxo Connect.
- Vos clients reçoivent une notification dans leur application bancaire sur l'appareil mobile pour confirmer la commande.
- Nous recevons le résultat de la transaction.
- Nous redirigeons vos clients vers votre returnUrl sur leur appareil de bureau.
- Vous demandez le résultat de la transaction à notre plateforme via GetPaymentDetails/GetHostedCheckout ou recevez le résultat via les webhooks.
- Si la transaction a réussi, vous pouvez livrer les marchandises / services.
Avec un appareil mobile
- Vos clients finalisent une commande sur leur appareil mobile dans votre boutique et sélectionnent Linxo Connect.
- Vous envoyez cette requête CreateHostedCheckout/CreatePayment à notre plateforme.
- Vous redirigez vos clients via le redirectUrl (Pour les requêtes CreateHostedCheckout) ou merchantAction.redirectData.redirectURL (Pour les requêtes CreatePayment) vers le portail Linxo Connect.
- Vos clients reçoivent une notification dans leur application bancaire pour confirmer la commande.
- Nous recevons le résultat de la transaction.
- Nous redirigeons vos clients vers votre returnUrl .
- Vous demandez le résultat de la transaction à notre plateforme via GetPaymentDetails/GetHostedCheckout ou recevez le résultat via les webhooks.
- Si la transaction a réussi, vous pouvez livrer les marchandises / services.
Test
Consultez nos Cas de test pour des données de test et des instructions détaillées.
Assurez-vous d'utiliser le bon endpoint et de renseigner l'URL de production dès que vous avez terminé vos tests.