VIPPS by DNB

Vipps is a Norwegian payment application designed for smartphones developed by DNB. Vipps was released May 30, 2015 and by reaching 1 million users November 5, 2015 - Vipps is Norways largest payment application. Although Vipps is developed by DNB it is an application open for customers from any Norwegian bank and 40% of the users are non-dnb customers.

source: Wikipedia

Prerequisities

In order to use VIPPS API you must apply for access to test environment. VIPPS expects you to deliver CSR file - Certificate Signing Request - (you can read more about the procedure on API documentation pages) and they will provide back signed certificate for merchant. Procedure usually takes 5-7 days. It is necessary to have signed certificate in order to access API (get through DNB firewalls).

Next step is to generate .pem certificate which consists of .crt file delivered by DNB PKI Team and private .key file you have generated along with CSR request file:

$ cat ./vipps.crt ./vipps.key > ./vipps.pem

That's it. Add .pem cert to each request you make against VIPPS servers.

Quick start

Add VIPPS to your project with Composer.

$ composer require zaporylie/vipps:^0.4

Create payment

$httpClient = new Http\Adapter\Guzzle6\Client(new \GuzzleHttp\Client([
    // Add certificate.
    'cert' => $settings['cert'],
]));
$vipps = new \Vipps\Vipps($httpClient);
// Set Vipps client.
$vipps->setMerchantID($merchant_id)->setMerchantSerialNumber($merchant_serial_number)->setToken($merchant_token);
// Get payment resource.
$payment = $vipps->payments();
// Set Order ID.
$payment->setOrderID($unique_order_id);
// Get transaction status.
$payment->create($phone_number, $amount_in_ore, $callback);

In case of any error ::create() method will throw an exception.

Get payment details

$httpClient = new Http\Adapter\Guzzle6\Client(new \GuzzleHttp\Client([
    // Add certificate.
    'cert' => $settings['cert'],
]));
$vipps = new \Vipps\Vipps($httpClient);
// Set Vipps client.
$vipps->setMerchantID($merchant_id)->setMerchantSerialNumber($merchant_serial_number)->setToken($merchant_token);
// Get payment resource.
$payment = $vipps->payments();
// Set Order ID.
$payment->setOrderID($unique_order_id);
// Get transaction current status.
$status = $payment->getStatus();
// Get transaction details including capture/refund history.
$details = $payment->getDetails();

Using production server

$httpClient = new Http\Adapter\Guzzle6\Client(new \GuzzleHttp\Client([
    // Add certificate.
    'cert' => $settings['cert'],
]));
$vipps = new \Vipps\Vipps($httpClient, new \Vipps\Connection\Live());

Troubleshooting

Some OSX users may experience problem with .pem files (internal OSX issue). If you're having troubles with pem files you can try generate .p12 file instead:

$ openssl pkcs12 -export -in ./vipps.crt -inkey ./vipps.pem -out ./vipps.p12
// System will ask for custom password for the file.

source

Next create Guzzle client and add certificate:

$httpClient = new Http\Adapter\Guzzle6\Client(new \GuzzleHttp\Client([
    // Add certificate.
    'cert' => [
      __DIR__ . '/vipps.p12', // Path to .p12 file.
      'password', // Pasword to .p12 file
    ]
]));

From now you can use client as usual.

Stability

zaporylie/vipps package has pre-releases only as VIPPS API development has not been finalized just yet. As soon as DNB decide to release stable version of their API this package will get its first stable release too.

References

• API documentation
• Read more about VIPPS on Wikipedia

Author

• Jakub Piasecki jakub@nymedia.no for Ny Media AS nymedia.no