POST rates

This operation retrieves exchange rates for all supported currencies, for informational purpose (e.g. for merchant to publish to their customers).

Request Information

URI Parameters

None.

Body Parameters

ExchangeRatesRequest
NameDescriptionTypeAdditional information
deviceId

Device ID
This ID uniquely identify a front-end device/terminal.This can be obtained from activateDCC operation(if applicable).
If this is provided, acquirerId, merchantId and terminalId will be ignored.
If this is absent, acquirerId, merchantId and terminalId must exist.

string

None.

acquirerId

Acquirer ID
See description for deviceId.

string

Range: inclusive between 1 and 99999999999

merchantId

Merchant ID
See description for deviceId.

string

String length: inclusive between 0 and 35

terminalId

Terminal ID
See description for deviceId.

string

String length: inclusive between 0 and 16

localDatetime

Local Transaction Datetime in ISO8601 format with timezone

string

Required

Request Formats

application/json, text/json

Sample:
{
  "deviceId": "sample string 1",
  "acquirerId": "sample string 2",
  "merchantId": "sample string 3",
  "terminalId": "sample string 4",
  "localDatetime": "sample string 5"
}

Response Information

Resource Description

ExchangeRatesResponse
NameDescriptionTypeAdditional information
result

Possible codes: "0000", "6999", "6000", "6001", "6002", "6003", "6004", "6005", "6100"

Result

None.

rrrId

Rate Request Reference ID

string

None.

baseAmount

Base Amount

Amount

None.

rates

Exchange rate information

Collection of Rate

None.

Response Formats

application/json, text/json

Sample:
{
  "result": {
    "code": "sample string 1",
    "description": "sample string 2"
  },
  "rrrId": "sample string 1",
  "baseAmount": {
    "value": "sample string 1",
    "fee": "sample string 2",
    "currency": {
      "code": "sample string 1",
      "numericCode": "sample string 2",
      "symbol": "sample string 3",
      "minorUnit": 4,
      "displayUnit": 5
    }
  },
  "rates": [
    {
      "type": "sample string 1",
      "currency": {
        "code": "sample string 1",
        "numericCode": "sample string 2",
        "symbol": "sample string 3",
        "minorUnit": 4,
        "displayUnit": 5
      },
      "value": "sample string 2",
      "direct": "sample string 3",
      "inverted": "sample string 4",
      "markup": "sample string 5",
      "diffOverECB": "sample string 6",
      "markupOverECB": "sample string 7",
      "fcmid": "sample string 8",
      "fctid": "sample string 9"
    },
    {
      "type": "sample string 1",
      "currency": {
        "code": "sample string 1",
        "numericCode": "sample string 2",
        "symbol": "sample string 3",
        "minorUnit": 4,
        "displayUnit": 5
      },
      "value": "sample string 2",
      "direct": "sample string 3",
      "inverted": "sample string 4",
      "markup": "sample string 5",
      "diffOverECB": "sample string 6",
      "markupOverECB": "sample string 7",
      "fcmid": "sample string 8",
      "fctid": "sample string 9"
    }
  ]
}