Payment Initiation
Note: this tutorial is only dedicated to point out which API methods should be used in order to correctly implement our Mobile SDK. Full API docs can be found at docs.kevin.eu
We do support both authenticated and unauthenticated bank payments. Unauthenticated bank payments are easy to implement. However, the user will be asked to log in to his bank account each time he wants to make a payment.
Authenticated bank payments will skip login steps, but implementation requires an already authenticated bank account. Instructions on how to authenticate the user bank account can be found here:
$client = new Client($id, $secret, ['version' => '0.3', 'error' => 'array']);
$attrs = [
'Authorization' => 'account-bearer-token', // optional, will allow to skip login
'Redirect-URL' => 'https://your.callback.url', // must match SDK callback url
'Webhook-URL' => 'https://your.webhook.url', // optional, add if you want to track payment execution state
'description' => 'your-description',
'currencyCode' => 'EUR',
'amount' => '0.01',
'bankPaymentMethod' => [
'endToEndId' => '1',
'creditorName' => 'your-creditor-name',
'creditorAccount' => [
'iban' => 'your-creditor-iban',
],
],
];
$response = json_encode($client->payment()->initPayment($attrs));
Received payment id should be passed to the SDK when attempting to perform the payment. We do recommend providing a Webhook-URL parameter (or a header if used not in PHP library), because mobile SDK will treat payment as successful even if the returned status in will be returned as pending (which not always might result as successful).
The Mobile SDK also supports card payments.
$client = new Client($id, $secret, ['version' => '0.3', 'error' => 'array']);
$attrs = [
'Redirect-URL' => 'https://your.callback.url', // must match SDK callback url
'description' => 'your-description',
'currencyCode' => 'EUR',
'amount' => 0.01,
'cardPaymentMethod' => [],
];
$response = json_encode($client->payment()->initPayment($attrs));
Received payment id should be passed to the SDK when attempting to perform the payment.
Hybrid payments are the card payments that might redirect the user to the bank flow if the entered card number belongs to the bank, which is supported by kevin. This payment type could be used when it's unknown whether the user has an EU/EEA bank and when companies want to save on the card processing fees.
$client = new Client($id, $secret, ['version' => '0.3', 'error' => 'array']);
$attrs = [
'Redirect-URL' => 'https://your.callback.url', // must match SDK callback url
'Webhook-URL' => 'https://your.webhook.url', // optional, add if you want to track payment execution state
'description' => 'your-description',
'currencyCode' => 'EUR',
'amount' => 0.01,
'cardPaymentMethod' => [],
'bankPaymentMethod' => [
'endToEndId' => '1',
'creditorName' => 'your-creditor-name',
'creditorAccount' => [
'iban' => 'your-creditor-iban',
],
],
];
$response = json_encode($client->payment()->initPayment($attrs));
Received payment id should be passed to the SDK when attempting to perform the payment. We do recommend providing a Webhook-URL parameter (or a header if used not in PHP library), because mobile SDK will treat payment as successful even if the returned status in will be returned as pending (which not always might result as successful).
Last modified 1mo ago