IBAN Service API
by adjara

IBAN Service API

Iban transfer with TBC and BOG
Description

Production base url: - https://api-gw.prod.iban.incognito.ge
Testing base url: - N/A




Integration requires singular auth proxy

Error codes
Option Description
ACCOUNT_NOT_FOUND Account wasn’t found with given AdjarabetId.
UNAUTHORIZED Authorisation Token is expired or Unauthorized.
WRONG_PARAMS The given params are not enough or is incorrect
NOT_ENOUGH_MONEY User has no balance.
WITHDRAWAL_FAILURE Error while Withdrawal
BI_DOWN BI service is down
TIMEOUT Service timeout
USER_BLOCKED User is blocked
TRANSACTION_NOT_FOUND Transaction with given ID is not found
SINGULAR_DOWN Singular service is down
INCORRECT_DATA_RECEIVED Data is incorrect
NOT_SUPPORTED_OR_INVALID_BANK Iban is neither TBC or BOG
IBAN_SERVER_DOWN Iban service is down
IBAN_NOT_FOUND Iban not found
USER_OR_IBAN_NOT_FOUND User or Iban not found
INVALID_SIGNATURE Singular Signature mismatch
ACCOUNT_BI_CHECK_FAILED BI check failed
TRANSACTION_ONE_TIME_LIMIT One time limit is reached
TRANSACTION_USER_DAILY_LIMIT User daily limit is reached
TRANSACTION_MIN_AMOUNT_LIMIT transaciton min amout limit
Iban transfer
POST /iban-transfer

Use this endpoint to initialize transfer with supported banks

If you are using TBC Transfer you may get status PENDING after that you should use status-check endpoint to get transaction result for this exact transfer or fetch Transaction List which will have updated statuses.

Request headers

AuthProxy-Headers
string required
Example:
553212

Request body

Object
iban
string required
Example:
GE83TB7832345061100022
amount
string required
Example:
amount is in tetri
abUserId
number
Example:
553212
saveIban
string
Example:
true
ibanName
string
Example:
myIban

Responses

200 OK
Body
Object
success
string
Example:
true
content
Object
status
string

SUCCESS, FAILURE, ROLLBACK

Example:
SUCCESS
transactionId
string
Example:
83387536-59bc-4089-80a8-36dcf37e4fb3
statusCode
string
Example:
0
400 Failure
Body
Object
success
string

false

errorCode
string

WITHDRAWAL_FAILURE

Transaction status
POST /status-check

Check transaction status for pending transactions

Request headers

AuthProxy-Headers
string optional

Request body

Object
transactionId
string
Example:
ea1d2b27-0c62-430f-b1ec-60c7af12a7b9

Responses

200 OK
Body
Object
transactionId
string
Example:
ea1d2b27-0c62-430f-b1ec-60c7af9ea7b9
status
string
Example:
SUCCESS
400 Transaction not found
Body
Object
success
string

false

errorCode
string

TRANSACTION_NOT_FOUND

User iban list
GET /user/iban/list

get list of ibans on adjarabet user id

Request headers

AuthProxy-Headers
string required

553212

Responses

200 OK
Body
Object
Example: 
[
            {
                "id": 33,
                "iban": "GE60BG0000000101073342",
                "createdUtc": "2021-06-29T07:04:52.456Z",
                "updatedUtc": "2021-06-29T07:04:52.456Z"
            },
            {
                "id": 37,
                "iban": "GE10BG0000000887027800",
                "createdUtc": "2021-07-21T05:53:43.064Z",
                "updatedUtc": "2021-07-21T05:53:43.064Z"
            }
]
401 Unauthorized

Unauthorized

400 User not found

User with given abuserId not found

Body
Object
success
boolean
errorCode
string
Example:
USER_NOT_FOUND
Update Iban name
POST /user/iban/update

updates iban name

Request headers

AuthProxy-Headers
string optional

Request body

Object
iban
string required
Example:
GE89TB734552222600029
name
string required
Example:
My card

Responses

200 OK
Body
Object
success
string
Example:
true
401 Unauthorized
Body
Object
success
string

false

errorCode
string

UNAUTHORIZED

400 Bad Request

if iban is not found

Body
Object
success
string
Example:
false
errorCode
string
Example:
IBAN_NOT_FOUND
Delete user iban
POST /user/iban/delete

Deletes user iban

Request parameters

Iban
string required

GE89TB734554506360

Request headers

AuthProxy-Headers
string required
Example:
553212

Responses

200 OK
Body
Object
success
boolean
Example:
true
400 Bad Request
Body
Object
success
boolean
Example:
false
errorCode
string
Example:
USER_OR_IBAN_NOT_FOUND