Autorisation et Direct Sale
Le cœur de votre solution d'intégration consiste à envoyer des demandes de paiement à notre plateforme. Ce faisant, vous pouvez les traiter dans deux modes d'autorisation différents : mode Authorisation ou mode Direct sale.
Êtes-vous en train de migrer de l'ancien système vers Direct et/ou utilisez-vous encore notre ancien Back Office ?
Gardez ceci à l'esprit :
- Le paramètre OPERATION du système ancien se traduit en propriétés Direct.
- Les paramètres spécifiques du Back Office (ne) sont (pas) pertinents pour le traitement des transactions Direct.
- e-Terminal/Pay-by-link traitent toujours les transactions en mode vente directe. Toutefois, l'utilisation de notre solution Pay-by-link via l'API PaymentLinks vous permet de définir le mode d'autorisation via des propriétés dédiées.
Mode d'autorisation
Le mode approprié dépend de vos besoins métier et/ou de vos préférences personnelles :
Mode | Effet |
---|---|
Authorisation |
Le réseau de carte/fournisseur de paiement bloquent uniquement le montant que vous souhaitez facturer pour la commande sur la carte/le compte bancaire de votre client. Les transactions réussies auront status="PENDING_CAPTURE" / statusOutput.statusCategory="PENDING_MERCHANT" / statusOutput.statusCode=5. Pour réellement recevoir le paiement, vous devez ensuite capturer cette autorisation dans un délai spécifique. La période de validité d'une autorisation dépend de divers facteurs :
|
Direct sale |
Le réseau de carte/fournisseur de paiement bloque et capture le montant que vous souhaitez facturer pour la commande sur la carte/le compte bancaire de votre client en un seul appel. Ainsi, la banque de votre client vous verse immédiatement le montant correspondant via votre établissement acquéreur. Les transactions réussies auront status="PENDING_CAPTURE" / statusOutput.statusCategory="PENDING_MERCHANT" / statusOutput.statusCode=9. Gardez à l'esprit que traiter des transactions en mode Direct sale ne signifie pas que vous recevez les fonds instantanément. L'intervalle entre une transaction atteignant le statut 9 et la réception des fonds dépend de divers facteurs :
|
Traiter les requêtes
Notre API implémente des propriétés spécifiques pour traiter les transactions en mode Authorisation/Direct sale. Ajoutez une des propriétés à vos requêtes CreatePayment (pour la méthode d'intégration Server-to-server)/CreateHostedCheckout (pour la méthode d'intégration Hosted Checkout Page):
Propriété | Remarques/ Valeurs possibles |
---|---|
cardPaymentMethodSpecificInput. mobilePaymentMethodSpecificInput. |
cardPaymentMethodSpecificInput.authorizationMode : Applicable aux paiements par carte (par exemple Visa). mobilePaymentMethodSpecificInput.authorizationMode : Applicable aux paiements mobiles (par exemple Google Pay).
|
redirectPaymentMethodSpecificInput. requiresApproval |
Si vous envoyez "FINAL_AUTHORIZATION"/ "PRE_AUTHORIZATION", assurez-vous ensuite de capturer le montant pour réellement percevoir le paiement. Applicable aux paiements non-cartes (par exemple Paypal).
Si vous envoyez "true", assurez-vous ensuite de capturer le montant pour réellement percevoir le paiement. |
- Gardez à l'esprit que l'usage d'un mode/type d'autorisation spécifique, la période de validité et la possibilité de capture partielle ou multiple dépendent de divers facteurs, tels que :
- Le mode de paiement/réseau de carte.
- L'établissement émetteur de votre client.
- La localisation et le type de votre entreprise.
- Votre contrat d'acquisition.
- Les propriétés applicables à votre requête dépendent de la méthode de paiement choisie. Consultez l'exemple JSON dans les chapitres "Intégration" de la documentation de la méthode de paiement concernée.