menu

Payment API

What's on this page

Online Payments / Payment Features / Embedded Card Payments

Send Card payment from a PCI compliant environment

Suppose you are already collecting credit card data within your PCI compliant environment and want to process card payments in your shop.

  1. The customer is done shopping and proceeds to checkout

  2. You request their authentication or a new registration

  3. Once the authentication is complete, you present the customer with the possible payment methods.

  4. The customer chooses to pay using the card method

  5. You request their credit card data

  6. You create a new payment using the card method with all card details attached.

    Example request

    curl --basic --user apikey: -H "Content-Type: application/json" --data '{
  "amount": 9.99,
  "currency": "eur",
  "method": "card",
  "brand": "visa",
  "returnUrl": "http://shop/return?order=123456",
  "merchantOrderReference": "123456",
  "description": "Order 123456",
  "language": "eng",
  "details": {
    "pan": "4111111111111111",
    "expiryDate": "1121",
    "cardholderFirstName": "John",
    "cardholderLastName": "Doe",
    "cvc": "123"
  }
}' https://api.psp.ccv.eu/api/v1/payment

    Example response

    {
  "merchantOrderReference": "123456",
  "amount": 9.99,
  "brand": "visa",
  "returnUrl": "http://shop/return?order=123456",
  "language": "eng",
  "lastUpdate": 1450871414476,
  "payUrl": "https://onlinepayments.ccv.eu/card/payment.html?reference=C151223124734945CB87E191.0",
  "reference": "C151223124734945CB87E191.0",
  "created": 1450871254959,
  "currency": "eur",
  "method": "card",
  "type": "sale",
  "description": "Order 123456",
  "status": "pending"
}

  7. In order to have the payment completed, you’ll need to redirect your customer to the pay url (payUrl) as generated for the payment.

    If you choose to not use 3-D secure, you can skip this step and continue with step 10.

  8. Depending on your merchant configuration and the result of the 3D Secure for the card details, your customer will have to follow several steps to complete the payment.

  9. As a final result, we return the customer back to your shop. This return url (returnUrl) is provided by you when you initiated the request in step 6.

  10. From this point forward, you should follow step 10 and up like when handling a regular shop payment.

Benefits

  • You can implement your own payment page.