Content
More information
You must contact your account manager to obtain the necessary information to configure your account on Payline (contract and name of the bank).
Then please send an email to our support team with the information, so that they can proceed with the settings in your Payline merchant account, indicating the Merchant ID and the name of the alias of the partner contract to be created.
You must carry out 'pilot' transactions to validate an operation in production.
In the Payline administration center, when creating the payment method, the fields to configure are the Visa and Mastercard contract numbers.
In Direct API or Merchant checkout integration: the merchant must retrieve his service ID (SID) from the Partner Portal and communicate the Certificate Signing Request (CSR) via this same channel. The merchant communicates the test / production IP addresses via the Partner Portal so that Samsung Pay can declare them in the system.
Pour mettre en place Samsung Pay sur Payline, vous devez créer un compte Samsung Pay dans SellerCentral et récupérer les informations ID Marchand, Jeton d'autorisation NWS et Identifiant Client nécessaires pour configurer votre contrat Payline.
Pour créer un compte Samsung Pay veuillez vous reporter à la documentation Samsung Pay et suivre la procédure détaillée (API DirectPayment).
How to offer Samsung Pay to your customers ?
Une fois le moyen de paiement activé, il est utilisable au travers des fonctions standard Payline en indiquant le contrat du moyen de paiement Contrat_Number.
Le mode d'intégration est disponible avec l'API WebPayment : services doWebPayment et getWebPaymentDetails.
Le mode d'intégration avec l'API DirectPayment avec le service doAuthorization.
Une fois le moyen de paiement activé, il est utilisable au travers des fonctions standard Payline.
Il n’y a pas besoin d’interaction entre le commerçant et Samsung.
De même il n’y pas besoin de déclarer d’adresse IP du commerçant.
Interfaces de paiement : API WebPayment, Cente d'administration.
Paiement à la commande : en utilisant le service doWebPayment avec payment.mode à CPT et code Action à 101.
Le type de wallet
Les transactions OK sont flaggés sur le contrat CB associé avec un type de wallet Samsung Pay.
Les transactions KO sont flaggés soit :
Dans les 2 cas, vous pourrez observer que la balise transaction.externalWalletType contient la valeur SAMSUNG_PAY.
Les services disponibles : le service doAuthorization pour réaliser une demande de paiement.
En direct, le commerçant doit se référer à la documention Samsung Pay dans la catégorie « Samsung Pay Web Checkout ».
Les champs obligatoires doivent être renseignés lors de la demande de paiement, dans le cas contraire la demande sera refusée.
Nom du champ | Type |
---|---|
Id transaction | Libellé |
Numéro de carte | PAN masqué |
Date d’expiration | Date |
Montant | Montant avec code devise |
Devise | Devise du montant de la transaction |
Order.Ref | Limité à 36 caractères. Caractères autorisés: [A-Z][a-z][0-9,-] pas d'espace |
ReturnURL |
Samsung Galaxy S10, S10+ et S10e
Samsung Galaxy S9 et S9+
Samsung Galaxy S8 et S8+
Samsung Galaxy S7 et S7 Edge
Samsung Galaxy Note 8
Samsung Galaxy A8 2018
Samsung Galaxy A5 2017
Samsung Galaxy A6, A6+, A7, A8 et A9
2. Les applications fournies par SamsungPay doivent avoir été installées sur le téléphone en paramétrage d'usine et sans mise à jour, en conformité avec leur procédure d'installation.
En intégration API Web ou PG checkout : - Il n’y a pas besoin d’interaction entre le commerçant et Samsung En intégration API Direct ou Merchant checkout : - Le commerçant doit récupérer son service ID (SID) de la même manière que vous l’avez fait sur le Partner Portal et nous communiquer Certificate Signing Request (CSR) via ce même canal Guide d'installation des applications (suivre Staging) Application à installer sur le téléphone
Cette page résume la procédure : 3. Avoir les cartes de tests fournies par SamsungPay enregistrées dans le wallet. Les cartes fournies sont des cartes VISA uniquement : Exp Date : 12/22
4. PIN code de l'application SGP pour finaliser la transaction sur le téléphone: 1020 |
Avec l'API WebPayment, Payline vous informe du résultat d'un paiement via le ShortMessage des services getWebPaymentDetails.
Avec l'API DirectPayment, Payline vous informe du résultat de manière synchrone en réponse du service getTransactionDetails.
Lorsque le paiement est accepté, Payline renvoie le ShortMessage = ACCEPTED.
Pour un paiement refusé, le code varie en fonction du motif de refus (Par exemple : 04xxx pour une suspicion de fraude).
Les codes retour APM sont extraits des codes retour Payline Front: Return codes - Payline Front (02)
Les codes spécifiques :
Code Payline | ShortMessage | LongMessage | Cas d'usage |
---|---|---|---|
02500 | ACCEPTED | Operation Successfull | La demande (autre qu'une transaction) est acceptée (ex.: récupération des informations de l'acheteur). |
00000 | ACCEPTED | Transaction Successfull | La demande de transaction est acceptée. |
02008 | CANCELLED | Transaction canceled by user | |
02020 | REFUSED | Transaction refused by partner | |
02101 | ERROR | System internal error (frontend) | |
02102 | ERROR | Acquirer server communication error | |
02324 | REFUSED | The session expired before the consumer has finished the transaction | |
02106 | ERROR | Payment partner error | |
02012 | ERROR | Unmatched partner return code | |
02305 | ERROR | Invalid field format | |
02308 | ERROR | Invalid value for | |
02021 | REFUSED | Fraud detected by partner. Transaction refused. | |
02006 | ONHOLD_PARTNER | Retry in progress, please wait for payment status | La transaction s'est terminé dans un état non final (pending) suite à l'utilisation du champ TransactionTimeOut.Payline recevra une notification du MdP plus tard avec un état final. Cet état sera ajouté au status history de la transaction. |
02016 | ONHOLD_PARTNER | Transaction hold on partner, please wait for payment method return | La transaction s'est terminé dans un état non final (pending).Payline recevra une notification du MdP plus tard avec un état final. Cet état sera ajouté au status history de la transaction. |
02000 | ONHOLD_PARTNER | Transaction in progress, please wait for payment status | Le paiement est en cours.Une redirection a été faite chez le MdP.Le commerçant fait un getWebPaymentDetails alors que l'acheteur n'est pas encore revenu sur son site.OnHold / Redirect / ActiveWaiting |
02010 | ERROR | Requested function not available |