kevin. Platform API
Search…
💰
Payments
Account linking
Bank account linking is a feature that allows clients to link their bank account to a mobile application or a website and pay for goods or services directly through their bank. In some countries, the account linking feature may not be available yet but you can always get in touch with us to double-check.
Bank account linking is the future | kevin.
1. Start authentication
Initiate user authentication by calling the
/auth endpoint with the Request-Id, Redirect-URL and payments scope. Service will return an authorizationLink.You need to specify the
accounts_basic scope if you want to bypass the account selection step as well. Please keep in mind that account information scopes are not enabled by default.PHP
cURL
The example below is written using kevin. PHP library. All other possible attributes and their explanations can be found in the official API documentation.
1
use Kevin\Client;
2
3
$clientId = 'my-client-id';
4
$clientSecret = 'my-client-secret';
5
$options = ['error' => 'array', 'version' => '0.3', 'lang' => 'en'];
6
7
$kevinClient = new Client($clientId, $clientSecret, $options);
8
9
$attr = [
10
'redirectPreferred' => 'false',
11
'scopes' => 'payments',
12
//...or 'scopes' => 'payments,accounts_basic',
13
'Request-Id' => 'your-guid',
14
'Redirect-URL' => 'https://redirect.kevin.eu/authorization.html'
15
];
16
17
$response = $kevinClient->auth()->authenticate($attr);
Copied!
1
curl --request POST \
2
--url https://api.kevin.eu/platform/v0.3/auth?redirectPreferred=false&scopes=payments \
3
--header 'Client-Id: my-client-id' \
4
--header 'Client-Secret: my-client-secret' \
5
--header 'Request-Id: your-guid' \
6
--header 'Redirect-URL: https://redirect.kevin.eu/authorization.html'
Copied!
2. Redirect user
Redirect user to
authorizationLink. After the successful authorization, the client will be redirected back to your Redirect-URL with the code, requestId and status=success query parameters. If authorization does not succeed, you will receive a requestId and a status=failure.Example:
https://redirect.kevin.eu/authorization.html?requestId=your-guid&code=my-authorization-code&status=success3. Exchange code for token
In order to receive a token, you must exchange your code by calling the
/auth/token endpoint. A token can then be used to create payments and skip the login part.PHP
cURL
The example below is written using kevin. PHP library. All other possible attributes and their explanations can be found in the official API documentation.
1
use Kevin\Client;
2
3
$clientId = 'my-client-id';
4
$clientSecret = 'my-client-secret';
5
$options = ['error' => 'array', 'version' => '0.3', 'lang' => 'en'];
6
7
$kevinClient = new Client($clientId, $clientSecret, $options);
8
9
$attr = ['code' => 'your-auth-code'];
10
// ...or $attr = 'your-auth-code';
11
12
$response = $kevinClient->auth()->receiveToken($attr);
Copied!
1
curl --request POST \
2
--url https://api.kevin.eu/platform/v0.3/auth/token \
3
--header 'Client-Id: my-client-id' \
4
--header 'Client-Secret: my-client-secret' \
5
--header 'Content-Type: application/json' \
6
--data '{
7
"grantType": "authorizationCode",
8
"code": "my-authorization-code"
9
}'
Copied!
When token expires, use your refresh token by calling the
/auth/token endpoint to get a new valid token.PHP
cURL
The example below is written using kevin. PHP library. All other possible attributes and their explanations can be found in the official API documentation.
1
use Kevin\Client;
2
3
$clientId = 'my-client-id';
4
$clientSecret = 'my-client-secret';
5
$options = ['error' => 'array', 'version' => '0.3', 'lang' => 'en'];
6
7
$kevinClient = new Client($clientId, $clientSecret, $options);
8
9
$attr = ['refreshToken' => 'your-refresh-token'];
10
// ...or $attr = 'your-refresh-token';
11
12
$response = $kevinClient->auth()->refreshToken($attr);
Copied!
1
curl --request POST \
2
--url https://api.kevin.eu/platform/v0.3/auth/token \
3
--header 'Client-Id: my-client-id' \
4
--header 'Client-Secret: my-client-secret' \
5
--header 'Content-Type: application/json' \
6
--data '{
7
"grantType": "refreshToken",
8
"refreshToken": "my-refresh-code"
9
}'
Copied!
4. Initiate payment
Initiate payment by calling the
/pis/payment endpoint with an Authorization header. You will receive a confirmLink. An access token will allow you to skip the login part.PHP
cURL
The example below is written using kevin. PHP library. All other possible attributes and their explanations can be found in the official API documentation.
1
use Kevin\Client;
2
3
$clientId = 'my-client-id';
4
$clientSecret = 'my-client-secret';
5
$options = ['error' => 'array', 'version' => '0.3', 'lang' => 'en'];
6
7
$kevinClient = new Client($clientId, $clientSecret, $options);
8
9
$attr = [
10
'Authorization' => 'your-bearer-token'
11
'Redirect-URL' => 'https://redirect.kevin.eu/payment.html',
12
'description' => 'Test',
13
'currencyCode' => 'EUR',
14
'amount' => '0.01',
15
'bankPaymentMethod' => [
16
'endToEndId' => '1',
17
'creditorName' => 'John Smith',
18
'creditorAccount' => [
19
'iban' => 'LT144010051005081586'
20
],
21
],
22
];
23
24
$response = $kevinClient->payment()->initPayment($attr);
Copied!
1
curl --request POST \
2
--url https://api.kevin.eu/platform/v0.3/pis/payment \
3
--header 'Client-Id: my-client-id' \
4
--header 'Client-Secret: my-client-secret' \
5
--header 'Authorization: Bearer my-bearer-token' \
6
--header 'Content-Type: application/json' \
7
--header 'Redirect-URL: https://redirect.kevin.eu/payment.html' \
8
--data '{
9
"amount": "0.01",
10
"currencyCode": "EUR",
11
"description": "Test",
12
"bankPaymentMethod": {
13
"creditorName": "John Doe",
14
"endToEndId": "1",
15
"creditorAccount": {
16
"iban": "LT144010051005081586"
17
}
18
}
19
}'makef
Copied!
Skip account selection part
If you want to skip the account selection part, you need to get the account list by calling the
/ais/accounts endpoint with an access token and providing one of the bank accounts in the payment initiation request.PHP
cURL
1
use Kevin\Client;
2
3
$clientId = 'my-client-id';
4
$clientSecret = 'my-client-secret';
5
$options = ['error' => 'array', 'version' => '0.3', 'lang' => 'en'];
6
7
$kevinClient = new Client($clientId, $clientSecret, $options);
8
9
$accessToken = 'your-bearer-token';
10
$attr = [
11
'Authorization' => $accessToken,
12
'PSU-IP-Address' => 'your-ip-address',
13
'PSU-User-Agent' => 'your-user-agent',
14
'PSU-IP-Port' => 'your-ip-port',
15
'PSU-Http-Method' => 'GET',
16
'PSU-Device-ID' => 'your-device-id',
17
];
18
19
$response = $kevinClient->account()->getAccountList($attr);
Copied!
1
curl --request GET \
2
--url https://api.kevin.eu/platform/v0.3/ais/accounts \
3
--header 'Client-Id: my-client-id' \
4
--header 'Client-Secret: my-client-secret' \
5
--header 'Authorization: Bearer my-bearer-token' \
6
--header 'PSU-IP-Address: your-ip-address' \
7
--header 'PSU-User-Agent: your-user-agent' \
8
--header 'PSU-IP-Port: your-ip-port' \
9
--header 'PSU-Http-Method: GET' \
10
--header 'PSU-Device-ID: your-device-id'
Copied!
If you want to get an account list, your token must have the
accounts_basic scope. Account information scopes are note enabled by default. You can check your project settings to see whether you have access.Last modified 11d ago