GET /v1.1/online-payments/payment-requests/
Request headers
Attribute |
Type |
Condition |
Description |
X-Request-ID |
UUID |
Mandatory |
ID of the request, unique to the call. |
Authorization |
String |
Mandatory |
The oAuth2 Bearer token |
API-Key |
String |
Mandatory |
The Client ID obtained from the myPOS Account |
Query parameters
Attribute |
Type |
Condition |
Description |
page |
Number |
Optional |
The page with transactions to be returned. Default is 1. |
size |
Number |
Optional |
The number of returned requests. Possible values are 1÷100. Default value is 8. |
status |
Number |
Optional |
|
code |
String |
Optional |
The code of a sent payment request. |
from_amount |
Decimal |
Optional |
The minimum amount of a payment request for which to return as a valid entry. |
to_amount |
Decimal |
Optional |
The maximum amount of a payment request for which to return as a valid entry. |
currency |
String |
Optional |
The currency in which requests were sent. The default value is EUR. |
from_date |
String |
Optional |
The starting date from which a payment request was sent to return valid entries. |
to_date |
String |
Optional |
The last date from which a payment request was sent to return valid entries. |
client_name |
String |
Optional |
The name of the client to whom a payment request was sent. |
reason |
String |
Optional |
The reason typed in a sent payment request. |
booking_text |
String |
Optional |
The booking text typed in a sent payment request. |
Response headers
Attribute |
Type |
Condition |
Description |
X-Request-ID |
UUID |
Mandatory |
ID of the request, unique to the call. |
Content-Type |
String |
Mandatory |
application/json |
Response body
Attribute |
Type |
Condition |
Description |
items |
Mandatory |
A list of payment requests. |
|
pagination |
Mandatory |
Information about the paginated results. |
Examples
curl --location --request GET 'https://transactions-api.mypos.com/v1.1/online-payments/payment-requests?page=1&size=10&status=1&code=&from_amount=2&to_amount=100¤cy=EUR&from_date=2021-03-01&to_date=2021-04-01&client_name=&reason=&booking_text=' \
--header 'API-Key: MY_API_KEY' \
--header 'X-Request-ID: 232465ab-66ea-4776-b3f0-f7a123f988e4' \
--header 'Authorization: Bearer fTOPLnikHBzQb1u7eHvptz5fAe9V8ltn7k238sPRMs' \
--data-raw ''
import requests
url = "https://transactions-api.mypos.com/v1.1/online-payments/payment-requests?page=1&size=10&status=1&code=&from_amount=2&to_amount=100¤cy=EUR&from_date=2021-03-01&to_date=2021-04-01&client_name=&reason=&booking_text="
payload={}
headers = {
'API-Key': 'MY_API_KEY',
'X-Request-ID': '232465ab-66ea-4776-b3f0-f7a123f988e4',
'Authorization': 'Bearer fTOPLnikHBzQb1u7eHvptz5fAe9V8ltn7k238sPRMs'
}
response = requests.request("GET", url, headers=headers, data=payload)
var request = require('request');
var options = {
'method': 'GET',
'url': 'https://transactions-api.mypos.com/v1.1/online-payments/payment-requests?page=1&size=10&status=1&code=&from_amount=2&to_amount=100¤cy=EUR&from_date=2021-03-01&to_date=2021-04-01&client_name=&reason=&booking_text=',
'headers': {
'API-Key': 'MY_API_KEY',
'X-Request-ID': '232465ab-66ea-4776-b3f0-f7a123f988e4',
'Authorization': 'Bearer fTOPLnikHBzQb1u7eHvptz5fAe9V8ltn7k238sPRMs'
}
};
request(options, function (error, response) {
});
<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://transactions-api.mypos.com/v1.1/online-payments/payment-requests?page=1&size=10&status=1&code=&from_amount=2&to_amount=100¤cy=EUR&from_date=2021-03-01&to_date=2021-04-01&client_name=&reason=&booking_text=');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
'follow_redirects' => TRUE
));
$request->setHeader(array(
'API-Key' => 'MY_API_KEY',
'X-Request-ID' => '232465ab-66ea-4776-b3f0-f7a123f988e4',
'Authorization' => 'Bearer fTOPLnikHBzQb1u7eHvptz5fAe9V8ltn7k238sPRMs'
));
$request->setBody('');
try {
$response = $request->send();
if ($response->getStatus() == 200) {
echo $response->getBody();
}
else {
echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
$response->getReasonPhrase();
}
}
catch(HTTP_Request2_Exception $e) {
echo 'Error: ' . $e->getMessage();
}
{
"pagination": {
"page_size": 10,
"page": 1,
"total": 10
},
"items": [
{
"code": "BDQKP6JD5VDX77",
"url": "https://mypos.eu/en/qr-pr/BDQKP6JD5VDX77",
"added_on": "2021-03-17 16:00:36",
"client_name": "",
"amount": 3.14,
"currency": "EUR",
"reason": "",
"booking_text": "",
"status": 1
},
...
]
}