Doviz POS Integration

Please implement below items in your application.

PreviousSDK Integrations NextIn Car Pay Integration

Last updated 4 months ago

Doviz POS Integration

Please implement below items in your application.

1.Bank App Protocol

1.1 Sale

Add below datas and use them in your Doviz POS(Multi Currency) flow.

isDovizPOS : false: not Doviz Txn, true: Doviz Txn

currenyRate : Exchange Rate for currency. 4 bytes decimal. Ex: 1USD = 34,1234 is written as 341234

currencyUnit: Integer: This data is from MB currency Table and defines the unit scale for a particular currency used in exchange rate calculations. It specifies whether the exchange rate is based on 1 unit of the currency (like USD or EUR) or 100 units (like JPY).

Ex:

If the currencyUnit for JPY is 100, and the exchangeRate is21.1234 TL for JPY, it means 100 JPY = 21.1234 TL.
If the currencyUnit for USD is 1, and the exchangeRate is 35.1234 TL for USD, it means 1 USD = 35.1234 TL.

currencyCode : Currency Code for Sale (TRY, USD, EUR, RUB, GBP, JPY)

currenyAmount : Integer: Ex: 1.25 TL is written 125

1.2 Parameter

Add DovizPOSAllowed into Allowed Operations as Parameter Action Response Data if Doviz POS(Multi Currency) supported. Also provide the Supported Currencies so that the user can select only the supported currency of the banks.

Allowed Operations

Allowed Operations will be added with the "AllowedOperations" tag. The allowed transactions will be added as JSON Object, whether the terminal allows payment with QR or not and whether it allows Key In transactions. It will be indicated with “1” if the operation is allowed, “0” if not.

Allowed Operations Bundle Example

AllowedOperations={"QrAllowed":1,"KeyInAllowed":0, "DovizPOSAllowed":1}

Supported Currencies

Supported Currencies will be added with the "SupportedCurrencies" tag and shared as a String Array.

Supported Currencies Bundle Example

SupportedCurrencies=[USD, EUR, GBP, JPY, RUB]
// USD = US Dollar
// EUR = Euro
// GBP = British Pound
// JPY = Japanese Yen
// RUB = Russian Ruble

2.Card Service

currencySymbol: The ISO 4217 currency numeric code to show currency symbol on cardService screens. Ex:949 for TRY, 840 for USD.

Note: currencySymbol should be set for getCard and getOnlinePINEx.

forceICCTermCurrencyCode: For ICC transactions, temporarily set currencySymbol to 5F2A.

3.Example Videos

1.Currency Settings

2.Sale Flow

4. UI Components

new uicomponent.aar library added to use Currency for Amount input.