redocly logo API docs by Redocly

Issuer Initiated Host to Host - Common Data Configuration API (DCA) (v1.0)

Download OpenAPI specification:Download

Support: support@ifsf.org License: IFSF License

The Data Configuration Standard API provides Data for multiple uses.

DCA Connection

Version Interoperability, Logout, Heartbeat

List of software versions

List of software versions. Used for version interoperability.

Authorizations:
apikeyoauth2

Responses

Response samples

Content type
application/json
{
  • "statusReturn": {
    },
  • "softwareComponents": [
    ]
}

Heartbeat request

Post to initiate the application heartbeat

Authorizations:
apikeyoauth2
Request Body schema: application/json
applicationSender
required
string <= 100 characters

100 character description.

timestamp
required
string <date-time> [ 10 .. 30 ] characters
interfaceVersion
string <= 40 characters

40 character description.

Responses

Request samples

Content type
application/json
{
  • "applicationSender": "string",
  • "timestamp": "2019-08-24T14:15:22Z",
  • "interfaceVersion": "string"
}

Response samples

Content type
application/json
{
  • "timestamp": "2009-11-20T17:30:50",
  • "result": "success",
  • "error": "ERRCD_OK",
  • "message": "Operation completed successfully"
}

disconnection request

Delete to disconnect

Authorizations:
apikeyoauth2
header Parameters
openretailing-application-sender
required
string <= 100 characters

The controlling device identification

Responses

Response samples

Content type
application/json
{
  • "timestamp": "2009-11-20T17:30:50",
  • "result": "success",
  • "error": "ERRCD_OK",
  • "message": "Operation completed successfully"
}

Master Data

Shared merchant site information

List of sites information

Provides the site list with site information details (Name, ID, GeoLocation, etc). Allows to receive updated information only and/or filter by country.

Authorizations:
apikeyoauth2
query Parameters
string or string <= 2 characters ^[A-Z][A-Z]

country identification. If this parameter is not provided no filter will be in place

updateDate
required
string <date-time> [ 10 .. 30 ] characters

last update date of merchant site information

Responses

Response samples

Content type
application/json
{
  • "statusReturn": {
    },
  • "sites": [
    ]
}

List of POIs

Provides the list of available point of interaction identifiers for the customers at each site. This information includes list of pumps, QR codes, OPTs, POS Payment Terminals and every device with a fixed code identification (ie. not identified through STAC). Allows to receive updated information only and/or filter by country.

Authorizations:
apikeyoauth2
query Parameters
string or string <= 2 characters ^[A-Z][A-Z]

country identification. If this parameter is not provided no filter will be in place

updateDate
required
string <date-time> [ 10 .. 30 ] characters

last update date of merchant site information

Responses

Response samples

Content type
application/json
{
  • "statusReturn": {
    },
  • "POIs": [
    ]
}

List of Facilities

Provides the list of available facilities at the network (001:Mogas, 002:Diesel, 003:Shop, 004: Coffee, etc.). Used to define the list of valid facilities codes.

Authorizations:
apikeyoauth2

Responses

Response samples

Content type
application/json
{
  • "statusReturn": {
    },
  • "facilities": [
    ]
}

List of Site Facilities

Provides the list of available facilities at each site (Mogas, Diesel, Lubes, Shop, Coffee, Showers, etc.). Allows to receive updated information only and/or filter by country.

Authorizations:
apikeyoauth2
query Parameters
string or string <= 2 characters ^[A-Z][A-Z]

country identification. If this parameter is not provided no filter will be in place

updateDate
required
string <date-time> [ 10 .. 30 ] characters

last update date of merchant site information

Responses

Response samples

Content type
application/json
{
  • "statusReturn": {
    },
  • "siteFacilities": [
    ]
}

List of Products

Provides the list of available product codes at the merchant network.

Authorizations:
apikeyoauth2

Responses

Response samples

Content type
application/json
{
  • "statusReturn": {
    },
  • "products": [
    ]
}

Picture

Provides the picture

Authorizations:
apikeyoauth2
path Parameters
image_Name
required
string [ 10 .. 30 ] characters

image name

Responses

Response samples

Content type
application/json
{
  • "statusReturn": {
    },
  • "picture": {
    }
}