Terminal Initialization

To initialize a payment Terminal, send Terminal ID and Merchant ID to the following endpoint:

GET/Terminals/init/{id}

Authorization

oauth2

Path parameters

id*string

Query parameters

Header parameters

Response

200400401403500

Success

Body

text/plainapplication/jsontext/json

merchantMerchantResponse (object)

receivableCurrenciesnullable array of CurrencyResponse (object)

Request

JavaScriptCurlPython

const response = await fetch('/Terminals/init/{id}?merchantId=text', {
    method: 'GET',
    headers: {
      "api-version": "text"
    },
});
const data = await response.json();

Response

200400500

{
  "merchant": {
    "companyName": "text",
    "companyLogoPath": "text",
    "taxNumber": "text"
  },
  "receivableCurrencies": [
    {
      "code": "text",
      "name": "text",
      "symbol": "text",
      "imagePath": "text",
      "accentColor": "text",
      "networkCost": 0
    }
  ]
}

The response will contain the following:

• Merchant details

• Receivable Currencies (USD only until further notice)

Example API call using curl:

curl -X 'GET' \
  'https://api.qa.devs.beadpay.io/terminals/init/000000000000000000000000?merchantId=000000000000000000000000' \
  -H 'Authorization: Bearer {token}'