menu

Payment API

What's on this page

Online Payments / Payment Features / Payment Links

Payment Link

A CCV payment link allows you to create payments that a customer can complete at their on convenience and using their preferred payment method.

CCV provides this solution using the Landingpage payment method. One of the benefits of this payment method is the longer payment window compared to traditional payment methods like iDEAL or card payments. By default, a Landingpage payment is open for 2 months.

The Landingpage payment method also limit the available payment methods a customer can choose from. Or use a single payment method that automatically generates a payment once the payment link is opened by the customer.

More information on the Landingpage method can be found on the payment method page.

Example

Suppose you have a batch system that will generate a monthly invoice for your customers for the products or services you offered them. In order to get these paid, you’ll need to inform the customer with details of the payment.

  1. For each invoice, initiate a new payment using the landingpage method.

    Example request

    curl --basic --user apikey: -H "Content-Type: application/json" -H "User-Agent: Shop123456" --data '{  "amount" : 9.99,  "currency" : "eur",  "method" : "landingpage",  "returnUrl" : "http://shop/return?order=123456",  "merchantOrderReference" : "123456",  "description" : "Order 123456",  "language" : "eng" }' https://api.psp.ccv.eu/api/v1/payment

    Example response

    {
  "amount" : 9.99,
  "returnUrl" : "http://shop/return?order=123456",
  "language" : "eng",
  "lastUpdate" : 1450873342567,
  "payUrl" : "https://onlinepayments.ccv.eu/landingpage/payment.html?reference=L151223132222542CB87E192.0",
  "reference" : "L151223132222542CB87E192.0",
  "created" : 1450873342567,
  "type" : "sale",
  "currency" : "eur",
  "method" : "landingpage",
  "description" : "Order 123456",
  "status" : "pending"
}

  2. Link the payment with your invoice in your system and contact the customer by email. The email should contain all your required information including the pay url of the new payment.

  3. The customer will have a period of 20 days (including non-business days) to complete the payment. The period is configurable on a per-payment basis for landingpage payments.

  4. The customer opens the pay url and is presented with our payment method selection form.

    Payment Method Selection Form

  5. The customer selects their preferred payment method. Depending on the payment method, the customer is

    • redirected to the next step of the payment process
    • presented a form to provide the required details for that payment method

  6. Once the payment process is completed, CCV redirects the customer to the return url. This return url is provided by you when you initiated the request. An example could be a link to the invoice in your own customer facing web application.

Benefits

Using the payment solution, you’ll gain several benefits:

  • In case a payment attempt failed using one method, we allow the customer to try again using the same or another method. It is up to the customer to continue or cancel the payment.
  • You are no longer required to implement your own payment page.
  • All payments are processed in a PCI compliant environment.