Integration with a library
We will pay from 100 to 200 EUR for an accurate and working programming code. If you’d like to
cooperate in the future and receive orders for maintenance of a specific system version, the code and your
contact data will be published for open use.
Contact us via email to support@paysera.com
To integrate the system for MacroPayments we recommend to use our prepared open source library. Library performs all needful inspections of saveable, transmissible and receivable data.
Attention: libwebtopay is suitable to use with both MicroPayments and MacroPayments.
You are able to test libwebtopay in demo mode. To run demo version in your web browser address bar add:
https://www.yourwebsiteurl.com/libwebtopay/demo/
Attention: mentioned way to demo folder would be different in address, if you extracted archive in other place.
Attention: to try demonstration, indicate your project ID from paysera.com website in projectid field. Demonstration will not work if you try it from your computer (localhost).
How to integrate into your website?
In summary, it is enough to call for two methods. First one prepares data for sending, second one checks answer about committed payment.
Below you will find a working example. Locations where your Paysera access data has to be entered are marked with comments.
1. Create a folder.
Create a folder, name it libwebtopay. Here, all the files related to payment integration will be stored.
2. Download libwebtopay library.
Download WebToPay.php file to the libwebtopay folder created.
3. Create a file that directs users to Paysera website.
In the libwebtopay folder, CREATE redirect.php file. The content of this file could be as follows:
<?php
require_once('WebToPay.php');
function getSelfUrl(): string
{
$url = substr(strtolower($_SERVER['SERVER_PROTOCOL']), 0, strpos($_SERVER['SERVER_PROTOCOL'], '/'));
if (isset($_SERVER['HTTPS']) === true) {
$url .= ($_SERVER['HTTPS'] === 'on') ? 's' : '';
}
$url .= '://' . $_SERVER['HTTP_HOST'];
if (isset($_SERVER['SERVER_PORT']) === true && $_SERVER['SERVER_PORT'] !== '80') {
$url .= ':' . $_SERVER['SERVER_PORT'];
}
$url .= dirname($_SERVER['SCRIPT_NAME']);
return $url;
}
try {
WebToPay::redirectToPayment([
'projectid' => {YOUR_PROJECT_ID},
'sign_password' => {YOUR_PROJECT_PASSWORD},
'orderid' => 0,
'amount' => 1000,
'currency' => 'EUR',
'country' => 'LT',
'accepturl' => getSelfUrl() . '/accept.php',
'cancelurl' => getSelfUrl() . '/cancel.php',
'callbackurl' => getSelfUrl() . '/callback.php',
'test' => 0,
]);
} catch (Exception $exception) {
echo get_class($exception) . ':' . $exception->getMessage();
}
4. Create accept.php
In the libwebtopay folder, create accept.php file. The contents of the file have to be as follows:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
<title></title>
</head>
<body>
Thank you for buying.
</body>
</html>
5. Create cancel.php
In the libwebtopay folder, CREATE cancel.php file. The contents of the file have to be as follows:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
<title></title>
</head>
<body>
Payment canceled.
</body>
</html>
}
6. Processing of payments.
In the libwebtopay folder, create callback.php file. The contents of the file have to be as follows:
<?php
require_once('WebToPay.php');
function isPaymentValid(array $order, array $response): bool
{
if (array_key_exists('payamount', $response) === false) {
if ($order['amount'] !== $response['amount'] || $order['currency'] !== $response['currency']) {
throw new Exception('Wrong payment amount');
}
} else {
if ($order['amount'] !== $response['payamount'] || $order['currency'] !== $response['paycurrency']) {
throw new Exception('Wrong payment amount');
}
}
return true;
}
try {
$response = WebToPay::validateAndParseData(
$_REQUEST,
{YOUR_PROJECT_ID},
{YOUR_PROJECT_PASSWORD}
);
if ($response['status'] === '1' || $response['status'] === '3') {
//@ToDo: Validate payment amount and currency, example provided in isPaymentValid method.
//@ToDo: Validate order status by $response['orderid']. If it is not already approved, approve it.
echo 'OK';
} else {
throw new Exception('Payment was not successful');
}
} catch (Exception $exception) {
echo get_class($exception) . ':' . $exception->getMessage();
}
}
Attention! In GET method all paysera.com parameters have prefix WebToPay::PREFIX. Method WebToPay::checkResponse() returns all data without prefix. Illustration about that:
>>> $response = WebToPay::checkResponse(['foo' => 'bar', 'wp_projectid' => '123'], [...]); >>> print_r($response); ['projectid' => '123']
Request parameters
Seller should not rely on accepturl to confirm an order. Instead, order confirmation on the Seller side should be done per callbackurl.
Script must return text "OK". Only then our system will register, that information about the payment has been received.
If there is no answer "OK", the message will be sent 4 times (when we get it, after an hour, after three hours and after 24 hours).Payment for goods and services (for nb. [order_nr]) ([site_name]).
If you specify the payment purpose, it is necessary to include the following variables, which will be replaced with the appropriate values in the final purpose text:
[order_nr] - payment number.[site_name] or [owner_name] - website address or company name.
* Final length may vary depending on payment type specification
** Buyer consent text:
Callback
For more information on callbacks - see the chapter Callback .