Error Code Description

Introduction

This section describes the problem detail types - fault codes and error messages for each type that are returned by OpenAPI when the system triggers an error. This information is important to know for troubleshooting or understanding the reason for the fault.

Errors are divided into two parts 4xx and 5xx. 4xx codes indicate that an error was caused by the user, whereas 5xx codes tell the client that the request was correct and the error originated from the target server-side.

For each error an HTTP response is returned carrying JSON problem details:

JSON

HTTP/1.1 403 Forbidden
   Content-Type: application/json
   Content-Language: en
	 
	{
	"status":403,
	"type": "https://developers.tbcbank.ge/docs/error-type-403",
	"title": "You do not have enough balance.",
	"detail": "Your current balance is 50, but that costs 60.",
	"instance": "/account/12345/msgs/abc"
	}

Problem detail fields are defined below.
*indicates mandatory fields

NAME	TYPE	DESCRIPTION
status*	number	The HTTP status code generated by the target server. More details about status codes [RFC7231], Section 6.
type*	string	A URI reference that identifies the problem type. When dereferenced, this specification provides human-readable documentation for the problem type. When this field is not present, its value is assumed to be "about:blank".
title	string	A short, human-readable summary of the problem type. Is mosly used for the localization purposes.
detail	string	A human-readable explanation specific to this occurrence of the problem.
instance	string	A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
systemCode	string	An internal reference code. Might be used when communicating with the TBC support team.