GET /v1/devices/transactions
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 |
size |
Number |
Optional |
The number of returned transactions transactions. Possible values are 1÷100. Default value is 20. |
Request body
Attribute |
Type |
Condition |
Description |
from_date |
String |
Optional |
Starting date of the transaction list in format "YYYY-MM-DD". |
to_date |
String |
Optional |
End date of the transaction list, default is “today” if not given. Format is "YYYY-MM-DD". |
from_amount |
Double |
Optional |
The minimum amount of a transactions. |
to_amount |
Double |
Optional |
The maximum amount of a transactions. |
rrn |
String |
Optional |
A filter by RRN value. |
stan |
String |
Optional |
Filter by stan value. |
terminal_name |
String |
Optional |
Filter by custom POS device name. |
reference_number |
String |
Optional |
The reference number of a transaction. Can be filtered by custom client reference. |
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 |
transactions |
List of |
Mandatory |
A list of device transaction objects. |
reference_number |
Inv12345 |
Optional |
Up to 50 symbols of text (Latin characters only) - can include letters, numbers, spaces and special characters. |
Examples
curl -X GET \ https://devices-api.mypos.com/v1/devices/90005826/transactions \ -H 'Authorization: Bearer PLpC1CqVE9CYXolbGNBPqz0NYy8asFzG95XcToDsMP' \ -H 'Content-Type: application/json' \ -H 'X-Request-ID: 232465ab-66ea-4776-b3f0-f7a123f988e4' \ -d '{}'
import requests requests.request( 'GET', url='https://devices-api.mypos.com/v1/devices/90005826/transactions', data=dict(), headers={ 'Authorization': 'Bearer PLpC1CqVE9CYXolbGNBPqz0NYy8asFzG95XcToDsMP', 'Content-Type': 'application/json', 'X-Request-ID': '232465ab-66ea-4776-b3f0-f7a123f988e4' } )
const request = require("request"); const options = { method: 'GET', url: 'https://devices-api.mypos.com/v1/devices/90005826/transactions', body: {}, json: true, headers: { 'Authorization': 'Bearer PLpC1CqVE9CYXolbGNBPqz0NYy8asFzG95XcToDsMP', 'Content-Type': 'application/json', 'X-Request-ID': '232465ab-66ea-4776-b3f0-f7a123f988e4' } }; request(options, (error, response, body) => { });
<?php $request = new HttpRequest(); $request->setUrl('https://devices-api.mypos.com/v1/devices/90005826/transactions'); $request->setMethod(HTTP_METH_GET); $request->setHeaders(array( 'Authorization' => 'Bearer PLpC1CqVE9CYXolbGNBPqz0NYy8asFzG95XcToDsMP', 'Content-Type' => 'application/json', 'X-Request-ID' => '232465ab-66ea-4776-b3f0-f7a123f988e4' )); $request->setBody('{}'); try { $response = $request->send(); echo $response->getBody(); } catch (HttpException $ex) { echo $ex; }
{ "transactions": [ { "terminal_id": "90005826", "date": "2019-10-23 11:48:25", "terminal_name": "D20050667462", "outlet_name": "", "tran_type": "00", "tran_status": "Approved", "payment_status": "Paid", "amount": 15.0, "currency": "EUR", "rrn": "929608098708", "stan": "000016", "settlement_date": "2019-10-23 11:48:40", "settlement_amount": 3.0, "settlement_currency": "EUR", "fee": 0.02, "pan": "*2649", "processor": "I", "card_scheme": "Visa Classic", "payment_reference": "POSA00120076VGMO", "reference_number": "9483576" }, ], "pagination": { "page": 1, "size": 20, "total": 1 } }