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.
Are you migrating from legacy to Direct and/or are you still using our legacy Back Office?
Mind that
- The legacy OPERATION parameter translates to Direct properties.
- Specific Back Office settings are (not) relevant for Direct transaction processing.
- e-Terminal/Pay-by-link always process transactions in direct sale mode. However, using our Pay-by-link solution via the PaymentLinks API does allow you define the authorisation mode via dedicated properties.
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.