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.