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

Device Transaction

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
    }
}