agricole
S'inscrire

Chèque-Vacances Connect

Chèque-Vacances Connect

Introduction

Chèque-Vacances Connect (CV Connect) est une solution de chèques dédiée aux activités de vacances, de loisirs et de sport proposée par l'ANCV.

CV Connect est la version entièrement digitale de cette solution, offrant à vos clients une application mobile pour utiliser leurs chèques digitaux.

CV Connect met également en œuvre la fonctionnalité de paiement fractionné, permettant à vos clients de répartir le montant entre les chèques CV Connect et les moyens de paiement par carte bancaire. Déployée automatiquement lorsque cela s'applique, cette fonctionnalité facilite les paiements complémentaires et la réconciliation.

L'intégration est très simple, car vous n'avez qu'à envoyer quelques paramètres supplémentaires avec votre requête.

Aperçu

Groupe de paiement :
Identifiant du moyen de paiement:
5412
Avantages clés
  • Exigences PCI réduites
  • Intégration simple
  • Paiement garanti
  • Paiements complémentaires via la fonctionnalité « Split payments » (y compris les remboursements)
  • Autorise les remboursements partiels/multiples pour les chèques CV Connect et les paiements complémentaires

Pays & devises

Pays pris en charge

Devises prises en charge

  • Euro (EUR)

Intégration

Redirigez vos clients vers le portail CV Connect via les modes d'intégration Hosted Checkout Page our Server-to-server. Vous trouverez une vue d'ensemble de haut niveau dans l'onglet "Cinématique".

Ajoutez les propriétés suivantes à une requête CreateHostedCheckout/CreatePayment standard :

{
  "hostedCheckoutSpecificInput":{
	"locale": "fr_FR"
  },
  "redirectPaymentMethodSpecificInput":{
    "paymentProductId": 5412,
    "paymentProduct5412SpecificInput": {
      "adjustableAmount": true,
      "beneficiaryId": "11111111111"
    },
    "returnUrl": "https://yourReturnUrl.com”,
    "requiresApproval": false
   },
  "order": {
    "amountOfMoney": {
      "currencyCode": "EUR",
      "amount": 140000
    }
  }
}
Properties Remarks

hostedCheckoutSpecificInput.locale

La version linguistique de notre Hosted Checkout Page, y compris le portail CV Connect.

redirectPaymentMethodSpecificInput
    paymentProductId
    paymentProduct5412SpecificInput
         adjustableAmount
         beneficiaryId
    returnUrl
    requiresApproval

paymentProductId: L'identifiant numérique du moyen de paiement sur notre plateforme. Vous trouverez cet id dans le chapitre "Aperçu". Pour les paiements demandés via  CreateHostedCheckout, il indique à notre plateforme d'envoyer vos clients directement vers le portail CV Connect. S'il est omis, notre plateforme enverra vos clients vers la Hosted Checkout Page à la place, leur permettant de choisir ce moyen de paiement ou tout autre moyen de paiement actif sur votre compte.

adjustableAmount: Définissez sur "true"/"false" pour (ne pas) autoriser vos clients à modifier le montant à payer en chèques.

beneficiaryId: L'identifiant unique de votre client (ANCV ID de l'acheteur) sur la plateforme CV Connect. Ajoutez le à la requête CreateHostedCheckout rpour préremplir la Hosted Checkout Page en conséquence. Obligatoire pour les requêtes CreatePayment/Server-to-server requests.  

returnUrl: L'URL vers laquelle nous redirigeons vos clients une fois le paiement finalisé.

requiresApproval: Définissez sur "true"/"false" selon que vous souhaitez traiter les paiements en mode autorisation ou en mode Direct sale
Obligatoire avec "false" pour les transactions traitées avec la fonctionnalité de paiement fractionné.

Assurez-vous de capturer les transactions autorisées ultérieurement. Ce n'est qu'à ce moment que la transaction aura status="CAPTURED" / statusOutput.statusCategory="COMPLETED" / statusOutput.statusCode=9, pour lesquels vous recevrez effectivement le paiement de la transaction.

order.amountOfMoney
     amount
     currencyCode

amount : Le montant brut que vous souhaitez facturer pour cette commande.
currencyCode : Le code de devise ISO 4217 pour ce montant.

Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI/CreatePaymentAPI.

Cinématique

Selon le(s) appareil(s) utilisé(s) par vos clients, des différences s'appliquent :

Avec un ordinateur de bureau et un appareil mobile

  1. Vos clients finalisent une commande sur leur ordinateur dans votre boutique et sélectionnent CV Connect.
  2. Vous envoyez cette requête CreateHostedCheckout/CreatePayment à notre plateforme. Selon le mode d'intégration, des différences s'appliquent :
    a) CreateHostedCheckout : vous redirigez vos clients sur l'ordinateur via la redirectUrl vers notre Hosted Checkout Page. Vos clients confirment le paiement en cliquant sur « Pay Securely ».
    b) CreatePayment: la cinématique reprend à l'étape 3).
  3. L'appareil mobile ouvre l'application CV Connect. Vos clients confirment le paiement dans l'application.
    3'(optionnel). S'il reste un montant à payer, vos clients paient le montant restant via un paiment complémentaire.
  4. Nous recevons le résultat de la transaction.
  5. L'appareil mobile affiche le résultat de la transaction. Nous redirigeons vos clients vers votre returnUrl sur leur ordinateur.
  6. Vous demandez le résultat de la transaction à notre plateforme GetHostedCheckout/GetPaymentDetails ou recevez le résultat via webhooks.
  7. Si la transaction a été effectuée avec succès, vous pouvez livrer les biens / le service.

Avec un appareil mobile

  1. Vos clients finalisent une commande dans votre boutique et sélectionnent CV Connect.
  2. Vous envoyez cette requête CreateHostedCheckout/CreatePayment à notre plateforme. Selon le mode d'intégration, des différences s'appliquent :
    a) CreateHostedCheckout: vous redirigez l'appareil de vos clients via la redirectUrl vers notre Hosted Checkout Page. Vos clients confirment le paiement en cliquant sur « Pay Securely ».
    b) CreatePayment: la cinématique reprend à l'étape 3).
  3. L'appareil mobile ouvre l'application CV Connect. Vos clients confirment le paiement dans l'application.
    3'(optionnel). S'il reste un montant à payer, vos clients paient le montant restant via un paiment complémentaire.
  4. Nous recevons le résultat de la transaction.
  5. L'application affiche le résultat de la transaction.
  6. Vous demandez le résultat de la transaction à notre plateforme via GetHostedCheckout/GetPaymentDetails ou recevez le résultat via webhooks.
  7. Si la transaction a été effectuée avec succès, vous pouvez livrer les biens / le service.
Customer Our platform Finalises order 1 Sends CreateHostedCheckout 
request 2 Redirects customer 6 Requests/Receives 
transaction result 7 Thunes Merchant Delivers goods/services 8 Not real-time Real-time Optional Pays remaining 
amount 4’ Is redirected to Cadhoc 
to confirm e-mail address 3 Receives transaction result 5 4 Confirms order 
in app

Test

Consultez nos Cas de test pour des données de test et des instructions détaillées.

Informations supplémentaires

Paiements fractionnés

Notre plateforme prend en charge la fonctionnalité « Split payments » de CV Connect, permettant à vos clients de répartir le montant à payer entre les chèques CV Connect et les moyens de paiement par carte bancaire (Visa, Mastercard et Cartes Bancaires).
Cette fonctionnalité est activée par défaut sur votre compte et automatiquement mise en œuvre lorsque cela s’applique, ce qui facilite grandement la gestion et la réconciliation des transactions CV Connect.

Blocage du montant

Par défaut, vos clients peuvent adapter dans leur application le montant à payer en chèques CV Connect. Cependant, vous pouvez bloquer cette fonctionnalité en ajoutant la propriété redirectPaymentMethodSpecificInput.paymentProduct5412SpecificInput.adjustablAmount à la requête CreateHostedCheckout/CreatePayment request. Définissez-la sur « true » / « false » pour (ne pas) autoriser vos clients à modifier le montant à payer en chèques.

Traitement des remboursements

Lors du traitement des remboursements pour des transactions CV Connect, gardez les points suivants à l'esprit :

La possibilité de rembourser dépend des moyens de paiement sélectionnés pour le paiement. Tous les moyens de paiement ne prennent pas en charge les remboursements.

Si un paiement a été réparti entre des chèques CV Connect et des moyens de paiement par carte, notre plateforme remboursera d'abord le montant payé par carte. Si le montant du remboursement dépasse la part payée par carte, les chèques CV Connect seront remboursés. Notre plateforme applique ce principe aussi bien pour les remboursements partiels uniques que pour les remboursements multiples.

Les remboursements CV Connect ne sont possibles que pendant les 4 heures après la réalisation du paiement !

Cette page vous a-t-elle été utile ?

Avez-vous des commentaires ?

Merci pour votre réponse.