menu

Payment API

What's on this page

Online Payments / Payment Features / Merchant Initiated Payments

Doing a payment via the Vault

In this scenario the user will enter their card details via the Vault. After that the merchant performs a authorise using the Vault Access Token with a preliminary amount. After the successful authorise, the merchant completes the payment using a capture.

Obtaining Vault Access Token

  1. The customer indicates he wants to store their card details in the Vault.

  2. The merchant initiates a vault transaction using the API.

    Example request

    curl --basic --user apikey: -H "Content-Type: application/json" --data '{
    "dataType": "card",
    "returnUrl": "http://shop/return?order=123456",
    "language": "eng",
    "description": "Enter card details for use in MyService",
    "merchantOrderReference": "123456",
    "returnUrl": "https://shop/return?order=123456",
    "webhookUrl": "https://shop/hook?order=123456"
}' https://api.psp.ccv.eu/api/v1/vault/initiate

  3. We will validate the request and send a pending vault transaction as response: Example response

    {
  "merchantOrderReference" : "123456",
  "returnUrl" : "https://shop/return?order=123456",
  "webhookUrl": "https://shop/hook?order=123456",
  "language" : "eng",
  "lastUpdate" : 1450871254946,
  "payUrl" : "https://onlinepayments.ccv.eu/vault/card.html?reference=C151223124734945CB87E191.0",
  "reference" : "V170802142051429CB87E199.2",
  "created" : 1450871254946,
  "method" : "vault",
  "type" : "token",
  "description": "Enter card details for use in MyService",
  "status" : "pending"
}

  4. In order to have the card data entered, you will have to redirect the customer to the payUrl as generated for this transaction.

  5. The customer will be presented with a card form and be requested to fill in their card details.

  6. When the customer submits, we will process that Card details and store them in the Vault. We will then redirect the customer to the returnUrl and call the webhookUrl.

  7. Then you can check the status of the transaction and the Vault Access Token:

    Example request

    curl --basic --user apikey: https://api.psp.ccv.eu/api/v1/transaction?reference=V170802142051429CB87E199.2

    Example response

    {
  "merchantOrderReference" : "123456",
  "returnUrl" : "http://shop/return?order=123456",
  "webhookUrl": "https://shop/hook?order=123456",
  "language" : "eng",
  "lastUpdate" : 1450871414476,
  "payUrl" : "https://onlinepayments.ccv.eu/vault/card.html?reference=V170802142051429CB87E199.2",
  "reference" : "V170802142051429CB87E199.2",
  "created" : 1450871254959,
  "method" : "vault",
  "type" : "token",
  "description" : "Enter card details for use in MyService",
  "status" : "success",
  "details" : {
    "dataType" : "card",
    "expirationDuration" : "P0Y2M1DT0H0M0.000S",
    "expirationTimestamp" : 1457871414476,
    "vaultAccessToken" : "5C810B0AD0B1BC0926EBEA53",
    "brand" : "mastercard",
    "maskedPan" : "XXXXXXXXXXXXX4227"
  }
}

  8. As a side effect of completing a payment (successfully or not), we will notify you using a webhook. This allows you to perform additional operations in your system like sending an email to your customer.