Chèque-Vacances Connect

Countries & currencies

Supported countries

• France

Supported currencies

• Euro (EUR)

Integration

Redirect your customers to the CV Connect portal via integration methods Hosted Checkout Page or Server-to-server. Find a high level overview in the "Process flows" tab.

Add the following properties to a standard CreateHostedCheckout/CreatePayment request:

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

Process flows

Depending on your customers' device(s) used, differences apply:

• With a desktop and a mobile device
• With a mobile device

With a desktop and a mobile device

1. Your customers finalise an order in your shop and select CV Connect.
2. You send this CreateHostedCheckout/CreatePayment request to our platform. request to our platform. Depending on the integration method, differences apply:
   a) CreateHostedCheckout: You redirect your customers device via the redirectUrl to our Hosted Checkout Page. Your customers confirm the payment by clicking on the "Pay Securely".
   b) CreatePayment: The flow continues at 3).
3. The mobile device opens the CV Connect app. Your customers confirm the payment in the app.
   3'(optional). If there is a remaining amount to be paid, your customers pay the remaining amount in the CV Connect app.
4. We receive the transaction result.
5. The mobile device displays the transaction result in the CV Connect app. We redirect your customers to your returnUrl on their desktop device.
6. You request the transaction result from our platform via GetHostedCheckout/GetPaymentDetails or receive the result via webhooks.
7. If the transaction was successful, you can deliver the goods / services.

With a mobile device

1. Your customers finalise an order in your shop and select CV Connect.
2. You send this CreateHostedCheckout/CreatePayment request to our platform. Depending on the integration method, differences apply:
   a) CreateHostedCheckout: You redirect your customers device via the redirectUrl to our Hosted Checkout Page. Your customers confirm the payment by clicking on the "Pay Securely”.
   b) CreatePayment: The flow continues at 3).
3. The mobile device opens the CV Connect app. Your customers confirm the payment in the app.
   3'(optional). If there is a remaining amount to be paid, your customers pay the remaining amount in the CV Connect app.
4. We receive the transaction result.
5. The app displays the transaction result.
6. You request the transaction result from our platform via GetHostedCheckout/GetPaymentDetails or receive the result webhooks.
7. If the transaction was successful, you can deliver the goods / service.

Testing

Refer to our Test cases for test data and detailed instructions.

Additional information

Split payments

Our platform supports the CV Connect "Split payments” feature, allowing your customers to split the amount to be paid between CV Connect vouchers and credit card payment methods (Visa, MasterCard and Cartes Bancaires).
This feature is activated by default in your account and automatically rolled out when applicable, greatly easing CV Connect transaction management and reconciliation.

Amount blocking

By default, your customers can adapt the amount to be paid with CV Connect vouchers in their app. However, you can block this feature by adding property redirectPaymentMethodSpecificInput.paymentProduct5412SpecificInput.adjustablAmount to the CreateHostedCheckout/CreatePayment request. Set it to either "true"/"false" to (not) allow your customers to change the amount to be paid with vouchers.

Refund processing

When processing refunds for CV Connect transactions, keep the following in mind:

Refund availability depends on the payment methods selected for the payment. Not all payment methods support refunds.
If a payment has been split between CV Connect vouchers and card payment methods, our platform will first refund the amount paid by card.

If the refund amount exceeds the card payment share, CV Connect vouchers will be refunded. Our platform applies this principle for both one-time partial and multiple refunds.

CV Connect refunds are only possible within 4 hours after the payment is made!