Contenu
Voir aussi
Comment configurer votre compte ?
Vous devez vous rapprocher de votre responsable de compte pour obtenir les informations nécessaires permettant de configurer votre compte sur Payline (contrat et le nom de la banque).
Ensuite veuillez adresser un email à notre équipe support@payline.com avec les informations, afin qu'ils puissent procéder au paramétrage dans votre compte marchand Payline en indiquant l’ID Marchand et le nom de l’alias du contrat partenaire à créer.
Vous devez réaliser des transactions 'pilote' pour valider le bon fonctionnement en production.
Dans le Centre administration de Payline, lors de la création du moyen de paiement, les champs à configurer sont les numéros de contrats Visa et Mastercard.
Comment proposer le paiement Samsung Pay à vos clients ?
Les principes d’utilisation
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.
Les web services en mode Web
Interfaces de paiement : API WebPayment, Cente d'administration.
Paiement à la commande : en utilisant le service doWebPayment avec payment.mode à CPT et code Action à 101.
- Paiement à l'expédition : en utilisant les services doWebPayment et doCapture avec le code Mode à CPT et code Action à 100.
- Mode de paiement : comptant, différé, avec le code Mode = CPT et DIF.
- Paiement par portefeuille électronique : avec IDWallet de la demande de paiement doWebPayment, service de gestion manageWebWallet et de paiement par portefeuille doImmediateWaletPayment.
- Paiement en différé : en utilisant les services doAuthorization et doCapture avec le code Mode à DIF et le code Action à 100.
- Demande d'annulation d'une autorisation non encaissée : utilisez la fonction doReset permet au marchand de demander l’annulation totale ou partielle de la commande.
- Demande de remboursement d'une transaction remisée : utilisez la fonction doRefund pour rembourser la commande.
- Paiement en N fois ou récurrent : en utilisant le service manageWebWallet et en fonction du besoin, alors utilisez un des services doImmediateWalletPayment, doScheduledWalletPayment,
doRecurrentWalletPayment. - La demande de crédit avec le service doCredit.
- La demande de réautorisation avec le service doReauthorization.
- Module fraude : règles sur la transaction, l'acheteur et sur le moyen de paiement. ( en attente de test )
Les web services en mode Direct
Le mode d'intégration en API direct est disponible en utilisant le webservice isRegistered. Ce service vous permet de récupérer le scoring data nécessaire pour appeler le moyen de paiement.
Vous récupérez un registrationToken à renvoyer dans la demande de 3D Secure verifyEnrollment puis dans la demande de paiement doAuthorization.
En entrée le commerçant indique le contrat, le montant, commande et les données personnelles.
En retour, il reçoit un l'échéancier de paiement dont les frais de dossier et le registrationToken qui permettra de réaliser le paiement.
Les champs obligatoires
Les champs obligtoires doivent être renseignés lors de la demande de paiement, dans le cas contraire la demande sera refusée. ici ?
| Nom du champ | Type |
|---|---|
Id transaction | Libellé |
Numéro de carte | PAN masqué |
| Date d’expiration | Date |
| Montant | Montant avec code devise |
Comment réaliser des tests ?
Il vous faut obtenir une carte de test auprès ....
Les codes de retour
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)
Ils sont associés aux PaymentResponse ou aux FailureCause renvoyées par le moyen de paiement ou aux ApmError renvoyées par le moteur APM:
| Type | Nom | Code Payline | ShortMessage | LongMessage | Cas d'usage |
|---|---|---|---|---|---|
| General | A CRÉER | 02500 | ACCEPTED | Operation Successfull | La demande (autre qu'une transaction) est acceptée (ex.: récupération des informations de l'acheteur). |
| PaymentResponse | Success | 00000 | ACCEPTED | Transaction Successfull | La demande de transaction est acceptée. |
| Failure | cf. FailureCause | N/A | N/A | La demande de transaction a échoué. | |
| OnHold | cf. OnHoldCause | N/A | N/A | La demande de transaction est en cours de traitement chez le partenaire. | |
| FailureCause | CANCEL | 02008 | CANCELLED | Transaction canceled by user | |
| REFUSED | 02020 | REFUSED | Transaction refused by partner | ||
| INTERNAL_ERROR | 02101 | ERROR | System internal error (frontend) | ||
| COMMUNICATION_ERROR | 02102 | ERROR | Acquirer server communication error | ||
| SESSION_EXPIRED | 02324 | REFUSED | The session expired before the consumer has finished the transaction | ||
| PAYMENT_PARTNER_ERROR | 02106 | ERROR | Payment partner error | ||
| PARTNER_UNKNOWN_ERROR | 02012 | ERROR | Unmatched partner return code | ||
| INVALID_FIELD_FORMAT | 02305 | ERROR | Invalid field format | ||
| INVALID_DATA | 02308 | ERROR | Invalid value for | ||
| FRAUD_DETECTED | 02021 | REFUSED | Fraud detected by partner. Transaction refused. | ||
| OnHoldCause | RETRY_IN_PROGRESS | 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. |
| ONHOLD_PARTNER_IPN | 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. | |
| PAYMENT_IN_PROGRESS | 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 | |
| ApmError | A CRÉER | A CRÉER | ERROR | JAR not available in database | |
| RETURNCODE_FUNCTION_NOT_AVAILABLE | 02010 | ERROR | Requested function not available |