Authorisation info

In case you need to get information on a particular authorisation, check if the charging token is still valid you can use our authorisation info API. To use authorisation info API you will have to make a GET request to https://api-jwt.fortumo.io/info/authorisations/{chargingToken} and include a JWT token in the Authorization header as described here.

The JWT token must include the following parameters:

Parameter Type Required Description
iss String Mandatory Merchant account id, provided by Fortumo, e.g. 27f883a72e93a62b916957df48a1ef52
charging_token String Mandatory A valid and verified customer identifying token, provided by Authorisations API and issued by Fortumo.
iat Long, Unix epoch Mandatory Issued at. Identifies the time at which the JWT was issued. Example: 1485256645
nbf Long, Unix epoch Mandatory Not before. Identifies the time before which the JWT must not be accepted for processing. Example: 1485256642
exp Long, Unix epoch Mandatory Expiration time. Identifies the expiration time after which the JWT must not be accepted for processing. Example: 1988326400

Response parameters correspond to parameters listed here.

1
2
3
4
5
6

GET info/authorisations/369e6e58-142f-43c0-8d49-66a640029165:6f719e04 HTTP/1.1
Host: api-jwt.fortumo.io
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6Ikp…………………Pc0oKDOVe-ELkR7Zap8

1
2
3
4
5
6
7
8

{
   "iss":"7936de6c9fe6905f340f1141475e7064",
   "exp":1988326400,
   "nbf":1485256642,
   "iat":1485256645,
   "charging_token":"369e6e58-142f-43c0-8d49-66a640029165:6f719e04"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

{
   "flow": {
       "he": {
           "url": "http://sandbox-ee-311695a1-he.fortumo.io/he?s=vSqaspMZS0pdKTaNez8ctFS9JCCAUu0uEUWd_8SI77ntwnZsJnoWs2bFMMhTRbkXGuPjgT3OO8EDPDjN1UuvkPqhOdpGjlrcFA3Lo3IaSN0cEIkN-gWXY-StxYSgfQZsmP1glmi-rOhX1oMqtxwRqQm7WaORIjlT2BG523_A9pcAqTz_YbHFG42aUJJ09v7vVMjkRxEdJ-PKzjNqhloyjydjke2xlDfePpVas2TtCAAv5c7Q0eCHPEbkHe_tUQqXb6RgwAp7H0R_GXZZAQg8AQ&r=lL4VuM9xR7uY8jeWxstXeA",
           "request_type": "GET"
       }
   },
   "charging_token": "369e6e58-142f-43c0-8d49-66a640029165:6f719e04",
   "authorisation_state": "verified",
   "merchant": "7936de6c9fe6905f340f1141475e7064",
   "operation_reference": "he-auth-434962b8-7b8d-4e62-9ba9-9915056d3d0c",
   "consumer_identity": "5182b4aa-8c1e-3fb8-999a-dd21906221d3",
   "channel": {
       "code": "sandbox-ee",
       "country": "EE"
   },
   "error": {},
   "timestamp": "2021-02-23T08:23:07.684Z",
   "metadata": {}
}

Help us improve our Merchants Portal. Was this article helpful?