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

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.

Add VIPPS to your project with Composer.

$ composer require zaporylie/vipps:^0.4

$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.

$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();

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

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.

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.

• API documentation
• Read more about VIPPS on Wikipedia

• Jakub Piasecki [email protected] for Ny Media AS nymedia.no