{
    "openapi": "3.0.0",
    "info": {
        "title": "Antaca Api Admin Documentation",
        "description": "\n\nThis documentation describes the capabilities of ANTACA API related to\naccount maintenance and card issuing. </br>\n\n</br>\n</br>\nAntaca has been designed to meet the Mastercard requirements of the\nDigital First program, which contains guidelines for payment and e-banking applications to maintain the highest level of security, convenience\nof use in terms of accessibility and payment solutions from the level of the\ntelephone and other devices.\n</br>\nThe standard flow for user → registration → KYC application → automatic\naccount creation → automatic creation of a virtual card, after which he\ngets the possibility to fully manage his card, view its data or pay online\n\n##  Application Events\nEvents are on dedicated exchange, eg. quicko-prepaid-api\n| Routing            | Payload     |\n|--------------------|-------------|\n| thc_record.created | {\"id\\\":2958} |\n| cards.quantity.weekly | {\"from\":\"2023-11-13T00:00:00+00:00\",\"to\":\"2023-11-19T23:59:59+00:00\",\"virtual\":6,\"real\":1,\"total_quantity\":7} |\n|cards.quantity.monthly | {\"from\":\"2023-10-01T00:00:00+00:00\",\"to\":\"2023-10-31T23:59:59+00:00\",\"virtual\":6,\"real\":1,\"total_quantity\":7} |\n|                    |             |\n##  Idempotent Requests\nThe API supports idempotency for safely retrying requests without accidentally performing the same operation twice.\n</br>\nTo perform an idempotent request, provide an additional header to the request: `X-Idempotency-Key`: `uuid`\n</br>\nEach generated X-Idempotency-Key must be used only once. Do not reuse the same key for multiple requests—reusing may cause incorrect API behavior or request rejection.\n</br>\nIdempotency key is valid for 24h\n</br>\nEach next request return response identical to the first one that will be get from cache.\n\n## HTTP Headers\n\n### Request Headers\n\n| Header | Type | Description |\n|:-------|:-----|:------------|\n| `Application-Id` | String | Identifier of the application calling the API. |\n| `X-B3-TraceId` | String | Trace identifier for distributed logging (Zipkin/B3). |\n| `X-B3-SpanId` | String | Span identifier for distributed logging. |\n| `X-Idempotency-Key` | String | Key ensuring operation idempotency. Prevents re-processing of the same request. (POST/PATCH) |\n| `Encrypted-Request` | Boolean | Informs the API that the request body (payload) is encrypted in JWE format. |\n| `Encrypt-Response` | Boolean | Informs the API whether the response should be encrypted before sending. |\n| `Public-Key` | String | Client's public key (base64-encoded PEM) used by the API to encrypt the response. |\n| `Authorization` | String | Authorization header using Bearer token. |\n| `Accept-Language` | String | Preferred language for the response. |\n| `X-Unique-TransactionId` | Boolean | Flag determining specific behavior when retrieving transactions. |\n| `Content-Type` | String | Content type of the sent request. |\n| `Accept` | String | Specifies the response format. |\n\n### Response Headers\n\n| Header | Description |\n|:-------|:------------|\n| `X-B3-TraceId` | Returned trace identifier associated with the request. |\n| `X-B3-SpanId` | Returned span identifier associated with the request. |\n| `Access-Control-*` | CORS (Cross-Origin Resource Sharing) headers. |\n| `Content-Type` | Response content type (usually `application/json`). |\n",
        "version": "1.0.0"
    },
    "paths": {
        "/admin/balances/{balanceId}/limits": {
            "get": {
                "tags": [
                    "Admin - Balances"
                ],
                "summary": "Get all limits of a balance",
                "description": "Returns all not deleted limits of the balance, including expired limits.\n\n## Security\nROLE_READ_BALANCE_LIMIT is required to access this method.\nAdmins assigned to a corporation can only manage limits on balances belonging to their corporation or balances without a corporation.",
                "operationId": "adminIndexBalanceLimits",
                "parameters": [
                    {
                        "name": "balanceId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BalanceLimitCollection"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Balance not found or not accessible for the admin corporation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "BalanceNotFound": {
                                        "$ref": "#/components/examples/BalanceNotFound"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Admin - Balances"
                ],
                "summary": "Create balance limit",
                "description": "Adds a usage limit to the balance.\n\n- `CASH_OUT` - limits the total amount of outgoing card transactions charged to the balance within the period. A transaction exceeding the limit is declined.\n- `CASH_IN` - limit of incoming funds. Such limits can be created and are returned, but are currently not enforced during transaction processing.\n- `period` resets the used amount: `DAILY` every day at 23:59, `WEEKLY` every Monday at 00:00, `MONTHLY` on the 1st day of the month at 00:00.\n- Only one limit of the same `type` and `period` can exist on a balance.\n- The currency of the limit is the currency of the balance, `maxAmount` is expressed in its minor units.\n- `type` and `period` are case-insensitive and are returned in upper case.\n\n## Security\nROLE_CREATE_BALANCE_LIMIT is required to access this method.\nAdmins assigned to a corporation can only manage limits on balances belonging to their corporation or balances without a corporation.",
                "operationId": "adminCreateBalanceLimit",
                "parameters": [
                    {
                        "name": "balanceId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BalanceLimitCreateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BalanceLimitResource"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Balance not found or not accessible for the admin corporation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "BalanceNotFound": {
                                        "$ref": "#/components/examples/BalanceNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Limit of given type and period already exists",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "BalanceLimitAlreadyExists": {
                                        "$ref": "#/components/examples/BalanceLimitAlreadyExists"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Validation error:\n- `FIELD_IS_REQUIRED` - `type`, `maxAmount` or `period` missing\n- `INVALID_TYPE`, `INVALID_PERIOD` - value outside of the allowed values\n- `VALUE_MUST_BE_INTEGER_TYPE`, `MAX_AMOUNT_CANNOT_BE_NEGATIVE` - invalid `maxAmount`\n- `DATE_IS_INVALID` - `expiration` is not a date later than today\n- `CANNOT_CREATE` - the limit could not be stored\n\nFor validation errors `status` contains the error of the first invalid field and `errors` contains errors of all fields.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "BalanceLimitFieldIsRequired": {
                                        "$ref": "#/components/examples/BalanceLimitFieldIsRequired"
                                    },
                                    "BalanceLimitInvalidType": {
                                        "$ref": "#/components/examples/BalanceLimitInvalidType"
                                    },
                                    "BalanceLimitInvalidPeriod": {
                                        "$ref": "#/components/examples/BalanceLimitInvalidPeriod"
                                    },
                                    "BalanceLimitValueMustBeInteger": {
                                        "$ref": "#/components/examples/BalanceLimitValueMustBeInteger"
                                    },
                                    "BalanceLimitMaxAmountCannotBeNegative": {
                                        "$ref": "#/components/examples/BalanceLimitMaxAmountCannotBeNegative"
                                    },
                                    "BalanceLimitDateIsInvalid": {
                                        "$ref": "#/components/examples/BalanceLimitDateIsInvalid"
                                    },
                                    "BalanceLimitCannotCreate": {
                                        "$ref": "#/components/examples/BalanceLimitCannotCreate"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/balances/{balanceId}/limits/{limitId}": {
            "get": {
                "tags": [
                    "Admin - Balances"
                ],
                "summary": "Get specific balance limit",
                "description": "Returns a single limit of the balance.\n\n## Security\nROLE_READ_BALANCE_LIMIT is required to access this method.\nAdmins assigned to a corporation can only manage limits on balances belonging to their corporation or balances without a corporation.",
                "operationId": "adminGetBalanceLimit",
                "parameters": [
                    {
                        "name": "balanceId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid"
                        }
                    },
                    {
                        "name": "limitId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BalanceLimitResource"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Balance not found or not accessible for the admin corporation, or limit not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "BalanceNotFound": {
                                        "$ref": "#/components/examples/BalanceNotFound"
                                    },
                                    "BalanceLimitNotFound": {
                                        "$ref": "#/components/examples/BalanceLimitNotFound"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Admin - Balances"
                ],
                "summary": "Delete balance limit",
                "description": "Deletes the balance limit, the limit stops being enforced immediately. The operation is idempotent - deleting a limit that does not exist or was already deleted also returns 204.\n\n## Security\nROLE_DELETE_BALANCE_LIMIT is required to access this method.\nAdmins assigned to a corporation can only manage limits on balances belonging to their corporation or balances without a corporation.",
                "operationId": "adminDeleteBalanceLimit",
                "parameters": [
                    {
                        "name": "balanceId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid"
                        }
                    },
                    {
                        "name": "limitId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Limit deleted or not found"
                    },
                    "404": {
                        "description": "Balance not found or not accessible for the admin corporation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "BalanceNotFound": {
                                        "$ref": "#/components/examples/BalanceNotFound"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Admin - Balances"
                ],
                "summary": "Update balance limit",
                "description": "Changes `maxAmount` and/or `expiration` of the balance limit. Only the passed fields are changed, type, period and currency of the limit cannot be changed.\n\n## Security\nROLE_UPDATE_BALANCE_LIMIT is required to access this method.\nAdmins assigned to a corporation can only manage limits on balances belonging to their corporation or balances without a corporation.",
                "operationId": "adminUpdateBalanceLimit",
                "parameters": [
                    {
                        "name": "balanceId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid"
                        }
                    },
                    {
                        "name": "limitId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid"
                        }
                    }
                ],
                "requestBody": {
                    "required": false,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BalanceLimitUpdateRequest"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "404": {
                        "description": "Balance not found or not accessible for the admin corporation, or limit not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "BalanceNotFound": {
                                        "$ref": "#/components/examples/BalanceNotFound"
                                    },
                                    "BalanceLimitNotFound": {
                                        "$ref": "#/components/examples/BalanceLimitNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Validation error:\n- `VALUE_MUST_BE_INTEGER_TYPE`, `MAX_AMOUNT_CANNOT_BE_NEGATIVE` - invalid `maxAmount`\n- `DATE_IS_INVALID` - `expiration` is not a date later than today\n\n`status` contains the error of the first invalid field and `errors` contains errors of all fields.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "BalanceLimitValueMustBeInteger": {
                                        "$ref": "#/components/examples/BalanceLimitValueMustBeInteger"
                                    },
                                    "BalanceLimitMaxAmountCannotBeNegative": {
                                        "$ref": "#/components/examples/BalanceLimitMaxAmountCannotBeNegative"
                                    },
                                    "BalanceLimitDateIsInvalid": {
                                        "$ref": "#/components/examples/BalanceLimitDateIsInvalid"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/balances_company_summary": {
            "get": {
                "tags": [
                    "Admin - Balance Summary"
                ],
                "summary": "Get balance summary for company",
                "description": "\n## Security\nROLE_READ_COMPANY_BALANCE_SUMMARY is required to access this method",
                "operationId": "getCompanyBalancesSummary",
                "parameters": [
                    {
                        "name": "currency",
                        "in": "query",
                        "description": "Currency in 3 letter ISO-4217",
                        "schema": {
                            "type": "string",
                            "example": "PLN"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/BalanceSummary"
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "CANT_FIND_BALANCE_SUMMARY"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidCurrency": {
                                        "$ref": "#/components/examples/InvalidCurrency"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/balances_customer_summary": {
            "get": {
                "tags": [
                    "Admin - Balance Summary"
                ],
                "summary": "Get balance summary for customer",
                "description": "\n## Security\nROLE_READ_CUSTOMER_BALANCE_SUMMARY is required to access this method",
                "operationId": "getCustomerBalancesSummary",
                "parameters": [
                    {
                        "name": "currency",
                        "in": "query",
                        "description": "Currency in 3 letter ISO-4217",
                        "schema": {
                            "type": "string",
                            "example": "PLN"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/BalanceSummary"
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "CANT_FIND_BALANCE_SUMMARY"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidCurrency": {
                                        "$ref": "#/components/examples/InvalidCurrency"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/balances": {
            "get": {
                "tags": [
                    "Admin - Balances"
                ],
                "summary": "Get balances",
                "description": "\n## Security\nROLE_READ_ALL_BALANCES is required to access this method.\n\nIf the administrator has a corporation assigned, results are automatically filtered to that corporation. Passing a `dcCorporationId` different from the token's corporation returns a 422 validation error.",
                "operationId": "getBalances",
                "parameters": [
                    {
                        "name": "type",
                        "in": "query",
                        "description": "balance type [CUSTOMER | COMPANY | CREDIT | DEPOSIT | IBAN_TECHNICAL]",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "IBAN_TECHNICAL"
                        }
                    },
                    {
                        "name": "currency",
                        "in": "query",
                        "description": "Currency in 3 letter ISO-4217",
                        "schema": {
                            "type": "string",
                            "example": "PLN"
                        }
                    },
                    {
                        "name": "dcUserId",
                        "in": "query",
                        "description": "DC User Id",
                        "schema": {
                            "type": "int",
                            "example": "1337"
                        }
                    },
                    {
                        "name": "dcCorporationId",
                        "in": "query",
                        "description": "DC Corporation Id",
                        "schema": {
                            "type": "string",
                            "example": "0b8d6c51-5537-4923-a39d-ecbd6abe85e1"
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "description": "Field to order list",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "createdAt"
                            ]
                        }
                    },
                    {
                        "name": "order",
                        "in": "query",
                        "description": "Sorting order",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "ASC",
                                "DESC"
                            ]
                        }
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "description": "Limit of balances returned in a single chunk can be specified.",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": 20
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page of paginated list",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": 3
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BalanceGetAll"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Admin - Balances"
                ],
                "summary": "Create balance",
                "description": "\n## Security\nROLE_CREATE_CUSTOMER_BALANCE is required to access this method.\n\nIf the administrator has a corporation assigned, the balance will be created for that corporation. Passing a `dcCorporationId` different from the token's corporation returns a 422 validation error.",
                "operationId": "createBalance",
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "currency": {
                                        "description": "User id from DataCore",
                                        "type": "string",
                                        "example": "PLN"
                                    },
                                    "dcUserId": {
                                        "description": "Data Core user id",
                                        "type": "integer",
                                        "example": "1337"
                                    },
                                    "dcCorporationId": {
                                        "description": "Data Core Corporation id",
                                        "type": "string",
                                        "example": "a271f0e9-065b-4e3c-be24-9bac54fbd550"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "properties": {
                                            "id": {
                                                "type": "string",
                                                "example": "0b8d6c51-5537-4923-a39d-ecbd6abe85e2"
                                            },
                                            "balance": {
                                                "type": "intager",
                                                "example": "89"
                                            },
                                            "currency": {
                                                "type": "string",
                                                "example": "PLN"
                                            },
                                            "balanceHolder": {
                                                "type": "integer",
                                                "example": "1337"
                                            },
                                            "dcUserId": {
                                                "type": "integer",
                                                "example": "1337"
                                            },
                                            "dcCorporationId": {
                                                "type": "string",
                                                "example": "0b8d6c51-5537-4923-a39d-ecbd6abe85e2"
                                            }
                                        },
                                        "type": "object"
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CardNotFound": {
                                        "$ref": "#/components/examples/CustomerNotFound"
                                    },
                                    "CorporationNotFound": {
                                        "$ref": "#/components/examples/CorporationNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidCurrency": {
                                        "summary": "INVALID_CURRENCY",
                                        "value": {
                                            "status": "INVALID_CURRENCY"
                                        }
                                    },
                                    "MaxCountBalancesLimit": {
                                        "summary": "MAX_COUNT_BALANCES_LIMIT",
                                        "value": {
                                            "status": "MAX_COUNT_BALANCES_LIMIT"
                                        }
                                    },
                                    "InvalidBalanceOwner": {
                                        "summary": "INVALID_BALANCE_OWNER",
                                        "value": {
                                            "status": "INVALID_BALANCE_OWNER"
                                        }
                                    },
                                    "CorporationAccessDenied": {
                                        "summary": "CORPORATION_ACCESS_DENIED",
                                        "value": {
                                            "status": "CORPORATION_ACCESS_DENIED"
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/customers/{customerId}/balances/{balanceId}": {
            "delete": {
                "tags": [
                    "Admin - Customer Balance"
                ],
                "summary": "Delete customer balance",
                "description": "\n## Security\nROLE_DELETE_CUSTOMER_BALANCE is required to access this method",
                "operationId": "deleteCustomerBalance",
                "parameters": [
                    {
                        "name": "customerId",
                        "in": "path",
                        "description": "DataCore user id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": "1125"
                        }
                    },
                    {
                        "name": "balanceId",
                        "in": "path",
                        "description": "Id of balance",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid",
                            "example": "3dc88ad5-7053-454b-bcb8-e067c436f17d"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CustomerBalanceNotFound": {
                                        "$ref": "#/components/examples/CustomerBalanceNotFound"
                                    },
                                    "CustomerNotFound": {
                                        "$ref": "#/components/examples/CustomerNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Error response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CustomerBalanceNotCleared": {
                                        "$ref": "#/components/examples/CustomerBalanceNotCleared"
                                    },
                                    "CustomerAccountingBalanceNotCleared": {
                                        "$ref": "#/components/examples/CustomerAccountingBalanceNotCleared"
                                    },
                                    "LastCustomerBalanceLeft": {
                                        "$ref": "#/components/examples/LastCustomerBalanceLeft"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/balances/{balanceId}": {
            "get": {
                "tags": [
                    "Admin - Balances"
                ],
                "summary": "Get balance",
                "description": "\n## Security\nROLE_READ_CUSTOMER_BALANCE is required to access this method.\n\nIf the administrator has a corporation assigned, only balances belonging to that corporation will be accessible. Requesting a balance from a different corporation returns 404.",
                "operationId": "getBalance",
                "parameters": [
                    {
                        "name": "balanceId",
                        "in": "path",
                        "description": "DataCore balance id",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "9ec5fbe0-3599-4ec0-8255-9c390cbea02a"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BalanceDetails"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "enum": [
                                                "BALANCE_NOT_FOUND"
                                            ],
                                            "example": "BALANCE_NOT_FOUND"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/balances/currencies": {
            "get": {
                "tags": [
                    "Admin - Balances"
                ],
                "summary": "Get balance currencies",
                "description": "Get list of available balance currencies. ROLE_READ_BALANCES_CURRENCIES is required to access this method",
                "operationId": "getBalancesCurrencies",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "example": [
                                    "PLN",
                                    "EUR",
                                    "USD"
                                ]
                            }
                        }
                    }
                }
            }
        },
        "/admin/balances/types": {
            "get": {
                "tags": [
                    "Admin - Balances"
                ],
                "summary": "Get balances types",
                "description": "\n## Security\nROLE_READ_ALL_BALANCES is required to access this method",
                "operationId": "getBalancesTypes",
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "string"
                                },
                                "example": [
                                    "CUSTOMER",
                                    "COMPANY",
                                    "CREDIT",
                                    "DEPOSIT",
                                    "IBAN_TECHNICAL"
                                ]
                            }
                        }
                    }
                }
            }
        },
        "/admin/balances/credit": {
            "get": {
                "tags": [
                    "Admin - Master Balance"
                ],
                "summary": "Get list of credit balances",
                "description": "Use this method to get all credit.\n## Security\nROLE_READ_MASTER_BALANCE is required to access this method",
                "operationId": "1ea3162cf1d4ea4ad7a9b7da3dd16921",
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/MasterBalance"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/balances/credit/{balanceId}": {
            "get": {
                "tags": [
                    "Admin - Master Balance"
                ],
                "summary": "Get credit balance detail",
                "description": "Use this method to credit balance details.\n## Security\nROLE_READ_MASTER_BALANCE is required to access this method",
                "operationId": "def34f82342ea222be01296955eb373f",
                "parameters": [
                    {
                        "name": "balanceId",
                        "in": "path",
                        "description": "Id of balance",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid",
                            "example": "3dc88ad5-7053-454b-bcb8-e067c436f17d"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MasterBalance"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "MASTER_BALANCE_NOT_FOUND"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/balances/deposit": {
            "get": {
                "tags": [
                    "Admin - Master Balance"
                ],
                "summary": "Get list of deposit balances",
                "description": "Use this method to get all deposit.\n## Security\nROLE_READ_MASTER_BALANCE is required to access this method",
                "operationId": "31404ddcb7e3fcbeb5641ce6b6d08c83",
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/MasterBalance"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/balances/deposit/{balanceId}": {
            "get": {
                "tags": [
                    "Admin - Master Balance"
                ],
                "summary": "Get deposit balance detail",
                "description": "Use this method to deposit balance details.\n## Security\nROLE_READ_MASTER_BALANCE is required to access this method",
                "operationId": "737e2f5385490fbc2c2a533bc2a95ddf",
                "parameters": [
                    {
                        "name": "balanceId",
                        "in": "path",
                        "description": "Id of balance",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid",
                            "example": "3dc88ad5-7053-454b-bcb8-e067c436f17d"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MasterBalance"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "MASTER_BALANCE_NOT_FOUND"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/balances/financial_institution/deposit": {
            "get": {
                "tags": [
                    "Admin - Master Balance"
                ],
                "summary": "Get deposit master balances from financial institution",
                "description": "Use this method to get all deposit master balances from the financial institution.\n## Security\nROLE_READ_MASTER_BALANCE is required to access this method",
                "operationId": "de0036b4a14c7b43cf7764540c795cf2",
                "parameters": [
                    {
                        "name": "currency",
                        "in": "query",
                        "description": "Filter by currency code ISO 4217",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "PLN"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "properties": {
                                                    "currency": {
                                                        "type": "string",
                                                        "example": "PLN"
                                                    },
                                                    "balance": {
                                                        "type": "integer",
                                                        "example": 150000
                                                    }
                                                },
                                                "type": "object"
                                            }
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Balance not found in financial institution",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "BALANCE_NOT_FOUND"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "502": {
                        "description": "Bad gateway - financial institution connection error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "BAD_GATEWAY"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/reports/monthly_operation_statements": {
            "post": {
                "tags": [
                    "Admin - Billings"
                ],
                "summary": "Starts report generating process",
                "description": "\n## Security\nROLE_CREATE_BILLINGS is required to access this method",
                "operationId": "ed92fb31d4a9f887cc21a8c6847a51fe",
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "balanceId",
                                    "rangeFrom",
                                    "rangeTo"
                                ],
                                "properties": {
                                    "balanceId": {
                                        "description": "Balance Id",
                                        "type": "string",
                                        "example": "5083fdf3-5f3a-4657-83ba-20af9e7abc13"
                                    },
                                    "rangeFrom": {
                                        "description": "Date time transactions lists should generate last transaction",
                                        "type": "string",
                                        "format": "date",
                                        "example": "2023-01-26 00:00:00"
                                    },
                                    "rangeTo": {
                                        "description": "Date time transactions lists should generate last transaction",
                                        "type": "string",
                                        "format": "date",
                                        "example": "2023-01-26 23:59:59"
                                    },
                                    "customerId": {
                                        "description": "DataCore customer identifier",
                                        "type": "integer",
                                        "example": 1337,
                                        "nullable": true
                                    },
                                    "dcCorporationId": {
                                        "description": "DataCore corporation identifier",
                                        "type": "string",
                                        "format": "uuid",
                                        "example": "d25b281c-8c07-4877-99dd-df71db0effff",
                                        "nullable": true
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerNotFound"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidCustomerId": {
                                        "$ref": "#/components/examples/InvalidCustomerId"
                                    },
                                    "InvalidBalanceId": {
                                        "$ref": "#/components/examples/InvalidBalanceId"
                                    },
                                    "InvalidRangeFrom": {
                                        "$ref": "#/components/examples/InvalidRangeFrom"
                                    },
                                    "InvalidRangeTo": {
                                        "$ref": "#/components/examples/InvalidRangeTo"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/reports": {
            "get": {
                "tags": [
                    "Admin - Billings"
                ],
                "summary": "Get list billing reports",
                "description": "\n## Security\nROLE_READ_BILLINGS is required to access this method",
                "operationId": "96dc79c80be01271a62651314ad9ddb4",
                "parameters": [
                    {
                        "name": "customerId",
                        "in": "query",
                        "description": "DataCore user id",
                        "schema": {
                            "type": "integer",
                            "example": 1337
                        }
                    },
                    {
                        "name": "balanceId",
                        "in": "query",
                        "description": "Id of balance",
                        "schema": {
                            "type": "string",
                            "format": "uuid",
                            "example": "3dc88ad5-7053-454b-bcb8-e067c436f17d"
                        }
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "description": "Type of report",
                        "schema": {
                            "type": "string",
                            "example": "customer_monthly_settlement"
                        }
                    },
                    {
                        "name": "rangeFrom",
                        "in": "query",
                        "description": "Beginning date of report",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "example": "2023-01-01 00:00:00"
                        }
                    },
                    {
                        "name": "rangeTo",
                        "in": "query",
                        "description": "End date of report",
                        "schema": {
                            "type": "string",
                            "format": "date-time",
                            "example": "2023-01-31 23:59:59"
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page of list (default: 1)",
                        "schema": {
                            "type": "integer",
                            "example": 1
                        }
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "description": "Count of items per page (default: 10)",
                        "schema": {
                            "type": "integer",
                            "example": 10
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Report collection",
                        "content": {
                            "application/ld+json": {
                                "schema": {
                                    "properties": {
                                        "hydra:member": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Report"
                                            }
                                        },
                                        "hydra:totalItems": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "example": "2"
                                        },
                                        "hydra:view": {
                                            "properties": {
                                                "@id": {
                                                    "type": "string",
                                                    "format": "iri-reference"
                                                },
                                                "@type": {
                                                    "type": "string"
                                                },
                                                "hydra:first": {
                                                    "type": "string",
                                                    "format": "iri-reference",
                                                    "example": "/admin/reports?limit=1&page=1"
                                                },
                                                "hydra:last": {
                                                    "type": "string",
                                                    "format": "iri-reference",
                                                    "example": "/admin/reports?limit=1&page=2"
                                                },
                                                "hydra:previous": {
                                                    "type": "string",
                                                    "format": "iri-reference",
                                                    "example": "/admin/reports?limit=1&page=1"
                                                },
                                                "hydra:next": {
                                                    "type": "string",
                                                    "format": "iri-reference",
                                                    "example": "/admin/reports?limit=1&page=2"
                                                }
                                            },
                                            "type": "object"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "NotImplemented": {
                                        "$ref": "#/components/examples/CustomerNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidCustomerId": {
                                        "$ref": "#/components/examples/InvalidCustomerId"
                                    },
                                    "InvalidBalanceId": {
                                        "$ref": "#/components/examples/InvalidBalanceId"
                                    },
                                    "InvalidRangeFrom": {
                                        "$ref": "#/components/examples/InvalidRangeFrom"
                                    },
                                    "InvalidRangeTo": {
                                        "$ref": "#/components/examples/InvalidRangeTo"
                                    }
                                }
                            }
                        }
                    },
                    "501": {
                        "description": "Not implemented",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "NotImplemented": {
                                        "$ref": "#/components/examples/NotImplemented"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/cards/config": {
            "get": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Returns a list of avaliable card types conifg",
                "description": "Method returns list of available card types. This methods should be used for showing custmer posibilites of generate new virtual card or order new phisical card",
                "operationId": "a659eed2a634e50f367f23c76d83ea34",
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/CardAllowedConfig"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/cards/{cardId}/pin": {
            "post": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Change card pin",
                "description": "Method allows to update card pin. ROLE_CHANGE_PIN is required to access this method",
                "operationId": "ceca89eaad29c0a76a6ed128315aba6f",
                "parameters": [
                    {
                        "name": "cardId",
                        "in": "path",
                        "description": "DataCore card id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": 1125
                        }
                    }
                ],
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "pin": {
                                        "description": "New pin",
                                        "type": "string",
                                        "example": "1337"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CardNotFound": {
                                        "$ref": "#/components/examples/CardNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Error response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidCard": {
                                        "$ref": "#/components/examples/InvalidCard"
                                    },
                                    "ChangePinFailure": {
                                        "$ref": "#/components/examples/ChangePinFailure"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/cards/virtual/async": {
            "post": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Create new virtual card assigned to customer balance. [Async Process]",
                "description": "\n## Encryption\nThis method requires additional encryption (JWE). Find out more using\n[this link](https://developer.verestro.com/books/card-management-system/page/overview#bkmrk-step-1.-configuratio-0)\n     ",
                "operationId": "284c043a81c405f309dce68a78c81f33",
                "requestBody": {
                    "description": "Input data format",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "balanceId": {
                                        "description": "Customer balance id for which card should be linked",
                                        "type": "string",
                                        "example": "e1169e67-0ef3-4358-a4c2-14f793d8907c"
                                    },
                                    "configId": {
                                        "description": "Configuration identifier obtained from method: /customers/me/cards/config",
                                        "type": "string",
                                        "example": "0013009713"
                                    },
                                    "dcUserId": {
                                        "description": "User identifier from dataCore",
                                        "type": "integer",
                                        "example": "1337"
                                    },
                                    "dcCorporationId": {
                                        "description": "Corporation identifier from dataCore",
                                        "type": "string",
                                        "format": "uuid",
                                        "example": "ec619acc-e21d-4b6d-9d96-9ac7e606294a"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "202": {
                        "description": "Successful operation containing tracking url for obtaining operation status",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "IN_PROGRESS"
                                        },
                                        "tracking": {
                                            "type": "string",
                                            "example": "/async_operations/1994b43d-8962-4e6e-9c9c-b1c67636b23e"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CorporationBalanceNotFound": {
                                        "$ref": "#/components/examples/CorporationBalanceNotFound"
                                    },
                                    "CustomerBalanceNotFound": {
                                        "$ref": "#/components/examples/CustomerBalanceNotFound"
                                    },
                                    "CorporationNotFound": {
                                        "$ref": "#/components/examples/CorporationNotFound"
                                    },
                                    "CustomerNotFound": {
                                        "$ref": "#/components/examples/CustomerNotFound"
                                    },
                                    "InvalidConfiguration": {
                                        "$ref": "#/components/examples/InvalidConfiguration"
                                    },
                                    "InvalidCurrency": {
                                        "$ref": "#/components/examples/InvalidCurrency"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/cards/{cardId}/budget": {
            "get": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Get card budget",
                "description": "\n## Security\nROLE_READ_CARD_LIMIT is required to access this method",
                "operationId": "159fd4eef5b4b246bcc62a4308186da8",
                "parameters": [
                    {
                        "name": "cardId",
                        "in": "path",
                        "description": "DataCore card id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": "1125"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CardLimit"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CardNotFound": {
                                        "$ref": "#/components/examples/CardNotFound"
                                    },
                                    "CardBudgetNotFound": {
                                        "$ref": "#/components/examples/CardBudgetNotFound"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Create card budget",
                "description": "\n## Security\nROLE_CREATE_CARD_LIMIT is required to access this method",
                "operationId": "createCardBudget",
                "parameters": [
                    {
                        "name": "cardId",
                        "in": "path",
                        "description": "DataCore card id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": "1125"
                        }
                    }
                ],
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "value": {
                                        "description": "Budget value",
                                        "type": "integer",
                                        "example": "1000"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CardLimit"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CardNotFound": {
                                        "$ref": "#/components/examples/CardNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "BudgetAlreadyExists": {
                                        "$ref": "#/components/examples/BudgetAlreadyExists"
                                    },
                                    "FieldIsRequired": {
                                        "$ref": "#/components/examples/FieldIsRequired"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Delete card budget",
                "description": "\n## Security\nROLE_DELETE_CARD_LIMIT is required to access this method",
                "operationId": "deleteCardBudget",
                "parameters": [
                    {
                        "name": "cardId",
                        "in": "path",
                        "description": "DataCore card id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": "1125"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CardNotFound": {
                                        "$ref": "#/components/examples/CardNotFound"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Update card budget",
                "description": "This method allows admin to change card budget. New value cannot be lower than amount already used.\n## Security\nROLE_UPDATE_CARD_LIMIT is required to access this method",
                "operationId": "updateCardBudget",
                "parameters": [
                    {
                        "name": "cardId",
                        "in": "path",
                        "description": "DataCore card id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": "1125"
                        }
                    }
                ],
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "value": {
                                        "description": "New budget value. It must be greater than already used budget value",
                                        "type": "integer",
                                        "example": "1000"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CardBudgetNotFound": {
                                        "$ref": "#/components/examples/CardBudgetNotFound"
                                    },
                                    "CardNotFound": {
                                        "$ref": "#/components/examples/CardNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Error response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CantUpdateBudget": {
                                        "$ref": "#/components/examples/CantUpdateBudget"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "FieldIsRequired": {
                                        "$ref": "#/components/examples/FieldIsRequired"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/customers/{customerId}/cards/virtual": {
            "post": {
                "tags": [
                    "Admin - Customer Cards"
                ],
                "summary": "Create new virtual card assigned to customer balance.",
                "description": "\n## Encryption\nThis method requires additional encryption (JWE). Find out more using\n[this link](https://developer.verestro.com/books/card-management-system/page/overview#bkmrk-step-1.-configuratio-0)\n     ",
                "operationId": "5de0e387686c503c3432559ffc491289",
                "parameters": [
                    {
                        "name": "customerId",
                        "in": "path",
                        "description": "DataCore user id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": "1337"
                        }
                    }
                ],
                "requestBody": {
                    "description": "Input data format",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "balanceId": {
                                        "description": "Customer balance id for which card should be linked",
                                        "type": "string",
                                        "example": "00000000-0000-0000-0000-000000000000"
                                    },
                                    "configId": {
                                        "description": "Configuration identifier obtained from method: /customers/me/cards/config",
                                        "type": "string",
                                        "example": "0013009713"
                                    },
                                    "dcCorporationId": {
                                        "description": "corporation id",
                                        "type": "string",
                                        "example": "6149613a-0b5e-4645-b362-493707f467b0"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/VirtualCardResource"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CustomerBalanceNotFound": {
                                        "$ref": "#/components/examples/CustomerBalanceNotFound"
                                    },
                                    "CustomerNotFound": {
                                        "$ref": "#/components/examples/CustomerNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Error response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CantCreateLinkedCard": {
                                        "$ref": "#/components/examples/CantCreateLinkedCard"
                                    },
                                    "StoreCardFailure": {
                                        "$ref": "#/components/examples/StoreCardFailure"
                                    },
                                    "CardIssuerError": {
                                        "$ref": "#/components/examples/CardIssuerError"
                                    },
                                    "InvalidConfiguration": {
                                        "$ref": "#/components/examples/InvalidConfiguration"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "ConfigIdRequired": {
                                        "$ref": "#/components/examples/ConfigIdRequired"
                                    },
                                    "BalanceIdRequired": {
                                        "$ref": "#/components/examples/BalanceIdRequired"
                                    }
                                }
                            }
                        }
                    }
                },
                "deprecated": true
            }
        },
        "/admin/cards/disposable": {
            "post": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Create new one-time virtual card assigned to a customer or corporation balance.",
                "description": "\nIssues a virtual card with a ONE_SHOT limit — valid for a single transaction.\nIt is deleted from the system after first use.\n     ",
                "operationId": "3d5f4e5e5358292f63aa1af113284283",
                "requestBody": {
                    "description": "Input data format",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "balanceId": {
                                        "description": "Balance id for which the card should be linked",
                                        "type": "string",
                                        "example": "e1169e67-0ef3-4358-a4c2-14f793d8907c"
                                    },
                                    "configId": {
                                        "description": "Configuration identifier obtained from method: /customers/me/cards/config",
                                        "type": "string",
                                        "example": "0013009713"
                                    },
                                    "dcUserId": {
                                        "description": "User identifier from dataCore",
                                        "type": "integer",
                                        "example": "1337",
                                        "nullable": "true"
                                    },
                                    "dcCorporationId": {
                                        "description": "Corporation identifier from dataCore",
                                        "type": "string",
                                        "format": "uuid",
                                        "example": "ec619acc-e21d-4b6d-9d96-9ac7e606294a",
                                        "nullable": "true"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/VirtualCardResource"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CustomerBalanceNotFound": {
                                        "$ref": "#/components/examples/CustomerBalanceNotFound"
                                    },
                                    "CustomerNotFound": {
                                        "$ref": "#/components/examples/CustomerNotFound"
                                    },
                                    "CorporationNotFound": {
                                        "$ref": "#/components/examples/CorporationNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Error response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CantCreateLinkedCard": {
                                        "$ref": "#/components/examples/CantCreateLinkedCard"
                                    },
                                    "StoreCardFailure": {
                                        "$ref": "#/components/examples/StoreCardFailure"
                                    },
                                    "CardIssuerError": {
                                        "$ref": "#/components/examples/CardIssuerError"
                                    },
                                    "InvalidConfiguration": {
                                        "$ref": "#/components/examples/InvalidConfiguration"
                                    },
                                    "InvalidCurrency": {
                                        "$ref": "#/components/examples/InvalidCurrency"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "BalanceIdRequired": {
                                        "$ref": "#/components/examples/BalanceIdRequired"
                                    },
                                    "ConfigIdRequired": {
                                        "$ref": "#/components/examples/ConfigIdRequired"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/cards/virtual": {
            "post": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Create new virtual card assigned to customer balance.",
                "description": "\n## Encryption\nThis method requires additional encryption (JWE). Find out more using\n[this link](https://developer.verestro.com/books/card-management-system/page/overview#bkmrk-step-1.-configuratio-0)\n",
                "operationId": "cf4687a5cf802db762539522d05a929b",
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "balanceId": {
                                        "description": "Customer balance id for which card should be linked",
                                        "type": "string",
                                        "example": "e1169e67-0ef3-4358-a4c2-14f793d8907c"
                                    },
                                    "configId": {
                                        "description": "Configuration identifier obtained from method: /customers/me/cards/config",
                                        "type": "string",
                                        "example": "0013009713"
                                    },
                                    "dcUserId": {
                                        "description": "User identifier from dataCore",
                                        "type": "integer",
                                        "example": "1337",
                                        "nullable": "true"
                                    },
                                    "dcCorporationId": {
                                        "description": "Corporation identifier from dataCore",
                                        "type": "string",
                                        "format": "uuid",
                                        "example": "ec619acc-e21d-4b6d-9d96-9ac7e606294a",
                                        "nullable": "true"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/VirtualCardResource"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CustomerBalanceNotFound": {
                                        "$ref": "#/components/examples/CustomerBalanceNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Error response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CantCreateLinkedCard": {
                                        "$ref": "#/components/examples/CantCreateLinkedCard"
                                    },
                                    "StoreCardFailure": {
                                        "$ref": "#/components/examples/StoreCardFailure"
                                    },
                                    "CardIssuerError": {
                                        "$ref": "#/components/examples/CardIssuerError"
                                    },
                                    "InvalidConfiguration": {
                                        "$ref": "#/components/examples/InvalidConfiguration"
                                    },
                                    "InvalidCurrency": {
                                        "$ref": "#/components/examples/InvalidCurrency"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "BalanceIdRequired": {
                                        "$ref": "#/components/examples/BalanceIdRequired"
                                    },
                                    "ConfigIdRequired": {
                                        "$ref": "#/components/examples/ConfigIdRequired"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/cards/{cardId}": {
            "get": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Get customer card details",
                "description": "\n## Security\nROLE_READ_CUSTOMER_CARD_DETAILS is required to access this method",
                "operationId": "getCard",
                "parameters": [
                    {
                        "name": "cardId",
                        "in": "path",
                        "description": "DataCore card id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": "1125"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CardDetailsAdmin"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CardNotFound": {
                                        "$ref": "#/components/examples/CardNotFound"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Delete customer's card",
                "description": "## Security\nROLE_DELETE_CUSTOMER_CARD is required to access this method,</br>\nMethod delete prepaid card. Be careful, this card is deleted from all services (prepaid, dc, tutuka)",
                "operationId": "bd00dca39a48bd10f6e633c59c402472",
                "parameters": [
                    {
                        "name": "cardId",
                        "in": "path",
                        "description": "DataCore card id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": "3098"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CardNotFound": {
                                        "$ref": "#/components/examples/CardNotFound"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/cards/{cardId}/cvv": {
            "post": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Generate new cvv for a virtual card",
                "description": "\n## Encryption\nThis method requires additional encryption (JWE). Find out more using\n[this link](https://developer.verestro.com/books/card-management-system/page/overview#bkmrk-step-1.-configuratio-0)\n\n## Security\nROLE_GENERATE_CVV is required to access this method\n      ",
                "operationId": "01bc545d4d1a979e02b44020509d4691",
                "parameters": [
                    {
                        "name": "cardId",
                        "in": "path",
                        "description": "DataCore card id",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "cvv": {
                                            "type": "string",
                                            "example": "255"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CardNotFound": {
                                        "$ref": "#/components/examples/CardNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Cvv generation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "UpdateCvvFailure": {
                                        "$ref": "#/components/examples/UpdateCvvFailure"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/cards/{id}/delivery": {
            "get": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Get single physical card delivery data",
                "operationId": "6ca1b7e310510ba57b43b902493d7808",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Dc card id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": 1125
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "orderId": {
                                            "type": "string",
                                            "example": "018e4c0a-1b2c-7d3e-9f4a-5b6c7d8e9f0a"
                                        },
                                        "deliveryStatus": {
                                            "type": "string",
                                            "example": "DELIVERED",
                                            "nullable": true
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "Access denied",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "reason": {
                                            "type": "string",
                                            "example": "FORBIDDEN"
                                        },
                                        "detail": {
                                            "type": "string",
                                            "example": "Error message"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Card not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "reason": {
                                            "type": "string",
                                            "example": "CARD_NOT_FOUND"
                                        },
                                        "detail": {
                                            "type": "string",
                                            "example": "Error message"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Update physical card delivery status",
                "operationId": "f5173abec9ae72ca404f57d8cc25afd9",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Dc card id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": 1125
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "status"
                                ],
                                "properties": {
                                    "deliveryStatus": {
                                        "description": "New delivery status",
                                        "type": "string",
                                        "enum": [
                                            "IN_TRANSIT",
                                            "DELIVERED",
                                            "READY_TO_PICKUP"
                                        ],
                                        "example": "DELIVERED"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "403": {
                        "description": "Access denied",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "reason": {
                                            "type": "string",
                                            "example": "FORBIDDEN"
                                        },
                                        "detail": {
                                            "type": "string",
                                            "example": "Error message"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Order not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "reason": {
                                            "type": "string",
                                            "example": "ORDER_NOT_FOUND"
                                        },
                                        "detail": {
                                            "type": "string",
                                            "example": "Error message"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/cards/orders/{id}": {
            "get": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Get single physical card order",
                "operationId": "e75270f8c35a6eb2d2ae2dce897ebeec",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Card order operation id",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid",
                            "example": "39927556-7848-4dff-a0d2-24c23915bfa9"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AdminCardOrderDetailsResponse"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Order not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "reason": {
                                            "type": "string",
                                            "example": "ORDER_NOT_FOUND"
                                        },
                                        "detail": {
                                            "type": "string",
                                            "example": "Error message"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Update physical card order delivery status",
                "operationId": "c11eb6922f5aacaf48c4ed867df2eb45",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Card order UUID",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid",
                            "example": "39927556-7848-4dff-a0d2-24c23915bfa9"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "status"
                                ],
                                "properties": {
                                    "status": {
                                        "description": "New delivery status",
                                        "type": "string",
                                        "enum": [
                                            "IN_TRANSIT",
                                            "DELIVERED",
                                            "READY_TO_PICKUP"
                                        ],
                                        "example": "DELIVERED"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "400": {
                        "description": "Invalid delivery status value"
                    },
                    "403": {
                        "description": "Access denied",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "reason": {
                                            "type": "string",
                                            "example": "FORBIDDEN"
                                        },
                                        "detail": {
                                            "type": "string",
                                            "example": "Error message"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Order not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "reason": {
                                            "type": "string",
                                            "example": "ORDER_NOT_FOUND"
                                        },
                                        "detail": {
                                            "type": "string",
                                            "example": "Error message"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/cards/orders": {
            "get": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "List all physical card orders",
                "operationId": "8029c0acf24d66298699898f1d3eca38",
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page number",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 1,
                            "example": 1
                        }
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "description": "Items per page",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 20,
                            "example": 20
                        }
                    },
                    {
                        "name": "deliveryStatus",
                        "in": "query",
                        "description": "Filter by delivery status",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "IN_TRANSIT",
                                "DELIVERED",
                                "READY_TO_PICKUP"
                            ],
                            "example": "DELIVERED",
                            "nullable": true
                        }
                    },
                    {
                        "name": "from",
                        "in": "query",
                        "description": "Filter orders created from this date (inclusive), format YYYY-MM-DD",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2024-01-01",
                            "nullable": true
                        }
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "description": "Filter orders created up to this date (inclusive), format YYYY-MM-DD",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2024-12-31",
                            "nullable": true
                        }
                    },
                    {
                        "name": "orderId",
                        "in": "query",
                        "description": "Filter by order UUID",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "format": "uuid",
                            "example": "39927556-7848-4dff-a0d2-24c23915bfa9",
                            "nullable": true
                        }
                    },
                    {
                        "name": "cardId",
                        "in": "query",
                        "description": "Filter by DataCore card ID",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "example": 45554,
                            "nullable": true
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Paginated list of card orders",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/AdminCardOrderItem"
                                            }
                                        },
                                        "pagination": {
                                            "$ref": "#/components/schemas/PaginationData"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/cards": {
            "get": {
                "tags": [
                    "Admin - Cards"
                ],
                "summary": "Get cards",
                "description": "\n## Security\nROLE_GET_CARDS is required to access this method",
                "operationId": "getCards",
                "parameters": [
                    {
                        "name": "dcUserId",
                        "in": "query",
                        "description": "DataCore user id",
                        "schema": {
                            "type": "integer",
                            "example": "1337"
                        }
                    },
                    {
                        "name": "dcCorporationId",
                        "in": "query",
                        "description": "DataCore corporation id",
                        "schema": {
                            "format": "string",
                            "example": "492ec5ee-7f66-11ec-a8a3-0242ac120002"
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "description": "Field to order list",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "createdAt"
                            ]
                        }
                    },
                    {
                        "name": "order",
                        "in": "query",
                        "description": "Sorting order",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "ASC",
                                "DESC"
                            ]
                        }
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "description": "Limit of cards returned in a single chunk can be specified.",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": 20
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page of paginated list",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": 3
                        }
                    },
                    {
                        "name": "balanceId",
                        "in": "query",
                        "description": "Filter by balanceId",
                        "required": false,
                        "schema": {
                            "format": "string",
                            "example": "492ec5ee-7f66-11ec-a8a3-0242ac120002"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/CardGetAll"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/customers/{customerId}/cards/{cardId}": {
            "get": {
                "tags": [
                    "Admin - Customer Cards"
                ],
                "summary": "Get customer card details",
                "description": "\n## Security\nROLE_READ_CUSTOMER_CARD_DETAILS is required to access this method",
                "operationId": "getCustomerCard",
                "parameters": [
                    {
                        "name": "customerId",
                        "in": "path",
                        "description": "DataCore user id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": "1125"
                        }
                    },
                    {
                        "name": "cardId",
                        "in": "path",
                        "description": "DataCore card id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": "1125"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CardDetailsAdmin"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CardNotFound": {
                                        "$ref": "#/components/examples/CardNotFound"
                                    },
                                    "CustomerNotFound": {
                                        "$ref": "#/components/examples/CustomerNotFound"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/clearings": {
            "post": {
                "tags": [
                    "Admin - Transactions"
                ],
                "summary": "Clear transactions",
                "description": "Use this method to manually clear transactions. Every transaction (found by provided transaction id) will be cleared with every provided daily settlement.\n  <br><br><strong>For example:</strong><br>\n  <strong>transactionIds:</strong> X,Y <br>\n  <strong>dailySettlementTransactionIds:</strong> A,B<br>\n  Transaction X will be cleared using A and B settlements.<br>\n  Transaction Y will be cleared using A and B settlements.<br><br>\n  If dailySettlementTransactionIds will be empty - an 'artificial' clearing record will be created.\n## Security\nROLE_CLEAR_TRANSACTION is required to access this method\n  ",
                "operationId": "manualClearing",
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "transactionIds": {
                                        "description": "Identifiers of transactions to be cleared.",
                                        "type": "array",
                                        "items": {
                                            "type": "uuid",
                                            "example": "87423b49-49ce-4387-a0c8-b2200c91c23a"
                                        }
                                    },
                                    "dailySettlementTransactionIds": {
                                        "description": "Identifiers of daily settlements to be used for transactions clearing.",
                                        "type": "array",
                                        "items": {
                                            "type": "uuid",
                                            "example": "6cca5b85-8e87-446d-8e82-64a84ff9e7f1"
                                        }
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidSettlementId": {
                                        "$ref": "#/components/examples/InvalidSettlementId"
                                    },
                                    "InvalidTransactionId": {
                                        "$ref": "#/components/examples/InvalidTransactionId"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/reversals": {
            "post": {
                "tags": [
                    "Admin - Transactions"
                ],
                "summary": "Revert transactions",
                "description": "Use this method to manually revert transaction. Transaction can be reverted fully or partialy.\n## Security\nROLE_REVERT_TRANSACTION is required to access this method\n  ",
                "operationId": "manualReversal",
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "transactionId": {
                                        "description": "Identifier of transaction to be reverted.",
                                        "type": "uuid",
                                        "example": "87423b49-49ce-4387-a0c8-b2200c91c23a"
                                    },
                                    "amount": {
                                        "description": "Amount to be reverted in currency minor unit. Cannot exceed amount of transaction to be reversed.",
                                        "type": "integer",
                                        "example": "350"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CustomerBalanceNotFound": {
                                        "$ref": "#/components/examples/CustomerBalanceNotFound"
                                    },
                                    "DepositBalanceNotFound": {
                                        "$ref": "#/components/examples/DepositBalanceNotFound"
                                    },
                                    "TransactionNotFound": {
                                        "$ref": "#/components/examples/TransactionNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Transaction Conflict",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "TransactionAmountExceeded": {
                                        "$ref": "#/components/examples/TransactionAmountExceeded"
                                    },
                                    "TransactionAlreadyCleared": {
                                        "$ref": "#/components/examples/TransactionAlreadyCleared"
                                    },
                                    "TransactionAlreadyReversed": {
                                        "$ref": "#/components/examples/TransactionAlreadyReversed"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidTransactionId": {
                                        "$ref": "#/components/examples/InvalidTransactionId"
                                    },
                                    "InvalidAmount": {
                                        "$ref": "#/components/examples/InvalidAmount"
                                    }
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Internal server error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CardLimitError": {
                                        "$ref": "#/components/examples/CardLimitError"
                                    },
                                    "InternalServerError": {
                                        "$ref": "#/components/examples/InternalServerError"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/corporations": {
            "post": {
                "tags": [
                    "Admin - Corporations"
                ],
                "summary": "Create new corporation",
                "description": "\n## Security\nROLE_CREATE_CORPORATION is required to access this method",
                "operationId": "createNewCorporation-Admin",
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "customerId": {
                                        "description": "User id from DataCore",
                                        "type": "integer",
                                        "example": "1337"
                                    },
                                    "firstName": {
                                        "description": "First name of corporation",
                                        "type": "string",
                                        "example": "Elon"
                                    },
                                    "lastName": {
                                        "description": "Last name of corporation",
                                        "type": "string",
                                        "example": "Musk"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "id": {
                                            "type": "string",
                                            "example": "1337"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Error response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "VerificationAlreadyExist": {
                                        "$ref": "#/components/examples/VerificationAlreadyExist"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "FieldIsRequired": {
                                        "$ref": "#/components/examples/FieldIsRequired"
                                    }
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Internal server error",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "INTERNAL_SERVER_ERROR"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CustomerNotFound": {
                                        "$ref": "#/components/examples/CustomerNotFound"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/customers_due_diligence": {
            "get": {
                "tags": [
                    "Admin - Customers Due Diligence"
                ],
                "summary": "Get list of cdd",
                "description": "[Due Diligence] Request list of performed CDDs with verificationId, listName, sourceName and date.\n\n## Security\nROLE_READ_CDD is required to access this method\n",
                "operationId": "getCustomerDueDiligences",
                "parameters": [
                    {
                        "name": "verificationId",
                        "in": "query",
                        "description": "[filter] Uuid of verification",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "5a5b253b-ac14-4566-a89f-8c5d26544c4e"
                        }
                    },
                    {
                        "name": "listName",
                        "in": "query",
                        "description": "[filter] Checked against what",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "a-list"
                        }
                    },
                    {
                        "name": "sourceName",
                        "in": "query",
                        "description": "[filter] Checked by whom",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "1125"
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "description": "Field to order list",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "date"
                            ]
                        }
                    },
                    {
                        "name": "order",
                        "in": "query",
                        "description": "Sorting order",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "DESC"
                            ]
                        }
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "description": "Limit of cards returned in a single chunk can be specified.",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": 20
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page of paginated list",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": 3
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/CddCollection"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Admin - Customers Due Diligence"
                ],
                "summary": "Add new cdd record",
                "description": "[Due diligence] Confirm given customer was checked against given list by given person on given date.\n\n ## Security\n ROLE_CREATE_CDD is required to access this method",
                "operationId": "createCustomerDueDiligence-Admin",
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "verificationId": {
                                        "description": "Checked who",
                                        "type": "string",
                                        "example": "5a5b253b-ac14-4566-a89f-8c5d26544c4e"
                                    },
                                    "listName": {
                                        "description": "Checked where",
                                        "type": "string",
                                        "example": "known-list-published-on-1997-04-02-by-ACME"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidCdd": {
                                        "$ref": "#/components/examples/InvalidCdd"
                                    }
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Server failed to store data",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InternalServerError": {
                                        "$ref": "#/components/examples/InternalServerError"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/customers/{customerId}": {
            "delete": {
                "tags": [
                    "Admin - Customers"
                ],
                "summary": "Delete customer",
                "description": "Delete customer with all his prepaid cards\n## Security\nROLE_DELETE_CUSTOMER is required to access this method",
                "operationId": "a8685dc360e281249105dfc5165ceb47",
                "parameters": [
                    {
                        "name": "customerId",
                        "in": "path",
                        "description": "DataCore user id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": "1125"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "CUSTOMER_NOT_FOUND"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "CANT_DELETE_CUSTOMER"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/customers/{customerId}/documents": {
            "get": {
                "tags": [
                    "Admin - Customers"
                ],
                "summary": "Get customer documents",
                "description": "\n## Security\nROLE_READ_DOCUMENT is required to access this method",
                "operationId": "getCustomerDocuments",
                "parameters": [
                    {
                        "name": "customerId",
                        "in": "path",
                        "description": "Id of customer",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/CustomerDocumentDto"
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CustomerNotFound"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/upload": {
            "post": {
                "tags": [
                    "Admin - Verifications"
                ],
                "summary": "Upload document",
                "description": "Method upload document and return file path </br> You can use this method after accepting user registration\n## Security\nROLE_UPLOAD_DOCUMENT is required to access this method",
                "operationId": "85966fe3807b1214a57ca02ad859fc9f",
                "requestBody": {
                    "content": {
                        "multipart/form-data": {
                            "schema": {
                                "required": [
                                    "document"
                                ],
                                "properties": {
                                    "document": {
                                        "description": "Document, allowed formats: jpeg, jpg, png, pdf, p7m. Maximum file size - 2MB",
                                        "type": "string",
                                        "format": "binary"
                                    }
                                },
                                "type": "object"
                            },
                            "encoding": "form-data"
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "path": {
                                            "type": "string",
                                            "example": "vfBQAtG4uXIWMtTtYYRxvLhP6AaFuCY9nhUzaN1s.pdf"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/locks": {
            "get": {
                "tags": [
                    "Admin - Locks"
                ],
                "summary": "Retrive list of resource locks",
                "description": "Allows to get paginated list of resource locks. Query filter are allowed along with SortBy, OrderBy\n## Security\nROLE_READ_RESOURCE_LOCK is required to access this method",
                "operationId": "b311abfd4a356a72dce96f24e5b47b47",
                "parameters": [
                    {
                        "name": "resourceType",
                        "in": "query",
                        "description": "Resource type to filter by",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "customer",
                                "corporation"
                            ],
                            "example": "customer"
                        }
                    },
                    {
                        "name": "resourceId",
                        "in": "query",
                        "description": "Resource identifier to filter by",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "1337"
                        }
                    },
                    {
                        "name": "createdAt",
                        "in": "query",
                        "description": "Date when the resource was blocked. Allowed format Y-m-d H:i:s ",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "2020-01-01 12:00:00"
                        }
                    },
                    {
                        "name": "reason",
                        "in": "query",
                        "description": "Lock reason to filter by",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "DOCUMENT_EXPIRED",
                                "FRAUD_SUSPECTED",
                                "SCREENING_DETECTED",
                                "TEMPORARY_LOCKED",
                                "PEKAO_LOCK",
                                "ZEN_LOCK",
                                "PROSECUTOR_LOCK",
                                "FENIGE_LOCK",
                                "POLICE_LOCK",
                                "MANY_CARDS_LOCK",
                                "NEGATIVE_VERIFICATION",
                                "PRADO_VERIFICATION"
                            ],
                            "example": "DOCUMENT_EXPIRED"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/LockCollection"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Admin - Locks"
                ],
                "summary": "Create resource lock",
                "description": "Allows to add resource lock.\n## Security\nROLE_WRITE_RESOURCE_LOCK is required to access this method",
                "operationId": "7311198aa1459436e345933a4eef8d89",
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "resourceType": {
                                        "description": "Type of resource to be locked",
                                        "type": "string",
                                        "enum": [
                                            "customer",
                                            "corporation",
                                            "verification"
                                        ],
                                        "example": "customer"
                                    },
                                    "resourceId": {
                                        "description": "Resource identifier (verificationId when resourceType=verification)",
                                        "type": "string",
                                        "example": "1337"
                                    },
                                    "reason": {
                                        "description": "reason of resource lock",
                                        "type": "string",
                                        "enum": [
                                            "DOCUMENT_EXPIRED",
                                            "FRAUD_SUSPECTED",
                                            "SCREENING_DETECTED",
                                            "TEMPORARY_LOCKED",
                                            "PEKAO_LOCK",
                                            "ZEN_LOCK",
                                            "PROSECUTOR_LOCK",
                                            "FENIGE_LOCK",
                                            "POLICE_LOCK",
                                            "MANY_CARDS_LOCK",
                                            "NEGATIVE_VERIFICATION",
                                            "PRADO_VERIFICATION"
                                        ],
                                        "example": "DOCUMENT_EXPIRED"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/LockResource"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "ResourceNotFound": {
                                        "$ref": "#/components/examples/ResourceNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidResourceType": {
                                        "$ref": "#/components/examples/InvalidResourceType"
                                    },
                                    "InvalidResourceId": {
                                        "$ref": "#/components/examples/InvalidResourceId"
                                    },
                                    "InvalidReason": {
                                        "$ref": "#/components/examples/InvalidReason"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/locks/{lockId}": {
            "delete": {
                "tags": [
                    "Admin - Locks"
                ],
                "summary": "Delete resource lock",
                "description": "Allows to remove resource lock.\n## Security\nROLE_DELETE_RESOURCE_LOCK is required to access this method",
                "operationId": "9b1297d6092ed9c6b4a0fb6415f468b3",
                "parameters": [
                    {
                        "name": "lockId",
                        "in": "path",
                        "description": "Lock identifier",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "492ec5ee-7f66-11ec-a8a3-0242ac120002"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    }
                }
            }
        },
        "/admin/daily_settlements/download": {
            "post": {
                "tags": [
                    "Admin - Transactions"
                ],
                "summary": "Retrive settlement report",
                "description": "Allows to delegate downloading report for given terminal and date.\n## Security\nROLE_DOWNLOAD_SETTLEMENT is required to access this method",
                "operationId": "0c291031302443b8e6daf348422e7629",
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "date": {
                                        "description": "Specify date of report to be downloaded. Allowed format: Y-m-d",
                                        "type": "string",
                                        "format": "date",
                                        "example": "2020-01-01"
                                    },
                                    "configId": {
                                        "description": "Specify configuration identifier (can be obtained from method: /customers/me/cards/config).",
                                        "type": "string",
                                        "example": "0013009713"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "422": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidConfiguration": {
                                        "$ref": "#/components/examples/InvalidConfiguration"
                                    },
                                    "DateIsInvalid": {
                                        "$ref": "#/components/examples/DateIsInvalid"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/daily_settlements/{settlementId}": {
            "get": {
                "tags": [
                    "Admin - Transactions"
                ],
                "summary": "Retrive settlement details",
                "description": "Allows to get details of settlement.\n## Security\nROLE_READ_SETTLEMENT is required to access this method",
                "operationId": "7e124167183fd159fe7c3fe5a967a545",
                "parameters": [
                    {
                        "name": "settlementId",
                        "in": "path",
                        "description": "Settlement internal identifier",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid",
                            "example": "97eee13e-7669-11eb-9439-0242ac130002"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DailySettlementDetails"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "SettlementNotFound": {
                                        "$ref": "#/components/examples/SettlementNotFound"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/daily_settlements": {
            "get": {
                "tags": [
                    "Admin - Transactions"
                ],
                "summary": "Retrive list of settlements",
                "description": "Allows to get paginated list of settlements. Query filters are allowed to narrow down results.\n## Security\nROLE_READ_SETTLEMENT is required to access this method",
                "operationId": "39dd7f13147b2b4cf5c12cff35aa24fc",
                "parameters": [
                    {
                        "name": "from",
                        "in": "query",
                        "description": "Filter by transaction date. Get settlements related to transactions performed after specified date. Allowed format: Y-m-d H:i:s",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2020-01-01 12:00:00"
                        }
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "description": "Filter by transaction date. Get settlements related to transactions performed before specified date. Allowed format: Y-m-d H:i:s",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2020-01-01 12:30:00"
                        }
                    },
                    {
                        "name": "cardId",
                        "in": "query",
                        "description": "Filter by DataCore card id",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": "7"
                        }
                    },
                    {
                        "name": "configId",
                        "in": "query",
                        "description": "Filter by configuration identifier (can be obtained from method: /customers/me/cards/config).",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "0013009713"
                        }
                    },
                    {
                        "name": "externalId",
                        "in": "query",
                        "description": "Transaction external id.",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "53929234022"
                        }
                    },
                    {
                        "name": "processed",
                        "in": "query",
                        "description": "Filter by fact settlement has been processed. When filter value is:\n * true - processed settlements are returne\n * false - not processed settlements are returned\n * not set - both processed and not processed settlements are returned",
                        "required": false,
                        "schema": {
                            "type": "bool",
                            "example": 1
                        }
                    },
                    {
                        "name": "currency",
                        "in": "query",
                        "description": "Currency in 3 letter ISO-4217",
                        "schema": {
                            "type": "string",
                            "example": "PLN"
                        }
                    },
                    {
                        "name": "amount",
                        "in": "query",
                        "description": "Transaction amount",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": 100
                        }
                    },
                    {
                        "name": "merchantName",
                        "in": "query",
                        "description": "Merchant name",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "Stonka"
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "description": "Field to order list by. Transactions are ordered by id by default.",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "transactionDate",
                                "processedAt"
                            ]
                        }
                    },
                    {
                        "name": "order",
                        "in": "query",
                        "description": "Sorting order",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "ASC",
                                "DESC"
                            ]
                        }
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "description": "Limit of transactions returned in a single chunk can be specified.",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": 20
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page of paginated list",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": 3
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DailySettlementCollection"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "DateFormatIsInvalid": {
                                        "$ref": "#/components/examples/DateFormatIsInvalid"
                                    },
                                    "ValueHasToBeString": {
                                        "summary": "VALUE_HAS_TO_BE_STRING",
                                        "value": {
                                            "status": "VALUE_HAS_TO_BE_STRING"
                                        }
                                    },
                                    "ValueMustBeIntegerType": {
                                        "summary": "VALUE_MUST_BE_INTEGER_TYPE",
                                        "value": {
                                            "status": "VALUE_MUST_BE_INTEGER_TYPE"
                                        }
                                    },
                                    "ValueIsNotAllowed": {
                                        "summary": "VALUE_IS_NOT_ALLOWED",
                                        "value": {
                                            "status": "VALUE_IS_NOT_ALLOWED"
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/report/transactions": {
            "get": {
                "tags": [
                    "Admin - Transactions report"
                ],
                "summary": "Retrive transactions report file",
                "description": "Allows to export list of transactions. Query filters are allowed to narrow down results.\n## Security\nROLE_REPORT_TRANSACTION is required to access this method",
                "operationId": "2978a079d4397c2d86e0f337d931c8f1",
                "parameters": [
                    {
                        "name": "format",
                        "in": "query",
                        "description": "Report file format. Default is csv. PDF export is limited to 1000 rows; use csv or xlsx for larger result sets.",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "json",
                                "csv",
                                "xlsx",
                                "pdf"
                            ],
                            "example": "csv"
                        }
                    },
                    {
                        "name": "from",
                        "in": "query",
                        "description": "Filter by transaction date. Get transactions performed after specified date. Minimal value is three months back from TO date. Allowed format: Y-m-d H:i:s",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2020-01-01 12:00:00"
                        }
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "description": "Filter by transaction date. Get transactions performed before specified date. Allowed format: Y-m-d H:i:s",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2020-01-01 12:30:00"
                        }
                    },
                    {
                        "name": "cardId",
                        "in": "query",
                        "description": "Filter by DataCore card id",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": "7"
                        }
                    },
                    {
                        "name": "configId",
                        "in": "query",
                        "description": "Filter by configuration identifier (can be obtained from method: /customers/me/cards/config).",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "0013009713"
                        }
                    },
                    {
                        "name": "customerId",
                        "in": "query",
                        "description": "Filter by DataCore user id",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": "10181"
                        }
                    },
                    {
                        "name": "eventType",
                        "in": "query",
                        "description": "Filter by transaction event type",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "Deduct",
                                "DeductAdjustment",
                                "LoadAdjustment",
                                "LoadAuth",
                                "credit",
                                "debit"
                            ],
                            "example": "Deduct"
                        }
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "description": "Filter by transaction type",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "cashback",
                                "commission",
                                "creditIbanTransfer",
                                "fee",
                                "funding",
                                "interest",
                                "loan",
                                "payment",
                                "topUp",
                                "withdrawal",
                                "companyCredit",
                                "companyDebit",
                                "collateralCredit",
                                "collateralDebit",
                                "collateralForcedDebit",
                                "ibanTechnicalCredit",
                                "ibanTechnicalDebit",
                                "forexDebit",
                                "forexCredit",
                                "interchangeDebit",
                                "interchangeCredit"
                            ],
                            "example": "fee"
                        }
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "description": "Filter by status of transaction",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "AUTHORIZED",
                                "CLEARED",
                                "REVERSED",
                                "ERROR"
                            ],
                            "example": "AUTHORIZED"
                        }
                    },
                    {
                        "name": "balanceId",
                        "in": "query",
                        "description": "Filter by balanceId",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "f7285bb5-b7f2-4478-b3b9-f6fb4cddd9b6"
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "description": "Field to order list by. Transactions are ordered by id by default.",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "transactionDate"
                            ]
                        }
                    },
                    {
                        "name": "order",
                        "in": "query",
                        "description": "Sorting order",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "ASC",
                                "DESC"
                            ]
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ExportedReport"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "PDF export exceeds the 1000 row limit (status: PDF_ROW_LIMIT_EXCEEDED). Use csv or xlsx instead."
                    }
                }
            }
        },
        "/admin/transactions/batch": {
            "post": {
                "tags": [
                    "Admin - Transactions"
                ],
                "summary": "Create a batch of transactions",
                "description": "Executes a batch of transactions (currently limited to 2), in the exact order they are provided in the request\n\n## Transaction type and resource compatibility\nThe `resource` value in each transaction must match its `transactionType`:\n\n| Transaction type | Allowed resource |\n| --- | --- |\n| `cashback`, `commission`, `fee`, `funding`, `interest`, `loan`, `payment`, `topUp`, `withdrawal` | `card`, `balance` |\n| `creditIbanTransfer`, `debitIbanTransferReversal`, `debitIbanTransfer`, `debitIbanTransferAuthorization`, `forcedCredit`, `forcedDebit` | `balance` |\n| `companyCredit`, `companyDebit` | `companyBalance` |\n| `collateralCredit`, `collateralDebit`, `collateralForcedDebit` | `creditBalance`, `depositBalance` |\n| `ibanTechnicalCredit`, `ibanTechnicalDebit` | `ibanTechnicalBalance` |\n\n## Content Negotiation\nThis endpoint supports content negotiation through the Accept header:\n- `application/json`: Returns standard response with transaction ID only\n- `application/vnd.aml.v1+json`: Returns extended response with AML verification data\n\n## Caution\nThe operation is atomic: if any transaction within the batch fails, none of the transactions will be executed.\n## Security\nROLE_CLEAR_TRANSACTION is required to access this method",
                "operationId": "5ff2f23f88dcc3cd9076e324c4d91df2",
                "parameters": [
                    {
                        "name": "X-Idempotency-Key",
                        "in": "header",
                        "schema": {
                            "type": "string",
                            "example": "a00ca5ef-c0c1-48c2-a147-6300f66dc6c8"
                        }
                    },
                    {
                        "name": "Accept",
                        "in": "header",
                        "description": "Media type(s) that is/are acceptable for the response",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "application/json",
                                "application/vnd.aml.v1+json"
                            ],
                            "example": "application / vnd . aml . v1 + json"
                        }
                    }
                ],
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "transactions": {
                                        "type": "array",
                                        "items": {
                                            "required": [
                                                "amount",
                                                "currency",
                                                "transactionType",
                                                "resource",
                                                "resourceId"
                                            ],
                                            "properties": {
                                                "transactionId": {
                                                    "description": "Transaction unique identifier (optional)",
                                                    "type": "string",
                                                    "example": "f4f98e6b-2241-4780-827a-42f219e5b36c"
                                                },
                                                "externalTransactionId": {
                                                    "description": "Identifier of the external transaction sent by the API client. This value may not be unique.",
                                                    "type": "string",
                                                    "example": "3aea9c27-d30f-4b25-8482-39a3ee6abc53"
                                                },
                                                "amount": {
                                                    "description": "Value of transaction in minor units",
                                                    "type": "integer",
                                                    "example": 10000
                                                },
                                                "currency": {
                                                    "description": "Valid three letter ISO 4217 currency code",
                                                    "type": "string",
                                                    "example": "EUR"
                                                },
                                                "description": {
                                                    "description": "Description (optional)",
                                                    "type": "string",
                                                    "example": "credit transaction"
                                                },
                                                "transactionType": {
                                                    "description": "Type of transaction",
                                                    "type": "string",
                                                    "enum": [
                                                        "cashback",
                                                        "creditIbanTransfer",
                                                        "debitIbanTransferReversal",
                                                        "loan",
                                                        "payment",
                                                        "topUp",
                                                        "collateralCredit",
                                                        "masterBalanceCredit",
                                                        "companyCredit",
                                                        "ibanTechnicalCredit",
                                                        "forcedCredit",
                                                        "cardCollateralCredit",
                                                        "commission",
                                                        "fee",
                                                        "funding",
                                                        "interest",
                                                        "withdrawal",
                                                        "collateralDebit",
                                                        "masterBalanceDebit",
                                                        "collateralForcedDebit",
                                                        "companyDebit",
                                                        "ibanTechnicalDebit",
                                                        "debitIbanTransfer",
                                                        "debitIbanTransferAuthorization",
                                                        "forcedDebit",
                                                        "cardCollateralDebit"
                                                    ],
                                                    "example": "payment"
                                                },
                                                "resource": {
                                                    "description": "Resource used to identify the balance affected by the transaction. See the compatibility table in the endpoint description.",
                                                    "type": "string",
                                                    "enum": [
                                                        "card",
                                                        "balance",
                                                        "companyBalance",
                                                        "creditBalance",
                                                        "depositBalance",
                                                        "ibanTechnicalBalance"
                                                    ],
                                                    "example": "balance"
                                                },
                                                "resourceId": {
                                                    "description": "ID of the resource (e.g. balance ID or card ID)",
                                                    "type": "string",
                                                    "example": "0cbc4f1b-92ea-4b4d-b19b-18fc0fcb6d86"
                                                },
                                                "referenceTransactionId": {
                                                    "description": "Reference transactionId (optional)",
                                                    "type": "string",
                                                    "example": "207cda94-8d10-4e0f-a341-239d5cf3b5df"
                                                },
                                                "subType": {
                                                    "description": "Subtype of the transaction, reflecting business intent. UPPER_SNAKE_CASE, max 64 characters. Optional: when provided, the value is stored and published on the transaction contract as given; when omitted or null, it is derived from `transactionType` as before.",
                                                    "type": "string",
                                                    "example": "ATM_WITHDRAWAL",
                                                    "nullable": "true"
                                                },
                                                "transactionCustomData": {
                                                    "description": "Additional data about transaction",
                                                    "type": "string",
                                                    "example": "XYZ:123",
                                                    "nullable": "true"
                                                },
                                                "customData": {
                                                    "description": "Additional custom data about transaction",
                                                    "properties": {
                                                        "key1": {
                                                            "description": "Custom data about transaction",
                                                            "type": "string",
                                                            "example": "some value-123",
                                                            "nullable": "true"
                                                        }
                                                    },
                                                    "type": "object"
                                                },
                                                "contrahent": {
                                                    "description": "Contrahent data",
                                                    "properties": {
                                                        "name": {
                                                            "description": "Contrahent name",
                                                            "type": "string",
                                                            "example": "John Smith"
                                                        },
                                                        "iban": {
                                                            "description": "Contrahent iban number",
                                                            "type": "string",
                                                            "example": "PL12109024027243667461166868"
                                                        },
                                                        "bic": {
                                                            "description": "Contrahent bic code",
                                                            "type": "string",
                                                            "example": "BPKOPLPW"
                                                        }
                                                    },
                                                    "type": "object"
                                                }
                                            },
                                            "type": "object"
                                        }
                                    }
                                },
                                "type": "object",
                                "example": {
                                    "transactions": [
                                        {
                                            "transactionId": "f4f98e6b-2241-4780-827a-42f219e5b36c",
                                            "amount": 10000,
                                            "currency": "EUR",
                                            "description": "credit transaction",
                                            "transactionType": "payment",
                                            "resource": "balance",
                                            "resourceId": "0cbc4f1b-92ea-4b4d-b19b-18fc0fcb6d86",
                                            "referenceTransactionId": "207cda94-8d10-4e0f-a341-239d5cf3b5df"
                                        },
                                        {
                                            "transactionId": "10a92285-e734-4122-8eff-3c3abb42933b",
                                            "amount": 10000,
                                            "currency": "EUR",
                                            "description": "debit transaction",
                                            "transactionType": "funding",
                                            "resource": "balance",
                                            "resourceId": "0cbc4f1b-92ea-4b4d-b19b-18fc0fcb6d86",
                                            "referenceTransactionId": "9405cb31-94ec-4b7a-b1fc-ee026a42f0c0"
                                        }
                                    ]
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Successful operation",
                        "headers": {
                            "Content-Type": {
                                "description": "Response content type based on Accept header",
                                "schema": {
                                    "type": "string",
                                    "enum": [
                                        "application/json",
                                        "application/vnd.aml.v1+json"
                                    ]
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "oneOf": [
                                        {
                                            "description": "Standard response (Accept: application/json)",
                                            "type": "array",
                                            "items": {
                                                "properties": {
                                                    "id": {
                                                        "description": "Transaction ID",
                                                        "type": "string",
                                                        "example": "3aea9c27-d30f-4b25-8482-39a3ee6abc54"
                                                    },
                                                    "type": {
                                                        "description": "Transaction type (credit or debit)",
                                                        "type": "string",
                                                        "enum": [
                                                            "credit",
                                                            "debit"
                                                        ],
                                                        "example": "credit"
                                                    }
                                                },
                                                "type": "object"
                                            }
                                        },
                                        {
                                            "description": "AML v1 response (Accept: application/vnd.aml.v1+json)",
                                            "type": "array",
                                            "items": {
                                                "properties": {
                                                    "id": {
                                                        "type": "string",
                                                        "example": "uuid-transaction-id"
                                                    },
                                                    "type": {
                                                        "type": "string",
                                                        "enum": [
                                                            "credit",
                                                            "debit"
                                                        ],
                                                        "example": "credit"
                                                    },
                                                    "amlVerification": {
                                                        "properties": {
                                                            "verificationId": {
                                                                "type": "string",
                                                                "example": "uuid"
                                                            },
                                                            "result": {
                                                                "type": "string"
                                                            },
                                                            "actions": {
                                                                "type": "array",
                                                                "items": {
                                                                    "type": "string"
                                                                }
                                                            }
                                                        },
                                                        "type": "object"
                                                    }
                                                },
                                                "type": "object"
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Transaction Conflict",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InsufficientFunds": {
                                        "$ref": "#/components/examples/InsufficientFunds"
                                    },
                                    "CardLimitExceeded": {
                                        "$ref": "#/components/examples/CardLimitExceeded"
                                    },
                                    "CurrencyDifferenceError": {
                                        "$ref": "#/components/examples/CurrencyDifferenceError"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidCurrency": {
                                        "$ref": "#/components/examples/InvalidCurrency"
                                    },
                                    "InvalidAmount": {
                                        "$ref": "#/components/examples/InvalidAmount"
                                    },
                                    "InvalidTransactionType": {
                                        "$ref": "#/components/examples/InvalidTransactionType"
                                    },
                                    "InvalidDescription": {
                                        "$ref": "#/components/examples/InvalidDescription"
                                    },
                                    "InvalidResourceId": {
                                        "$ref": "#/components/examples/InvalidResourceId"
                                    },
                                    "InvalidTransactionId": {
                                        "$ref": "#/components/examples/InvalidTransactionId"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/transactions/credit": {
            "post": {
                "tags": [
                    "Admin - Transactions"
                ],
                "summary": "Method to create credit transaction",
                "description": "Method makes credit transaction on balance found by given resource\n\n## Transaction type and resource compatibility\nThe `resource` value must match the selected `transactionType`:\n\n| Transaction type | Allowed resource |\n| --- | --- |\n| `cashback`, `loan`, `payment`, `topUp` | `card`, `balance` |\n| `creditIbanTransfer`, `debitIbanTransferReversal`, `forcedCredit` | `balance` |\n| `companyCredit` | `companyBalance` |\n| `collateralCredit` | `creditBalance`, `depositBalance` |\n| `masterBalanceCredit`, `cardCollateralCredit` | `depositBalance` |\n| `ibanTechnicalCredit` | `ibanTechnicalBalance` |\n\n## Content Negotiation\nThis endpoint supports content negotiation through the Accept header:\n- `application/json`: Returns standard response with transaction ID only\n- `application/vnd.aml.v1+json`: Returns extended response with AML verification data\n\n## Security\nROLE_CREATE_CREDIT_TRANSACTION is required to access this method (falls back to ROLE_CLEAR_TRANSACTION when not set); the transaction type must additionally be allowed for the role (ROLE_CREATE_<TYPE>_TRANSACTION)",
                "operationId": "ce6f80f0c1e53f5fc2f8db0f8df368ba",
                "parameters": [
                    {
                        "name": "X-Idempotency-Key",
                        "in": "header",
                        "schema": {
                            "type": "string",
                            "example": "a00ca5ef-c0c1-48c2-a147-6300f66dc6c8"
                        }
                    },
                    {
                        "name": "Accept",
                        "in": "header",
                        "description": "Media type(s) that is/are acceptable for the response",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "application/json",
                                "application/vnd.aml.v1+json"
                            ],
                            "example": "application / vnd . aml . v1 + json"
                        }
                    }
                ],
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "transactionType",
                                    "amount",
                                    "resource",
                                    "resourceId",
                                    "currency"
                                ],
                                "properties": {
                                    "transactionType": {
                                        "description": "Type of credit transaction",
                                        "type": "string",
                                        "enum": [
                                            "cashback",
                                            "creditIbanTransfer",
                                            "debitIbanTransferReversal",
                                            "loan",
                                            "payment",
                                            "topUp",
                                            "collateralCredit",
                                            "masterBalanceCredit",
                                            "companyCredit",
                                            "ibanTechnicalCredit",
                                            "forcedCredit",
                                            "cardCollateralCredit"
                                        ],
                                        "example": "topUp"
                                    },
                                    "transactionId": {
                                        "description": "Identifier of the transaction sent by the API client. This may not be a unique value.",
                                        "type": "string",
                                        "example": "3aea9c27-d30f-4b25-8482-39a3ee6abc53"
                                    },
                                    "externalTransactionId": {
                                        "description": "Identifier of the external transaction sent by the API client. This value may not be unique.",
                                        "type": "string",
                                        "example": "3aea9c27-d30f-4b25-8482-39a3ee6abc53"
                                    },
                                    "amount": {
                                        "description": "Value of transaction in minor value",
                                        "type": "integer",
                                        "example": "1234"
                                    },
                                    "currency": {
                                        "description": "Valid three letter ISO 4217 currency code.",
                                        "type": "string",
                                        "example": "PLN"
                                    },
                                    "description": {
                                        "description": "Description of transaction",
                                        "type": "string",
                                        "example": "Card transaction *1234 of 24.12.2024"
                                    },
                                    "resource": {
                                        "description": "Resource used to identify the balance affected by the transaction. See the compatibility table in the endpoint description.",
                                        "type": "string",
                                        "enum": [
                                            "card",
                                            "balance",
                                            "companyBalance",
                                            "creditBalance",
                                            "depositBalance",
                                            "ibanTechnicalBalance"
                                        ],
                                        "example": "balance"
                                    },
                                    "resourceId": {
                                        "description": "Card Id or Balance Id",
                                        "type": "string",
                                        "example": "0cbc4f1b-92ea-4b4d-b19b-18fc0fcb6d86"
                                    },
                                    "referenceTransactionId": {
                                        "description": "Reference transactionId",
                                        "type": "string",
                                        "example": "0cbc4f1b-92ea-4b4d-b19b-18fc0fcb6d86"
                                    },
                                    "subType": {
                                        "description": "Subtype of the transaction, reflecting business intent. UPPER_SNAKE_CASE, max 64 characters. Optional: when provided, the value is stored and published on the transaction contract as given; when omitted or null, it is derived from `transactionType` as before.",
                                        "type": "string",
                                        "example": "ATM_WITHDRAWAL",
                                        "nullable": "true"
                                    },
                                    "transactionCustomData": {
                                        "description": "Additional data about transaction",
                                        "type": "string",
                                        "example": "XYZ:123",
                                        "nullable": "true"
                                    },
                                    "customData": {
                                        "description": "Additional custom data about transaction",
                                        "properties": {
                                            "key1": {
                                                "description": "Custom data about transaction",
                                                "type": "string",
                                                "example": "some value-123",
                                                "nullable": "true"
                                            }
                                        },
                                        "type": "object"
                                    },
                                    "contrahent": {
                                        "description": "Contrahent data",
                                        "properties": {
                                            "name": {
                                                "description": "Contrahent name",
                                                "type": "string",
                                                "example": "John Smith"
                                            },
                                            "iban": {
                                                "description": "Contrahent iban number",
                                                "type": "string",
                                                "example": "PL12109024027243667461166868"
                                            },
                                            "bic": {
                                                "description": "Contrahent bic code",
                                                "type": "string",
                                                "example": "BPKOPLPW"
                                            }
                                        },
                                        "type": "object"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Successful operation",
                        "headers": {
                            "Content-Type": {
                                "description": "Response content type based on Accept header",
                                "schema": {
                                    "type": "string"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "oneOf": [
                                        {
                                            "description": "Standard response (Accept: application/json)",
                                            "properties": {
                                                "id": {
                                                    "type": "string",
                                                    "example": "uuid-transaction-id"
                                                }
                                            },
                                            "type": "object"
                                        },
                                        {
                                            "description": "AML v1 response (Accept: application/vnd.aml.v1+json)",
                                            "properties": {
                                                "id": {
                                                    "type": "string",
                                                    "example": "uuid-transaction-id"
                                                },
                                                "amlVerification": {
                                                    "properties": {
                                                        "verificationId": {
                                                            "type": "string"
                                                        },
                                                        "result": {
                                                            "type": "string"
                                                        },
                                                        "actions": {
                                                            "type": "array",
                                                            "items": {
                                                                "type": "string"
                                                            }
                                                        }
                                                    },
                                                    "type": "object"
                                                }
                                            },
                                            "type": "object"
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "406": {
                        "description": "Not Acceptable - Unsupported Accept header",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "error": {
                                            "type": "string",
                                            "example": "Not Acceptable"
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Supported media types: application/json, application/vnd.aml.v1+json"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CustomerNotFound": {
                                        "$ref": "#/components/examples/CustomerNotFound"
                                    },
                                    "ResourceNotFound": {
                                        "$ref": "#/components/examples/ResourceNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Transaction Conflict",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "FraudSuspected": {
                                        "$ref": "#/components/examples/FraudSuspected"
                                    },
                                    "InsufficientFunds": {
                                        "$ref": "#/components/examples/InsufficientFunds"
                                    },
                                    "CardLimitExceeded": {
                                        "$ref": "#/components/examples/CardLimitExceeded"
                                    },
                                    "CurrencyDifferenceError": {
                                        "$ref": "#/components/examples/CurrencyDifferenceError"
                                    },
                                    "TransactionIdConflict": {
                                        "$ref": "#/components/examples/TransactionIdConflict"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidId": {
                                        "$ref": "#/components/examples/InvalidId"
                                    },
                                    "InvalidCurrency": {
                                        "$ref": "#/components/examples/InvalidCurrency"
                                    },
                                    "InvalidAmount": {
                                        "$ref": "#/components/examples/InvalidAmount"
                                    },
                                    "InvalidTransactionType": {
                                        "$ref": "#/components/examples/InvalidTransactionType"
                                    },
                                    "InvalidDescription": {
                                        "$ref": "#/components/examples/InvalidDescription"
                                    },
                                    "InvalidResource": {
                                        "$ref": "#/components/examples/InvalidResource"
                                    },
                                    "InvalidTransactionId": {
                                        "$ref": "#/components/examples/InvalidTransactionId"
                                    },
                                    "InvalidExternalTransactionId": {
                                        "$ref": "#/components/examples/InvalidExternalTransactionId"
                                    },
                                    "InvalidContrahentData": {
                                        "$ref": "#/components/examples/InvalidContrahentData"
                                    },
                                    "BalanceDisabled": {
                                        "$ref": "#/components/examples/BalanceDisabled"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/transactions/debit": {
            "post": {
                "tags": [
                    "Admin - Transactions"
                ],
                "summary": "Method to create debit transaction",
                "description": "Method makes debit transaction on balance found by given resource\n\n## Transaction type and resource compatibility\nThe `resource` value must match the selected `transactionType`:\n\n| Transaction type | Allowed resource |\n| --- | --- |\n| `commission`, `fee`, `funding`, `interest`, `withdrawal` | `card`, `balance` |\n| `debitIbanTransfer`, `debitIbanTransferAuthorization`, `forcedDebit` | `balance` |\n| `companyDebit` | `companyBalance` |\n| `collateralDebit`, `collateralForcedDebit` | `creditBalance`, `depositBalance` |\n| `masterBalanceDebit`, `cardCollateralDebit` | `depositBalance` |\n| `ibanTechnicalDebit` | `ibanTechnicalBalance` |\n\n## Content Negotiation\nThis endpoint supports content negotiation through the Accept header:\n- `application/json`: Returns standard response with transaction ID only\n- `application/vnd.aml.v1+json`: Returns extended response with AML verification data\n\n## Security\nROLE_CREATE_DEBIT_TRANSACTION is required to access this method (falls back to ROLE_CLEAR_TRANSACTION when not set); the transaction type must additionally be allowed for the role (ROLE_CREATE_<TYPE>_TRANSACTION)",
                "operationId": "d33b9ebce5c8d376a10573d2b246ed3e",
                "parameters": [
                    {
                        "name": "X-Idempotency-Key",
                        "in": "header",
                        "schema": {
                            "type": "string",
                            "example": "a00ca5ef-c0c1-48c2-a147-6300f66dc6c8"
                        }
                    },
                    {
                        "name": "Accept",
                        "in": "header",
                        "description": "Media type(s) that is/are acceptable for the response",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "application/json",
                                "application/vnd.aml.v1+json"
                            ],
                            "example": "application / vnd . aml . v1 + json"
                        }
                    }
                ],
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "transactionType",
                                    "amount",
                                    "resource",
                                    "resourceId",
                                    "currency"
                                ],
                                "properties": {
                                    "transactionType": {
                                        "description": "Type of debit transaction",
                                        "type": "string",
                                        "enum": [
                                            "commission",
                                            "fee",
                                            "funding",
                                            "interest",
                                            "withdrawal",
                                            "collateralDebit",
                                            "masterBalanceDebit",
                                            "collateralForcedDebit",
                                            "companyDebit",
                                            "ibanTechnicalDebit",
                                            "debitIbanTransfer",
                                            "debitIbanTransferAuthorization",
                                            "forcedDebit",
                                            "cardCollateralDebit"
                                        ],
                                        "example": "fee"
                                    },
                                    "transactionId": {
                                        "description": "Identifier of the transaction sent by the API client. This value may be unique.",
                                        "type": "string",
                                        "example": "3aea9c27-d30f-4b25-8482-39a3ee6abc53"
                                    },
                                    "externalTransactionId": {
                                        "description": "Identifier of the external transaction sent by the API client. This value may not be unique.",
                                        "type": "string",
                                        "example": "3aea9c27-d30f-4b25-8482-39a3ee6abc53"
                                    },
                                    "amount": {
                                        "description": "Value of transaction in minor value",
                                        "type": "integer",
                                        "example": "1234"
                                    },
                                    "currency": {
                                        "description": "Valid three letter ISO 4217 currency code.",
                                        "type": "string",
                                        "example": "PLN"
                                    },
                                    "description": {
                                        "description": "Description of transaction",
                                        "type": "string",
                                        "example": "Card transaction *1234 of 24.12.2024"
                                    },
                                    "resource": {
                                        "description": "Resource used to identify the balance affected by the transaction. See the compatibility table in the endpoint description.",
                                        "type": "string",
                                        "enum": [
                                            "card",
                                            "balance",
                                            "companyBalance",
                                            "creditBalance",
                                            "depositBalance",
                                            "ibanTechnicalBalance"
                                        ],
                                        "example": "balance"
                                    },
                                    "resourceId": {
                                        "description": "Card Id or Balance Id",
                                        "type": "string",
                                        "example": "0cbc4f1b-92ea-4b4d-b19b-18fc0fcb6d86"
                                    },
                                    "referenceTransactionId": {
                                        "description": "Reference transactionId",
                                        "type": "string",
                                        "example": "0cbc4f1b-92ea-4b4d-b19b-18fc0fcb6d86"
                                    },
                                    "subType": {
                                        "description": "Subtype of the transaction, reflecting business intent. UPPER_SNAKE_CASE, max 64 characters. Optional: when provided, the value is stored and published on the transaction contract as given; when omitted or null, it is derived from `transactionType` as before.",
                                        "type": "string",
                                        "example": "ATM_WITHDRAWAL",
                                        "nullable": "true"
                                    },
                                    "transactionCustomData": {
                                        "description": "Additional data about transaction",
                                        "type": "string",
                                        "example": "XYZ:123",
                                        "nullable": "true"
                                    },
                                    "customData": {
                                        "description": "Additional custom data about transaction",
                                        "properties": {
                                            "key1": {
                                                "description": "Custom data about transaction",
                                                "type": "string",
                                                "example": "some value-123",
                                                "nullable": "true"
                                            }
                                        },
                                        "type": "object"
                                    },
                                    "contrahent": {
                                        "description": "Contrahent data",
                                        "properties": {
                                            "name": {
                                                "description": "Contrahent name",
                                                "type": "string",
                                                "example": "John Smith"
                                            },
                                            "iban": {
                                                "description": "Contrahent iban number",
                                                "type": "string",
                                                "example": "PL12109024027243667461166868"
                                            },
                                            "bic": {
                                                "description": "Contrahent bic code",
                                                "type": "string",
                                                "example": "BPKOPLPW"
                                            }
                                        },
                                        "type": "object"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Successful operation",
                        "headers": {
                            "Content-Type": {
                                "description": "Response content type based on Accept header",
                                "schema": {
                                    "type": "string"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "oneOf": [
                                        {
                                            "description": "Standard response (Accept: application/json)",
                                            "properties": {
                                                "id": {
                                                    "type": "string",
                                                    "example": "uuid-transaction-id"
                                                }
                                            },
                                            "type": "object"
                                        },
                                        {
                                            "description": "AML v1 response (Accept: application/vnd.aml.v1+json)",
                                            "properties": {
                                                "id": {
                                                    "type": "string",
                                                    "example": "uuid-transaction-id"
                                                },
                                                "amlVerification": {
                                                    "properties": {
                                                        "verificationId": {
                                                            "type": "string",
                                                            "example": "aml-verification-123"
                                                        },
                                                        "result": {
                                                            "type": "string",
                                                            "example": "PASSED"
                                                        },
                                                        "actions": {
                                                            "type": "array",
                                                            "items": {
                                                                "type": "string"
                                                            },
                                                            "example": [
                                                                "MONITOR",
                                                                "REVIEW"
                                                            ]
                                                        }
                                                    },
                                                    "type": "object"
                                                }
                                            },
                                            "type": "object"
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "406": {
                        "description": "Not Acceptable - Unsupported Accept header",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "error": {
                                            "type": "string",
                                            "example": "Not Acceptable"
                                        },
                                        "message": {
                                            "type": "string",
                                            "example": "Supported media types: application/json, application/vnd.aml.v1+json"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CustomerNotFound": {
                                        "$ref": "#/components/examples/CustomerNotFound"
                                    },
                                    "ResourceNotFound": {
                                        "$ref": "#/components/examples/ResourceNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Transaction Conflict",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "FraudSuspected": {
                                        "$ref": "#/components/examples/FraudSuspected"
                                    },
                                    "InsufficientFunds": {
                                        "$ref": "#/components/examples/InsufficientFunds"
                                    },
                                    "CardLimitExceeded": {
                                        "$ref": "#/components/examples/CardLimitExceeded"
                                    },
                                    "CurrencyDifferenceError": {
                                        "$ref": "#/components/examples/CurrencyDifferenceError"
                                    },
                                    "TransactionIdConflict": {
                                        "$ref": "#/components/examples/TransactionIdConflict"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidId": {
                                        "$ref": "#/components/examples/InvalidId"
                                    },
                                    "InvalidCurrency": {
                                        "$ref": "#/components/examples/InvalidCurrency"
                                    },
                                    "InvalidAmount": {
                                        "$ref": "#/components/examples/InvalidAmount"
                                    },
                                    "InvalidTransactionType": {
                                        "$ref": "#/components/examples/InvalidTransactionType"
                                    },
                                    "InvalidDescription": {
                                        "$ref": "#/components/examples/InvalidDescription"
                                    },
                                    "InvalidResource": {
                                        "$ref": "#/components/examples/InvalidResource"
                                    },
                                    "InvalidTransactionId": {
                                        "$ref": "#/components/examples/InvalidTransactionId"
                                    },
                                    "InvalidExternalTransactionId": {
                                        "$ref": "#/components/examples/InvalidExternalTransactionId"
                                    },
                                    "InvalidContrahentData": {
                                        "$ref": "#/components/examples/InvalidContrahentData"
                                    },
                                    "BalanceDisabled": {
                                        "$ref": "#/components/examples/BalanceDisabled"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/transactions/{transactionId}": {
            "get": {
                "tags": [
                    "Admin - Transactions"
                ],
                "summary": "Retrive transaction details",
                "description": "Allows to get details of transaction and all coresponding transactionEvents.\n## Security\nROLE_READ_TRANSACTION_DETAILS is required to access this method",
                "operationId": "7e11354897c823731ed3d3ec17a3dfef",
                "parameters": [
                    {
                        "name": "transactionId",
                        "in": "path",
                        "description": "Transaction internal identifier",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid",
                            "example": "5a5b253b-ac14-4566-a89f-8c5d26544c4e"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TransactionDetails"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "TransactionNotFound": {
                                        "$ref": "#/components/examples/TransactionNotFound"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/balances/credit/{balanceId}/transactions": {
            "get": {
                "tags": [
                    "Admin - Master Balance"
                ],
                "summary": "Get transactions done on credit balance resource",
                "description": "Use this method to get list of trasactions done on credit balance.\n## Security\nROLE_READ_MASTER_BALANCE_TRANSACTIONS is required to access this method",
                "operationId": "4a6b2da470e3306700a0497398c05d43",
                "parameters": [
                    {
                        "name": "balanceId",
                        "in": "path",
                        "description": "Id of balance",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid",
                            "example": "3dc88ad5-7053-454b-bcb8-e067c436f17d"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CollateralBalanceTransactionCollection"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "MASTER_BALANCE_NOT_FOUND"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/balances/deposit/{balanceId}/transactions": {
            "get": {
                "tags": [
                    "Admin - Master Balance"
                ],
                "summary": "Get transactions done on deposit balance resource",
                "description": "Use this method to get list of trasactions done on deposit balance.\n## Security\nROLE_READ_MASTER_BALANCE_TRANSACTIONS is required to access this method",
                "operationId": "ea27c5a0af7ac67f62e082b5465ac6dd",
                "parameters": [
                    {
                        "name": "balanceId",
                        "in": "path",
                        "description": "Id of balance",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid",
                            "example": "3dc88ad5-7053-454b-bcb8-e067c436f17d"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CollateralBalanceTransactionCollection"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "MASTER_BALANCE_NOT_FOUND"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/transactions": {
            "get": {
                "tags": [
                    "Admin - Transactions"
                ],
                "summary": "Retrive list of transactions",
                "description": "Allows to get paginated list of transactions. Query filters are allowed to narrow down results. If **from** parameter is not provided, transactions from today's date will be displayed by default.\n## Security\nROLE_READ_TRANSACTION is required to access this method",
                "operationId": "4f2afde1920305fa050686813c6e1173",
                "parameters": [
                    {
                        "name": "from",
                        "in": "query",
                        "description": "Filter by transaction date. Get transactions performed after specified date. **If this parameter is not provided, transactions from today's date will be displayed by default.** Allowed format: Y-m-d H:i:s",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2020-01-01 12:00:00"
                        }
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "description": "Filter by transaction date. Get transactions performed before specified date. Allowed format: Y-m-d H:i:s",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2020-01-01 12:30:00"
                        }
                    },
                    {
                        "name": "cardId",
                        "in": "query",
                        "description": "Filter by DataCore card id",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": "7"
                        }
                    },
                    {
                        "name": "configId",
                        "in": "query",
                        "description": "Filter by configuration identifier (can be obtained from method: /customers/me/cards/config).",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "0013009713"
                        }
                    },
                    {
                        "name": "externalId",
                        "in": "query",
                        "description": "Transaction external id.",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "53929234022"
                        }
                    },
                    {
                        "name": "customerId",
                        "in": "query",
                        "description": "Filter by DataCore user id",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": "10181"
                        }
                    },
                    {
                        "name": "eventType",
                        "in": "query",
                        "description": "Filter by transaction type",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "Deduct",
                                "DeductAdjustment",
                                "LoadAdjustment",
                                "credit",
                                "debit"
                            ],
                            "example": "Deduct"
                        }
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "description": "Filter by status of transaction",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "AUTHORIZED",
                                "CLEARED",
                                "REVERSED"
                            ],
                            "example": "AUTHORIZED"
                        }
                    },
                    {
                        "name": "balanceId",
                        "in": "query",
                        "description": "Filter by balanceId",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "f7285bb5-b7f2-4478-b3b9-f6fb4cddd9b6"
                        }
                    },
                    {
                        "name": "currency",
                        "in": "query",
                        "description": "Currency in 3 letter ISO-4217",
                        "schema": {
                            "type": "string",
                            "example": "PLN"
                        }
                    },
                    {
                        "name": "amount",
                        "in": "query",
                        "description": "Transaction amount",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": 100
                        }
                    },
                    {
                        "name": "merchantName",
                        "in": "query",
                        "description": "Merchant name",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "Stonka"
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "description": "Field to order list by. Transactions are ordered by id by default.",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "transactionDate"
                            ]
                        }
                    },
                    {
                        "name": "order",
                        "in": "query",
                        "description": "Sorting order",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "ASC",
                                "DESC"
                            ]
                        }
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "description": "Limit of transactions returned in a single chunk can be specified.",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": 20
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "description": "Page of paginated list",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": 3
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TransactionCollection"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "DateFormatIsInvalid": {
                                        "$ref": "#/components/examples/DateFormatIsInvalid"
                                    },
                                    "ValueHasToBeString": {
                                        "summary": "VALUE_HAS_TO_BE_STRING",
                                        "value": {
                                            "status": "VALUE_HAS_TO_BE_STRING"
                                        }
                                    },
                                    "ValueMustBeIntegerType": {
                                        "summary": "VALUE_MUST_BE_INTEGER_TYPE",
                                        "value": {
                                            "status": "VALUE_MUST_BE_INTEGER_TYPE"
                                        }
                                    },
                                    "ValueIsNotAllowed": {
                                        "summary": "VALUE_IS_NOT_ALLOWED",
                                        "value": {
                                            "status": "VALUE_IS_NOT_ALLOWED"
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/transactions/load": {
            "post": {
                "tags": [
                    "Admin - Transactions"
                ],
                "summary": "Load transactions to read model",
                "description": "Endpoint that fills missing transactions in read model by calling the trx-read-model:load command\n## Security\nROLE_ADMIN is required to access this method",
                "operationId": "28bdc27961b3ae6c072ba2f763f32918",
                "requestBody": {
                    "description": "Date range or transaction IDs",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "from": {
                                        "description": "Start date for transaction sync (required unless ids is provided)",
                                        "type": "string",
                                        "format": "date",
                                        "example": "2024-01-01"
                                    },
                                    "to": {
                                        "description": "End date for transaction sync (optional, defaults to current date)",
                                        "type": "string",
                                        "format": "date",
                                        "example": "2024-12-31"
                                    },
                                    "ids": {
                                        "description": "Transaction IDs to sync (alternative to date range)",
                                        "type": "array",
                                        "items": {
                                            "type": "string",
                                            "format": "uuid"
                                        },
                                        "example": [
                                            "5a5b253b-ac14-4566-a89f-8c5d26544c4e",
                                            "6b6c364c-bd25-5677-b9af-9d6e37655d5f"
                                        ]
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "202": {
                        "description": "Accepted - command execution started"
                    },
                    "422": {
                        "description": "Validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/transactions/transfer": {
            "post": {
                "tags": [
                    "Admin - Transactions"
                ],
                "summary": "Method to create transfer transaction",
                "description": "Method makes transfer transaction on balance found by given resource\n\n## Transaction type and resource compatibility\nEach `resource` value must match the `transactionType` from the same `sender` or `receiver` object.\n\n### Sender\n\n| Transaction type | Allowed resource |\n| --- | --- |\n| `commission`, `fee`, `funding`, `interest`, `withdrawal` | `card`, `balance` |\n| `debitIbanTransfer` | `balance` |\n| `companyDebit` | `companyBalance` |\n| `collateralDebit`, `collateralForcedDebit` | `creditBalance`, `depositBalance` |\n| `ibanTechnicalDebit` | `ibanTechnicalBalance` |\n\n### Receiver\n\n| Transaction type | Allowed resource |\n| --- | --- |\n| `cashback`, `loan`, `payment`, `topUp` | `card`, `balance` |\n| `creditIbanTransfer` | `balance` |\n| `companyCredit` | `companyBalance` |\n| `collateralCredit` | `creditBalance`, `depositBalance` |\n| `ibanTechnicalCredit` | `ibanTechnicalBalance` |\n\n## Content Negotiation\nThis endpoint supports content negotiation through the Accept header:\n- `application/json`: Returns standard response with transaction ID only\n- `application/vnd.aml.v1+json`: Returns extended response with AML verification data\n\n## Security\nROLE_CLEAR_TRANSACTION is required to access this method",
                "operationId": "e9a39dbe555d69a6e230cc598e5ae152",
                "parameters": [
                    {
                        "name": "X-Idempotency-Key",
                        "in": "header",
                        "schema": {
                            "type": "string",
                            "example": "a00ca5ef-c0c1-48c2-a147-6300f66dc6c8"
                        }
                    },
                    {
                        "name": "Accept",
                        "in": "header",
                        "description": "Media type(s) that is/are acceptable for the response",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "application/json",
                                "application/vnd.aml.v1+json"
                            ],
                            "example": "application / vnd . aml . v1 + json"
                        }
                    }
                ],
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [
                                    "amount"
                                ],
                                "properties": {
                                    "transactionId": {
                                        "description": "TransactionId",
                                        "type": "string",
                                        "example": "3aea9c27-d30f-4b25-8482-39a3ee6abc53",
                                        "deprecated": "true"
                                    },
                                    "transferId": {
                                        "description": "Identifier of the transaction transfer",
                                        "type": "string",
                                        "example": "3aea9c27-d30f-4b25-8482-39a3ee6abc53"
                                    },
                                    "amount": {
                                        "description": "Value of transaction in minor value",
                                        "type": "integer",
                                        "example": "1234"
                                    },
                                    "currency": {
                                        "description": "Valid three letter ISO 4217 currency code.",
                                        "type": "string",
                                        "example": "PLN"
                                    },
                                    "description": {
                                        "description": "Description of transaction",
                                        "type": "string",
                                        "example": "Card transaction *1234 of 24.12.2024"
                                    },
                                    "sender": {
                                        "required": [
                                            "resource",
                                            "resourceId",
                                            "transactionType"
                                        ],
                                        "properties": {
                                            "transactionId": {
                                                "description": "Identifier of the transaction. This must be a unique value",
                                                "type": "string",
                                                "example": "3aea9c27-d30f-4b25-8482-39a3ee6abc81"
                                            },
                                            "transactionType": {
                                                "description": "Type of sender transaction",
                                                "type": "string",
                                                "enum": [
                                                    "commission",
                                                    "fee",
                                                    "funding",
                                                    "interest",
                                                    "withdrawal",
                                                    "collateralDebit",
                                                    "collateralForcedDebit",
                                                    "companyDebit",
                                                    "ibanTechnicalDebit",
                                                    "debitIbanTransfer"
                                                ],
                                                "example": "funding"
                                            },
                                            "resource": {
                                                "description": "Resource used to identify the sender balance. See the compatibility tables in the endpoint description.",
                                                "type": "string",
                                                "enum": [
                                                    "card",
                                                    "balance",
                                                    "companyBalance",
                                                    "creditBalance",
                                                    "depositBalance",
                                                    "ibanTechnicalBalance"
                                                ],
                                                "example": "balance"
                                            },
                                            "resourceId": {
                                                "description": "Card Id or Balance Id",
                                                "type": "string",
                                                "example": "0cbc4f1b-92ea-4b4d-b19b-18fc0fcb6d86"
                                            },
                                            "transactionCustomData": {
                                                "description": "Additional data about transaction",
                                                "type": "string",
                                                "example": "XYZ:123",
                                                "nullable": "true"
                                            },
                                            "customData": {
                                                "description": "Additional custom data about transaction",
                                                "properties": {
                                                    "key1": {
                                                        "description": "Custom data about transaction",
                                                        "type": "string",
                                                        "example": "some value-123",
                                                        "nullable": "true"
                                                    }
                                                },
                                                "type": "object"
                                            },
                                            "contrahent": {
                                                "description": "Contrahent data",
                                                "properties": {
                                                    "name": {
                                                        "description": "Contrahent name",
                                                        "type": "string",
                                                        "example": "John Smith"
                                                    },
                                                    "iban": {
                                                        "description": "Contrahent iban number",
                                                        "type": "string",
                                                        "example": "PL12109024027243667461166868"
                                                    },
                                                    "bic": {
                                                        "description": "Contrahent bic code",
                                                        "type": "string",
                                                        "example": "BPKOPLPW"
                                                    }
                                                },
                                                "type": "object"
                                            }
                                        },
                                        "type": "object"
                                    },
                                    "receiver": {
                                        "required": [
                                            "resource",
                                            "resourceId",
                                            "transactionType"
                                        ],
                                        "properties": {
                                            "transactionId": {
                                                "description": "Identifier of the transaction. This must be a unique value",
                                                "type": "string",
                                                "example": "3aea9c27-d30f-4b25-8482-39a3ee6abc88"
                                            },
                                            "transactionType": {
                                                "description": "Type of receiver transaction",
                                                "type": "string",
                                                "enum": [
                                                    "cashback",
                                                    "loan",
                                                    "payment",
                                                    "topUp",
                                                    "collateralCredit",
                                                    "companyCredit",
                                                    "ibanTechnicalCredit",
                                                    "creditIbanTransfer"
                                                ],
                                                "example": "payment"
                                            },
                                            "resource": {
                                                "description": "Resource used to identify the receiver balance. See the compatibility tables in the endpoint description.",
                                                "type": "string",
                                                "enum": [
                                                    "card",
                                                    "balance",
                                                    "companyBalance",
                                                    "creditBalance",
                                                    "depositBalance",
                                                    "ibanTechnicalBalance"
                                                ],
                                                "example": "balance"
                                            },
                                            "resourceId": {
                                                "description": "Card Id or Balance Id",
                                                "type": "string",
                                                "example": "0cbc4f1b-92ea-4b4d-b19b-18fc0fcb6d87"
                                            },
                                            "transactionCustomData": {
                                                "description": "Additional data about transaction",
                                                "type": "string",
                                                "example": "XYZ:123",
                                                "nullable": "true"
                                            },
                                            "customData": {
                                                "description": "Additional custom data about transaction",
                                                "properties": {
                                                    "key1": {
                                                        "description": "Custom data about transaction",
                                                        "type": "string",
                                                        "example": "some value-123",
                                                        "nullable": "true"
                                                    }
                                                },
                                                "type": "object"
                                            },
                                            "contrahent": {
                                                "description": "Contrahent data",
                                                "properties": {
                                                    "name": {
                                                        "description": "Contrahent name",
                                                        "type": "string",
                                                        "example": "Jane Doe"
                                                    },
                                                    "iban": {
                                                        "description": "Contrahent iban number",
                                                        "type": "string",
                                                        "example": "PL121090240272436231412124"
                                                    },
                                                    "bic": {
                                                        "description": "Contrahent bic code",
                                                        "type": "string",
                                                        "example": "BPKOPLPW"
                                                    }
                                                },
                                                "type": "object"
                                            }
                                        },
                                        "type": "object"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Successful operation",
                        "headers": {
                            "Content-Type": {
                                "description": "Response content type based on Accept header",
                                "schema": {
                                    "type": "string",
                                    "enum": [
                                        "application/json",
                                        "application/vnd.aml.v1+json"
                                    ]
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "oneOf": [
                                        {
                                            "description": "Standard response (Accept: application/json)",
                                            "properties": {
                                                "credit": {
                                                    "type": "string",
                                                    "example": "uuid-credit-id"
                                                },
                                                "debit": {
                                                    "type": "string",
                                                    "example": "uuid-debit-id"
                                                }
                                            },
                                            "type": "object"
                                        },
                                        {
                                            "description": "AML v1 response (Accept: application/vnd.aml.v1+json)",
                                            "properties": {
                                                "credit": {
                                                    "properties": {
                                                        "id": {
                                                            "type": "string",
                                                            "example": "uuid-credit-id"
                                                        },
                                                        "amlVerification": {
                                                            "properties": {
                                                                "verificationId": {
                                                                    "type": "string",
                                                                    "example": "uuid"
                                                                },
                                                                "result": {
                                                                    "type": "string"
                                                                },
                                                                "actions": {
                                                                    "type": "array",
                                                                    "items": {
                                                                        "type": "string"
                                                                    }
                                                                }
                                                            },
                                                            "type": "object"
                                                        }
                                                    },
                                                    "type": "object"
                                                },
                                                "debit": {
                                                    "properties": {
                                                        "id": {
                                                            "type": "string",
                                                            "example": "uuid-debit-id"
                                                        },
                                                        "amlVerification": {
                                                            "properties": {
                                                                "verificationId": {
                                                                    "type": "string",
                                                                    "example": "uuid"
                                                                },
                                                                "result": {
                                                                    "type": "string"
                                                                },
                                                                "actions": {
                                                                    "type": "array",
                                                                    "items": {
                                                                        "type": "string"
                                                                    },
                                                                    "example": []
                                                                }
                                                            },
                                                            "type": "object"
                                                        }
                                                    },
                                                    "type": "object"
                                                }
                                            },
                                            "type": "object"
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "CustomerNotFound": {
                                        "$ref": "#/components/examples/CustomerNotFound"
                                    },
                                    "ResourceNotFound": {
                                        "$ref": "#/components/examples/ResourceNotFound"
                                    }
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Transaction Conflict",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InsufficientFunds": {
                                        "$ref": "#/components/examples/InsufficientFunds"
                                    },
                                    "CardLimitExceeded": {
                                        "$ref": "#/components/examples/CardLimitExceeded"
                                    },
                                    "CurrencyDifferenceError": {
                                        "$ref": "#/components/examples/CurrencyDifferenceError"
                                    },
                                    "IdConflict": {
                                        "$ref": "#/components/examples/TransactionIdConflict"
                                    }
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidCurrency": {
                                        "$ref": "#/components/examples/InvalidCurrency"
                                    },
                                    "InvalidAmount": {
                                        "$ref": "#/components/examples/InvalidAmount"
                                    },
                                    "InvalidTransactionType": {
                                        "$ref": "#/components/examples/InvalidTransactionType"
                                    },
                                    "InvalidDescription": {
                                        "$ref": "#/components/examples/InvalidDescription"
                                    },
                                    "InvalidSenderResourceId": {
                                        "$ref": "#/components/examples/InvalidSenderResourceId"
                                    },
                                    "InvalidReceiverResourceId": {
                                        "$ref": "#/components/examples/InvalidReceiverResourceId"
                                    },
                                    "InvalidTransactionId": {
                                        "$ref": "#/components/examples/InvalidTransactionId"
                                    },
                                    "InvalidContrahentData": {
                                        "$ref": "#/components/examples/InvalidContrahentData"
                                    }
                                }
                            }
                        }
                    }
                },
                "deprecated": true
            }
        },
        "/admin/allowed_transaction_types": {
            "get": {
                "tags": [
                    "Admin - Transactions"
                ],
                "summary": "Retrive list of allowed transaction types based on logged user role",
                "description": "Allows to get list of allowed transaction types for admin with access level specified in authorization token.",
                "operationId": "fe0a3a461c67689dc7203c1c91d00daf",
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "type": "string",
                                        "enum": [
                                            "cashback",
                                            "commission",
                                            "fee",
                                            "funding",
                                            "interest",
                                            "loan",
                                            "payment",
                                            "topUp",
                                            "withdrawal",
                                            "collateralDebit",
                                            "collateralForcedDebit",
                                            "collateralCredit",
                                            "companyDebit",
                                            "companyCredit"
                                        ],
                                        "example": "fee"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/verifications/{verificationId}/documents/{documentPath}/attach": {
            "post": {
                "tags": [
                    "Admin - Verifications"
                ],
                "summary": "Attach uploaded document to verification",
                "description": "Method attach uploaded document to verification and return information about document </br> You can use this method after uploading a document\n## Security\nROLE_ATTACH_VERIFICATION_DOCUMENT is required to access this method (falls back to ROLE_UPDATE_VERIFICATION when not set)",
                "operationId": "2f2db58faaa4b77ed6abe1dbe133682b",
                "parameters": [
                    {
                        "name": "verificationId",
                        "in": "path",
                        "description": "Uuid of verification",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "5a5b253b-ac14-4566-a89f-8c5d26544c4e"
                        }
                    },
                    {
                        "name": "documentPath",
                        "in": "path",
                        "description": "Document path",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "vfBQAtG4uXIWMtTtYYRxvLhP6AaFuCY9nhUzaN1s.pdf"
                        }
                    }
                ],
                "requestBody": {
                    "description": "Input data",
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "documentExpirationDate": {
                                        "description": "Document expiration date",
                                        "type": "string",
                                        "format": "date",
                                        "example": "2025-01-28"
                                    },
                                    "type": {
                                        "description": "type",
                                        "type": "string",
                                        "enum": [
                                            "idCard",
                                            "passport",
                                            "other",
                                            "proofOfAddress",
                                            "residenceCard",
                                            "paymentMethod",
                                            "sourceOfFunds",
                                            "sourceOfWealth",
                                            "registerEntry",
                                            "declaration",
                                            "video"
                                        ],
                                        "example": "other"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/VerificationDocument"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "VerificationNotFound": {
                                        "$ref": "#/components/examples/VerificationNotFound"
                                    },
                                    "VerificationDocumentNotExist": {
                                        "$ref": "#/components/examples/VerificationDocumentNotExist"
                                    }
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "Error response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "verificationDocumentAlreadyAttachedToOtherVerification": {
                                        "$ref": "#/components/examples/verificationDocumentAlreadyAttachedToOtherVerification"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/verifications/{verificationId}/documents": {
            "get": {
                "tags": [
                    "Admin - Verifications"
                ],
                "summary": "Get list verification documents",
                "description": "Method returns information about attached verification documents\n## Security\nROLE_READ_VERIFICATION_DETAILS is required to access this method",
                "operationId": "d2c4444cd57ce60ab3f3e291414e94d3",
                "parameters": [
                    {
                        "name": "verificationId",
                        "in": "path",
                        "description": "Uuid of verification",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "5a5b253b-ac14-4566-a89f-8c5d26544c4e"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/VerificationDocument"
                                    }
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "VerificationNotFound": {
                                        "$ref": "#/components/examples/VerificationNotFound"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/verifications/{verificationId}/documents/{documentId}": {
            "patch": {
                "tags": [
                    "Admin - Verifications"
                ],
                "summary": "Update existing document",
                "description": "Method allow to change document expiration date\n## Security\nROLE_UPDATE_VERIFICATION is required to access this method",
                "operationId": "a763ffc2d6977206289e8a1c778f17df",
                "parameters": [
                    {
                        "name": "verificationId",
                        "in": "path",
                        "description": "Uuid of verification",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "5a5b253b-ac14-4566-a89f-8c5d26544c4e"
                        }
                    },
                    {
                        "name": "documentId",
                        "in": "path",
                        "description": "Uuid of document",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "5a5b253b-ac14-4566-a89f-8c5d26544c4e"
                        }
                    }
                ],
                "requestBody": {
                    "description": "Input data",
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "documentExpirationDate": {
                                        "description": "Document expiration date",
                                        "type": "string",
                                        "format": "date",
                                        "example": "2025-01-28"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "VerificationDocumentNotExist": {
                                        "$ref": "#/components/examples/VerificationDocumentNotExist"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/verifications/{verificationId}/accept": {
            "post": {
                "tags": [
                    "Admin - Verifications"
                ],
                "summary": "Accept customer verification",
                "description": "Method accept customer verification and finish process of verification. After this action customer and balance will be created\n## Security\nROLE_ACCEPT_VERIFICATION is required to access this method",
                "operationId": "9845b4c381181935c2ef13aab6d69f2d",
                "parameters": [
                    {
                        "name": "verificationId",
                        "in": "path",
                        "description": "Verification identifier in uuid format",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "3dc88ad5-7053-454b-bcb8-e067c436f17d"
                        }
                    }
                ],
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "riskLvl": {
                                        "description": "Risk level",
                                        "type": "string",
                                        "enum": [
                                            "LOW",
                                            "NORMAL",
                                            "HIGH",
                                            "NOT_ACCEPTABLE"
                                        ],
                                        "example": "NORMAL"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "409": {
                        "description": "Error response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "CANT_ACCEPT_VERIFICATION"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/customers/{customerId}/verifications/{verificationId}": {
            "get": {
                "tags": [
                    "Admin - Verifications"
                ],
                "summary": "Get details of verification",
                "description": "Method returns information about verification with all documents and reletaed customer (only if verification is accepted)\n * ## Security\n * ROLE_READ_VERIFICATION_DETAILS is required to access this method",
                "operationId": "76b3594a30ff0e82acacaa9ae421f28a",
                "parameters": [
                    {
                        "name": "customerId",
                        "in": "path",
                        "description": "DataCore user id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": 1125
                        }
                    },
                    {
                        "name": "verificationId",
                        "in": "path",
                        "description": "Uuid of verification",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "5a5b253b-ac14-4566-a89f-8c5d26544c4e"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/VerificationDetails"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/verifications/reasons": {
            "get": {
                "tags": [
                    "Admin - Verifications"
                ],
                "summary": "Get list of veirfication reasons",
                "description": "Get list of veirfication reasons in array format\n## Security\nROLE_READ_VERIFICATION_REJECTION_REASON is required to access this method",
                "operationId": "989dcdfdd3540989428f9129ded9c8d5",
                "responses": {
                    "200": {
                        "description": "Successful operation: array of reasons",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "description": "Rejection reason. Could be one or more",
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    },
                                    "example": [
                                        "INVALID_CUSTOMER_DATA",
                                        "BLURRED_DOCUMENT_PHOTO",
                                        "INVALID_DOCUMENT_PHOTO",
                                        "BLURRED_SELFIE",
                                        "INVALID_SELFIE",
                                        "RESTRICTED_PESEL",
                                        "INCORRECT_PESEL",
                                        "UNDERAGE",
                                        "ILLEGAL_DOCUMENT",
                                        "EXPIRED_DOCUMENT",
                                        "MISSING_ENTIRE_DOCUMENT",
                                        "SELFIE_WITHOUT_DOCUMENT",
                                        "FACE_COVERED",
                                        "PAYMENT_CARD_NOT_DOCUMENT",
                                        "MISSING_DIACRITICAL_MARKS",
                                        "NON_LATIN_ALPHABET",
                                        "OUTSIDE_EEA",
                                        "ILLEGAL_EMAIL",
                                        "NOT_MATCH_PREFIX"
                                    ]
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/verifications/{customerId}/status": {
            "get": {
                "tags": [
                    "Admin - Verifications"
                ],
                "summary": "Obtain verification status",
                "description": "\n## Security\nROLE_READ_VERIFICATION_STATUS is required to access this method",
                "operationId": "54e7080839090f33b89b6e36f560fe6e",
                "parameters": [
                    {
                        "name": "customerId",
                        "in": "path",
                        "description": "DataCore user id",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "example": 1337
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "description": "Verification status",
                                            "type": "string",
                                            "enum": [
                                                "rejected",
                                                "accepted",
                                                "in_progress"
                                            ],
                                            "example": "rejected"
                                        },
                                        "reasons": {
                                            "description": "Verification status reasons",
                                            "type": "object",
                                            "example": [
                                                "INVALID_CUSTOMER_DATA",
                                                "BLURRED_DOCUMENT_PHOTO",
                                                "INVALID_DOCUMENT_PHOTO",
                                                "BLURRED_SELFIE",
                                                "INVALID_SELFIE",
                                                "RESTRICTED_PESEL",
                                                "INCORRECT_PESEL",
                                                "UNDERAGE",
                                                "ILLEGAL_DOCUMENT",
                                                "EXPIRED_DOCUMENT",
                                                "MISSING_ENTIRE_DOCUMENT",
                                                "SELFIE_WITHOUT_DOCUMENT",
                                                "FACE_COVERED",
                                                "PAYMENT_CARD_NOT_DOCUMENT",
                                                "MISSING_DIACRITICAL_MARKS",
                                                "NON_LATIN_ALPHABET",
                                                "OUTSIDE_EEA",
                                                "ILLEGAL_EMAIL",
                                                "NOT_MATCH_PREFIX"
                                            ]
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "description": "Cant find verification for requested id",
                                            "type": "string",
                                            "example": "VERIFICATION_NOT_FOUND"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/verifications": {
            "get": {
                "tags": [
                    "Admin - Verifications"
                ],
                "summary": "Retrive list of verifications",
                "description": "Allows to get paginated list of verifications. Query filter are allowed along with SortBy, OrderBy\n## Security\nROLE_READ_VERIFICATION is required to access this method",
                "operationId": "6fbeedd595bd624030ac080839047c27",
                "parameters": [
                    {
                        "name": "status",
                        "in": "query",
                        "description": "Status to filter by",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "accepted"
                        }
                    },
                    {
                        "name": "createdAt",
                        "in": "query",
                        "description": "Date of customer registration registration. Allowed format Y-m-d H:i:s ",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "2020-01-01 12:00:00"
                        }
                    },
                    {
                        "name": "from",
                        "in": "query",
                        "description": "Filter by registration date started by value. Allowed format Y-m-d H:i:s",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "2020-01-01 12:00:00"
                        }
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "description": "Filter by registration date end by value. Allowed format Y-m-d H:i:s",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "example": "2020-01-01 12:00:00"
                        }
                    },
                    {
                        "name": "customerId",
                        "in": "query",
                        "description": "customerId to filter by",
                        "required": false,
                        "schema": {
                            "type": "int",
                            "example": "1125"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/VerificationCollection"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/verifications/{verificationId}/reject": {
            "post": {
                "tags": [
                    "Admin - Verifications"
                ],
                "summary": "Reject customer verification",
                "description": "Method reject customer verification\n## Security\nROLE_REJECT_VERIFICATION is required to access this method",
                "operationId": "1c27e2e2c5566644e85d69020e912acd",
                "parameters": [
                    {
                        "name": "verificarionId",
                        "in": "path",
                        "description": "Verification identifier in uuid format",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "3dc88ad5-7053-454b-bcb8-e067c436f17d"
                        }
                    }
                ],
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "reason": {
                                        "description": "Rejection reason",
                                        "type": "array",
                                        "items": {
                                            "type": "string",
                                            "enum": [
                                                "INVALID_CUSTOMER_DATA",
                                                "BLURRED_DOCUMENT_PHOTO",
                                                "INVALID_DOCUMENT_PHOTO",
                                                "BLURRED_SELFIE",
                                                "INVALID_SELFIE",
                                                "RESTRICTED_PESEL",
                                                "INCORRECT_PESEL",
                                                "UNDERAGE",
                                                "ILLEGAL_DOCUMENT",
                                                "EXPIRED_DOCUMENT",
                                                "MISSING_ENTIRE_DOCUMENT",
                                                "SELFIE_WITHOUT_DOCUMENT",
                                                "FACE_COVERED",
                                                "PAYMENT_CARD_NOT_DOCUMENT",
                                                "MISSING_DIACRITICAL_MARKS",
                                                "NON_LATIN_ALPHABET",
                                                "OUTSIDE_EEA",
                                                "ILLEGAL_EMAIL",
                                                "NOT_MATCH_PREFIX"
                                            ],
                                            "example": "BLURRED_DOCUMENT_PHOTO"
                                        }
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "VERIFICATION_NOT_FOUND"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/verifications/{verificationId}/reject_and_lock": {
            "post": {
                "tags": [
                    "Admin - Verifications"
                ],
                "summary": "Permanently reject customer verification",
                "description": "Method reject customer verification and add to permanently rejected list\n## Security\nROLE_REJECT_AND_LOCK_VERIFICATION is required to access this method",
                "operationId": "17c9ce1bb2b75afdf868f486ec53519d",
                "parameters": [
                    {
                        "name": "verificationId",
                        "in": "path",
                        "description": "Verification identifier in uuid format",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "3dc88ad5-7053-454b-bcb8-e067c436f17d"
                        }
                    }
                ],
                "requestBody": {
                    "description": "Input data",
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "properties": {
                                    "reason": {
                                        "description": "Rejection reason",
                                        "type": "array",
                                        "items": {
                                            "type": "string",
                                            "enum": [
                                                "INVALID_CUSTOMER_DATA",
                                                "BLURRED_DOCUMENT_PHOTO",
                                                "INVALID_DOCUMENT_PHOTO",
                                                "BLURRED_SELFIE",
                                                "INVALID_SELFIE",
                                                "RESTRICTED_PESEL",
                                                "INCORRECT_PESEL",
                                                "UNDERAGE",
                                                "ILLEGAL_DOCUMENT",
                                                "EXPIRED_DOCUMENT",
                                                "MISSING_ENTIRE_DOCUMENT",
                                                "SELFIE_WITHOUT_DOCUMENT",
                                                "FACE_COVERED",
                                                "PAYMENT_CARD_NOT_DOCUMENT",
                                                "MISSING_DIACRITICAL_MARKS",
                                                "NON_LATIN_ALPHABET",
                                                "OUTSIDE_EEA",
                                                "ILLEGAL_EMAIL",
                                                "NOT_MATCH_PREFIX"
                                            ],
                                            "example": "BLURRED_DOCUMENT_PHOTO"
                                        }
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "VERIFICATION_NOT_FOUND"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "InvalidReason": {
                                        "$ref": "#/components/examples/InvalidReason"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/verifications/{verificationId}": {
            "patch": {
                "tags": [
                    "Admin - Verifications"
                ],
                "summary": "Update customer verification",
                "description": "Method update customer verification\n * ## Security\n * ROLE_UPDATE_VERIFICATION is required to access this method",
                "operationId": "0069fa92c5260224b963b6b931ee285f",
                "parameters": [
                    {
                        "name": "verificationId",
                        "in": "path",
                        "description": "Verification identifier in uuid format",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "example": "3dc88ad5-7053-454b-bcb8-e067c436f17d"
                        }
                    }
                ],
                "requestBody": {
                    "description": "Input data format",
                    "content": {
                        "application/json": {
                            "schema": {
                                "required": [],
                                "properties": {
                                    "firstName": {
                                        "description": "First name of user for verification",
                                        "type": "string",
                                        "example": "Jane"
                                    },
                                    "lastName": {
                                        "description": "Last name of user for verification",
                                        "type": "string",
                                        "example": "Doe"
                                    },
                                    "birthDate": {
                                        "description": "Customer birth date in format: Y-m-d",
                                        "type": "string",
                                        "format": "date",
                                        "example": "1970-01-01"
                                    },
                                    "identityCardNo": {
                                        "description": "Number of identity card. This field is required if customer has no pesel",
                                        "type": "string",
                                        "example": "ARG691869",
                                        "nullable": "true"
                                    },
                                    "pesel": {
                                        "description": "Customer pesel number",
                                        "type": "string",
                                        "example": "70010155587",
                                        "nullable": "true"
                                    },
                                    "riskLvl": {
                                        "description": "Risk level",
                                        "type": "string",
                                        "enum": [
                                            "LOW",
                                            "NORMAL",
                                            "HIGH",
                                            "NOT_ACCEPTABLE"
                                        ],
                                        "example": "NORMAL"
                                    },
                                    "nationality": {
                                        "description": "Customer nationality",
                                        "type": "string",
                                        "example": "polish",
                                        "nullable": "true"
                                    },
                                    "city": {
                                        "description": "City of custmer",
                                        "type": "string",
                                        "example": "Lublin"
                                    },
                                    "street": {
                                        "description": "Customer street",
                                        "type": "integer",
                                        "example": "Rusałka"
                                    },
                                    "number": {
                                        "description": "Customer house number. Required only if apartment has not been sent",
                                        "type": "string",
                                        "example": "17a"
                                    },
                                    "apartment": {
                                        "description": "Customer apartment number. Required only if number has not been sent",
                                        "type": "string",
                                        "example": "2"
                                    },
                                    "postCode": {
                                        "description": "Customer post code",
                                        "type": "string",
                                        "example": "20-128"
                                    },
                                    "country": {
                                        "description": "Alpha-2 code in ISO-3166",
                                        "type": "string",
                                        "example": "PL"
                                    },
                                    "usaResident": {
                                        "description": "Customer is tax resident in USA</p> true=1 </p> false=0",
                                        "type": "boolean",
                                        "format": "boolean",
                                        "nullable": "true"
                                    },
                                    "taxResident": {
                                        "description": "Client's tax residency list<p>exampaleRequest:</p>\n * |      Body Key      |  Body Value |\n * |:-------------:|------:|\n * |  taxResident[0] | DE |",
                                        "format": "array",
                                        "nullable": "true"
                                    },
                                    "sourceOfFunds": {
                                        "description": "\n * Array of customer's funds sources:\n * <p><b>business_activity:</b> Nip (VAT number) or/and REGON (National Business Registry Number) is required when you send business_activity field</p>\n * <p><b>salary:</b> Profession is required when salary is send.</p>\n *\n * | SourceOfFunds   |      Body Key      |  Body Value |\n * |----------|:-------------:|------:|\n * | business_activity |  sourceOfFunds[business_activity][0][nip] | NIP_NUMBER |\n * |     |sourceOfFunds[business_activity][0][regon]  |   REGON_NUMBER |\n * | salary| sourceOfFunds[salary][0][profession] |   whatever about profession |\n * | other |  sourceOfFunds[other][0] | some_value |\n * | maintained_by_family |  sourceOfFunds[maintained_by_family][0] | some_value |\n * | investments |  sourceOfFunds[investments][0]  | some_value |\n * | social_benefits |  sourceOfFunds[social_benefits][0] | some_value |\n * | tenancy |  sourceOfFunds[tenancy][0] | some_value |\n *\n * ",
                                        "format": "array",
                                        "nullable": "true"
                                    },
                                    "kycLevel": {
                                        "description": "Customer KYC level.",
                                        "type": "string",
                                        "enum": [
                                            "LOW",
                                            "MEDIUM",
                                            "HIGH",
                                            "EXTENDED"
                                        ],
                                        "nullable": "true"
                                    }
                                },
                                "type": "object"
                            }
                        }
                    }
                },
                "responses": {
                    "204": {
                        "description": "Successful operation"
                    },
                    "404": {
                        "description": "Resource not found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "status": {
                                            "type": "string",
                                            "example": "VERIFICATION_NOT_FOUND"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "Request validation failed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorResponse"
                                },
                                "examples": {
                                    "DateIsInvalid": {
                                        "$ref": "#/components/examples/DateIsInvalid"
                                    },
                                    "DateFormatIsInvalid": {
                                        "$ref": "#/components/examples/DateFormatIsInvalid"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/admin/allowed_actions": {
            "get": {
                "tags": [
                    "Admin - Allowed Actions"
                ],
                "summary": "Retrive list of allowed actions",
                "description": "Allows to get list of allowed actions for admin with access level specified in authorization token.",
                "operationId": "2a6163e5801ed95c5bd556fd8e2550de",
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ApiActionCollection"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/public_key": {
            "get": {
                "tags": [
                    "Public Key"
                ],
                "summary": "Get public key for encryption",
                "operationId": "getPublicKey",
                "responses": {
                    "200": {
                        "description": "Successful operation",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "publicKey": {
                                            "description": "b64 encoded public key (PEM format)",
                                            "type": "string",
                                            "example": "QSBwdWJsaWMga2V5IHNob3VsZCBiZSBoZXJlIGhvd2V2ZXIgaXQgd2FzIHRvbyBsb25nIDoo"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/async_operations/{id}": {
            "get": {
                "tags": [
                    "Async Operation"
                ],
                "summary": "Endpoint for obtaining status of asynchronous operation",
                "description": "This endpoint is for checking status of asynchronous operation previously startted by different processes </br>\nKeep in mind that along with status this method can return Location header involving url path to created resource.",
                "operationId": "8d5f4eded096dd4ef99d7314e13e645a",
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "description": "Async operation in uuid format",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "format": "uuid",
                            "example": "d5f57a40-6de9-4547-bc33-77f42aa85cea"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Operation on IN_PROGRESS state",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "id": {
                                            "type": "string",
                                            "example": "0b8d6c51-5537-4923-a39d-ecbd6abe85e2"
                                        },
                                        "status": {
                                            "type": "string",
                                            "example": "IN_PROGRESS"
                                        },
                                        "errors": {
                                            "type": "string",
                                            "example": "[]"
                                        },
                                        "progress": {
                                            "type": "integer",
                                            "example": "50"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "303": {
                        "description": "Operation has been completed. Always return Location header with url for created resource",
                        "headers": {
                            "Location": {
                                "description": "url for created resurce eg. /customers/me/cards/123",
                                "schema": {
                                    "type": "string"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "properties": {
                                        "id": {
                                            "type": "string",
                                            "example": "0b8d6c51-5537-4923-a39d-ecbd6abe85e2"
                                        },
                                        "status": {
                                            "type": "string",
                                            "example": "COMPLETED"
                                        },
                                        "errors": {
                                            "type": "string",
                                            "example": "[]"
                                        }
                                    },
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "CustomerBalanceDto": {
                "title": "Customer Balance",
                "description": "Customer Balance",
                "properties": {
                    "id": {
                        "type": "string",
                        "format": "uuid"
                    },
                    "balance": {
                        "type": "number",
                        "format": "float"
                    },
                    "currency": {
                        "description": "Currency code ISO 4217",
                        "type": "string",
                        "example": "PLN"
                    },
                    "description": {
                        "description": "Description of the balance",
                        "type": "string",
                        "example": "My account",
                        "nullable": true
                    },
                    "accountingBalance": {
                        "type": "integer",
                        "nullable": true
                    },
                    "customerId": {
                        "type": "integer",
                        "nullable": true
                    },
                    "dcCorporationId": {
                        "format": "uuid",
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "CustomerDocumentDto": {
                "title": "Customer Document",
                "description": "Customer Document",
                "properties": {
                    "id": {
                        "type": "string",
                        "format": "uuid"
                    },
                    "type": {
                        "type": "string"
                    },
                    "path": {
                        "type": "string"
                    },
                    "expirationDate": {
                        "type": "string",
                        "format": "Y-m-d",
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "DocumentDto": {
                "title": "Document",
                "description": "Document",
                "properties": {
                    "id": {
                        "type": "string",
                        "format": "uuid"
                    },
                    "type": {
                        "type": "string"
                    },
                    "path": {
                        "type": "string"
                    },
                    "expirationDate": {
                        "type": "string",
                        "format": "date-time",
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "VerificationDocumentDto": {
                "title": "VerificationDocumentDto",
                "description": "Verification document",
                "properties": {
                    "id": {
                        "title": "Document identifier",
                        "description": "id",
                        "type": "string",
                        "format": "uuid",
                        "example": "70f91efb-3989-4289-916c-db4eed741a4e"
                    },
                    "type": {
                        "title": "Type of document",
                        "description": "type",
                        "type": "string",
                        "format": "string",
                        "example": "idCard"
                    },
                    "url": {
                        "title": "Document URL",
                        "description": "url",
                        "type": "string",
                        "format": "url",
                        "example": "https://example.com/example.png"
                    },
                    "expirationDate": {
                        "title": "Document expiration date",
                        "description": "Document expiration date",
                        "type": "string",
                        "format": "date",
                        "example": "2025-01-29",
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "CardEntity": {
                "title": "CardEntity",
                "description": "CardEntity",
                "properties": {
                    "id": {
                        "title": "DataCore card id",
                        "description": "Id",
                        "type": "integer",
                        "format": "int",
                        "example": "7",
                        "nullable": true
                    },
                    "exp": {
                        "title": "Card expiration date in format YYYY-MM-DD",
                        "description": "exp",
                        "type": "string",
                        "format": "DateTime",
                        "example": "2026-01-31",
                        "nullable": true
                    },
                    "type": {
                        "title": "Card type",
                        "description": "Card type",
                        "type": "string",
                        "format": "string",
                        "example": "VIRTUAL",
                        "nullable": true
                    },
                    "activationDate": {
                        "title": "Card activation date in format YYYY-MM-DD",
                        "description": "activationDate",
                        "type": "string",
                        "format": "DateTime",
                        "example": "2026-01-31",
                        "nullable": true
                    },
                    "configId": {
                        "title": "configuration identifier",
                        "description": "configId",
                        "type": "string",
                        "format": "string",
                        "example": "0013009713"
                    },
                    "dcCorporationId": {
                        "title": "Corporation",
                        "description": "corporation",
                        "format": "uuid",
                        "example": "97eee13e-7669-11eb-9439-0242ac130007"
                    }
                },
                "type": "object"
            },
            "CustomerBalanceEntity": {
                "title": "CustomerBalanceEntity",
                "description": "CustomerBalanceEntity",
                "properties": {
                    "id": {
                        "title": "id",
                        "description": "id",
                        "format": "uuid",
                        "example": "97eee13e-7669-11eb-9439-0242ac130002"
                    },
                    "balance": {
                        "title": "Balance in gross",
                        "description": "balance",
                        "type": "integer",
                        "format": "int",
                        "example": "1567"
                    },
                    "currency": {
                        "description": "Currency code ISO 4217",
                        "type": "string",
                        "format": "string",
                        "example": "PLN"
                    },
                    "description": {
                        "description": "Name of balance",
                        "type": "string",
                        "format": "string",
                        "example": "My account",
                        "nullable": true
                    },
                    "accountingBalance": {
                        "title": "Accounting balance in gross",
                        "description": "accounting balance",
                        "type": "integer",
                        "format": "int",
                        "example": "1567",
                        "nullable": true
                    },
                    "clearingCounter": {
                        "title": "Clearing counter",
                        "description": "clearing counter",
                        "type": "integer",
                        "format": "int",
                        "example": "34",
                        "nullable": true
                    },
                    "customerId": {
                        "title": "customerId",
                        "description": "DataCore user id",
                        "format": "int",
                        "example": "77777"
                    },
                    "dcCorporationId": {
                        "title": "Corporation",
                        "description": "corporation",
                        "format": "uuid",
                        "example": "97eee13e-7669-11eb-9439-0242ac130007"
                    },
                    "cards": {
                        "title": "CardEntity",
                        "description": "CardEntity",
                        "type": "array",
                        "format": "array",
                        "items": {
                            "$ref": "#/components/schemas/CardEntity"
                        }
                    }
                },
                "type": "object"
            },
            "DocumentEntity": {
                "title": "Document model",
                "description": "Document model",
                "properties": {
                    "id": {
                        "title": "id",
                        "description": "unique identifier",
                        "format": "uuid"
                    },
                    "type": {
                        "title": "rejectReason",
                        "description": "type of document",
                        "type": "string",
                        "format": "string",
                        "enum": [
                            "passport",
                            "idCard"
                        ]
                    }
                },
                "type": "object",
                "xml": {
                    "name": "Document"
                }
            },
            "VerificationArchiveEntity": {
                "title": "Verification archive model",
                "description": "Verification archive model",
                "properties": {
                    "id": {
                        "title": "id",
                        "description": "unique identifier",
                        "format": "uuid"
                    },
                    "customerStorageId": {
                        "title": "customerStorageId",
                        "description": "identifier of customer stored in DataCore",
                        "type": "integer",
                        "format": "int64"
                    },
                    "status": {
                        "title": "status",
                        "description": "status of verification",
                        "type": "string",
                        "format": "string"
                    },
                    "rejectReason": {
                        "title": "rejectReason",
                        "description": "reason of verification rejection",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    },
                    "customer": {
                        "$ref": "#customer"
                    },
                    "firstName": {
                        "title": "firstName",
                        "description": "customer first name of verrification",
                        "type": "string",
                        "format": "string"
                    },
                    "lastName": {
                        "title": "lastName",
                        "description": "customer last name of verrification",
                        "type": "string",
                        "format": "string"
                    },
                    "birthDate": {
                        "title": "birthDate",
                        "description": "customer birth date of verrification",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    },
                    "nationality": {
                        "title": "nationality",
                        "description": "nationality",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    },
                    "pesel": {
                        "title": "pesel",
                        "description": "pesel number of customer",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    },
                    "identityCardNo": {
                        "title": "identityCardNo",
                        "description": "identity card number",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    },
                    "riskLvl": {
                        "title": "riskLvl",
                        "description": "risk level",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    }
                },
                "type": "object",
                "xml": {
                    "name": "VerificationArchive"
                }
            },
            "VerificationEntity": {
                "title": "Verification model",
                "description": "Verification model",
                "properties": {
                    "id": {
                        "title": "id",
                        "description": "unique identifier",
                        "format": "uuid"
                    },
                    "customerStorageId": {
                        "title": "customerStorageId",
                        "description": "identifier of customer stored in DataCore",
                        "type": "integer",
                        "format": "int64"
                    },
                    "status": {
                        "title": "status",
                        "description": "status of verification",
                        "type": "string",
                        "format": "string"
                    },
                    "rejectReason": {
                        "title": "rejectReason",
                        "description": "reason of verification rejection",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    },
                    "documents": {
                        "$ref": "#document"
                    },
                    "customer": {
                        "$ref": "#customer"
                    },
                    "firstName": {
                        "title": "firstName",
                        "description": "customer first name of verrification",
                        "type": "string",
                        "format": "string"
                    },
                    "lastName": {
                        "title": "lastName",
                        "description": "customer last name of verrification",
                        "type": "string",
                        "format": "string"
                    },
                    "birthDate": {
                        "title": "birthDate",
                        "description": "customer birth date of verrification",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    },
                    "nationality": {
                        "title": "nationality",
                        "description": "nationality",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    },
                    "pesel": {
                        "title": "pesel",
                        "description": "pesel number of customer",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    },
                    "identityCardNo": {
                        "title": "identityCardNo",
                        "description": "identity card number",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    },
                    "riskLvl": {
                        "title": "riskLvl",
                        "description": "risk level",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    },
                    "sourceOfFounds": {
                        "type": "array",
                        "items": {
                            "title": "sourceOfFunds",
                            "description": "source of funds",
                            "format": "json"
                        },
                        "nullable": true
                    },
                    "usaResident": {
                        "title": "usaResident",
                        "description": "usa tax resident",
                        "type": "boolean",
                        "format": "boolean",
                        "nullable": true
                    },
                    "taxResident": {
                        "type": "array",
                        "items": {
                            "title": "countryResident",
                            "description": "list of countries where customer is a resident",
                            "format": "array"
                        },
                        "nullable": true
                    },
                    "dataHash": {
                        "title": "dataHash",
                        "description": "Hashed representation of all verification data",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    },
                    "kycLevel": {
                        "title": "kycLevel",
                        "description": "KYC level",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    },
                    "customData": {
                        "type": "array",
                        "items": {
                            "title": "customData",
                            "description": "Custom Data",
                            "format": "json"
                        },
                        "nullable": true
                    },
                    "phone": {
                        "title": "phone",
                        "description": "Phone number in E.164 format (e.g. +48600123456). Must start with + followed by country calling code and subscriber number, digits only, no spaces or separators.",
                        "type": "string",
                        "format": "string",
                        "example": "+48600123456",
                        "nullable": true
                    },
                    "isoCodePhone": {
                        "title": "isoCodePhone",
                        "description": "ISO 3166-1 alpha-2 country code associated with the phone number",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    },
                    "email": {
                        "title": "email",
                        "description": "Email address of the customer",
                        "type": "string",
                        "format": "string",
                        "nullable": true
                    },
                    "extendedVerificationDeclaration": {
                        "title": "extendedVerificationDeclaration",
                        "description": "Flag indicating the user declares they would like to spend more than a defined threshold.",
                        "type": "boolean",
                        "format": "boolean"
                    },
                    "financialInstitutionsData": {
                        "type": "array",
                        "items": {
                            "title": "financialInstitutions",
                            "description": "financial istitution data",
                            "format": "json"
                        },
                        "nullable": true
                    }
                },
                "type": "object",
                "xml": {
                    "name": "Verification"
                }
            },
            "ErrorResponse": {
                "properties": {
                    "status": {
                        "type": "string"
                    }
                },
                "type": "object"
            },
            "ApiActionCollection": {
                "title": "ApiActionCollection",
                "description": "Api Action resource collection",
                "properties": {
                    "data": {
                        "title": "data",
                        "description": "data",
                        "type": "array",
                        "format": "array",
                        "items": {
                            "$ref": "#/components/schemas/ApiActionResource"
                        }
                    }
                },
                "type": "object"
            },
            "ApiActionResource": {
                "title": "ApiAction",
                "description": "Api Action resource",
                "properties": {
                    "name": {
                        "title": "Action name",
                        "description": "name",
                        "type": "string",
                        "example": "getCustomerVerification"
                    },
                    "method": {
                        "title": "Http method",
                        "description": "method",
                        "type": "string",
                        "example": "GET"
                    },
                    "uri": {
                        "title": "Action uri",
                        "description": "uri",
                        "type": "string",
                        "example": "/admin/customers/{customerId}/verifications/{verificationId}"
                    }
                },
                "type": "object"
            },
            "CardDetailsAdmin": {
                "title": "CardDetailsAdmin",
                "description": "CardDetailsAdmin",
                "properties": {
                    "id": {
                        "title": "DataCore card id",
                        "description": "Id",
                        "type": "integer",
                        "format": "int",
                        "example": "1125"
                    },
                    "exp": {
                        "title": "card expiration date. Format: Y-m-d ",
                        "description": "card expiration date. Format: Y-m-d ",
                        "type": "string",
                        "format": "date",
                        "example": "2026-01-31"
                    },
                    "type": {
                        "title": "Card type",
                        "description": "type",
                        "type": "string",
                        "format": "string",
                        "enum": [
                            "real",
                            "virtual"
                        ],
                        "example": "1125"
                    },
                    "activationDate": {
                        "title": "Card activation date in format YYYY-MM-DD",
                        "description": "activationDate",
                        "type": "string",
                        "format": "DateTime",
                        "example": "2026-01-31",
                        "nullable": true
                    },
                    "configId": {
                        "title": "Configuration identifier",
                        "description": "configId",
                        "type": "string",
                        "format": "string",
                        "example": "0013009713"
                    },
                    "externalCardId": {
                        "title": "External card id",
                        "description": "externalCardId",
                        "type": "string",
                        "format": "string",
                        "example": "283744800001390"
                    },
                    "dcCorporationId": {
                        "title": "DC corporation id",
                        "description": "dcCorporationId",
                        "type": "string",
                        "format": "string",
                        "example": "29bacfc2-124d-433a-a9cf-8c7a9bcbdbed"
                    },
                    "balanceId": {
                        "title": "Customer balance ID",
                        "description": "balanceId",
                        "type": "string",
                        "format": "string",
                        "example": "29bacfc2-124d-433a-a9cf-8c7a9bcbdbed"
                    }
                },
                "type": "object"
            },
            "CardLimit": {
                "title": "CardLimit",
                "description": "Card Limit resource",
                "properties": {
                    "initialValue": {
                        "title": "initialValue",
                        "description": "Initial limit value.",
                        "type": "integer",
                        "example": "7"
                    },
                    "currentValue": {
                        "title": "currentValue",
                        "description": "Current(actual) limit value.",
                        "type": "integer",
                        "example": "7"
                    }
                },
                "type": "object"
            },
            "BalanceLimitCollection": {
                "title": "BalanceLimitCollection",
                "description": "Balance limit resource collection",
                "properties": {
                    "data": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/BalanceLimitResource"
                        }
                    }
                },
                "type": "object"
            },
            "BalanceLimitResource": {
                "title": "BalanceLimitResource",
                "description": "BalanceLimitResource",
                "properties": {
                    "id": {
                        "description": "Unique id of the limit",
                        "type": "string",
                        "format": "uuid",
                        "example": "492ec5ee-7f66-11ec-a8a3-0242ac120002"
                    },
                    "type": {
                        "description": "CASH_OUT - outgoing card transactions, CASH_IN - incoming funds (currently not enforced)",
                        "type": "string",
                        "enum": [
                            "CASH_IN",
                            "CASH_OUT"
                        ],
                        "example": "CASH_OUT"
                    },
                    "maxAmount": {
                        "description": "Maximum amount within the period in minor units of the balance currency, returned as a numeric string",
                        "type": "string",
                        "example": "50000"
                    },
                    "period": {
                        "type": "string",
                        "enum": [
                            "DAILY",
                            "WEEKLY",
                            "MONTHLY"
                        ],
                        "example": "MONTHLY",
                        "nullable": true
                    },
                    "expiration": {
                        "description": "Date and time after which the limit is no longer enforced, format Y-m-d H:i:s. Null for a permanent limit",
                        "type": "string",
                        "example": "2099-12-24 00:00:00",
                        "nullable": true
                    },
                    "currency": {
                        "description": "Currency of the limit, equal to the balance currency",
                        "type": "string",
                        "example": "PLN"
                    }
                },
                "type": "object"
            },
            "BalanceSummary": {
                "title": "BalanceSummary",
                "description": "Balance summary resource",
                "properties": {
                    "currency": {
                        "title": "Currency code ISO 4217",
                        "description": "currency",
                        "type": "string",
                        "format": "string",
                        "example": "PLN"
                    },
                    "amount": {
                        "title": "Amount in gross",
                        "description": "balance",
                        "type": "integer",
                        "format": "string",
                        "example": "1567"
                    }
                },
                "type": "object"
            },
            "BalaceGetAllCollection": {
                "title": "BalancesGetAll",
                "description": "BalancesGetAll",
                "properties": {
                    "id": {
                        "title": "Balance id",
                        "description": "id",
                        "type": "integer",
                        "format": "string",
                        "example": "9ec5fbe0-3599-4ec0-8255-9c390cbea02a"
                    },
                    "balance": {
                        "title": "Balance",
                        "description": "Balance in gross",
                        "type": "integer",
                        "format": "integer",
                        "example": "9845"
                    },
                    "currency": {
                        "title": "Currency",
                        "description": "Currency code ISO 4217",
                        "type": "string",
                        "format": "string",
                        "example": "PLN"
                    },
                    "description": {
                        "title": "Description",
                        "description": "Name of balance",
                        "type": "string",
                        "format": "string",
                        "example": "My account"
                    },
                    "dcUserId": {
                        "title": "DC user id",
                        "description": "dcUserId",
                        "type": "string",
                        "format": "int",
                        "example": "1337"
                    },
                    "dcCorporationId": {
                        "title": "DC corporation id",
                        "description": "dcCorporationId",
                        "type": "string",
                        "format": "string",
                        "example": "a271f0e9-065b-4e3c-be24-9bac54fbd550"
                    }
                },
                "type": "object"
            },
            "BalanceDetails": {
                "title": "BalanceDetails",
                "description": "Balance details resource",
                "properties": {
                    "id": {
                        "title": "Balance id",
                        "description": "id",
                        "type": "string",
                        "format": "uuid",
                        "example": "97eee13e-7669-11eb-9439-0242ac130002"
                    },
                    "balance": {
                        "title": "Balance in gross",
                        "description": "balance",
                        "type": "integer",
                        "format": "int",
                        "example": "1567"
                    },
                    "currency": {
                        "title": "Currency code ISO 4217",
                        "description": "currency",
                        "type": "string",
                        "format": "string",
                        "example": "PLN"
                    },
                    "description": {
                        "title": "description",
                        "description": "Description of balance",
                        "type": "string",
                        "format": "string",
                        "example": "My account",
                        "nullable": true
                    },
                    "dcUserId": {
                        "title": "dcUserId",
                        "description": "DC Id of user",
                        "type": "string",
                        "format": "int",
                        "example": "1337",
                        "nullable": true
                    },
                    "dcCorporationId": {
                        "title": "dcCorporationId",
                        "description": "DC Id of corporation",
                        "type": "string",
                        "format": "uuid",
                        "example": "97eee13e-7669-11eb-9439-0242ac137777",
                        "nullable": true
                    },
                    "cards": {
                        "title": "cards",
                        "description": "Cards",
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/CustomerBalanceCard"
                        }
                    }
                },
                "type": "object"
            },
            "BalanceGetAll": {
                "title": "BalancesGetAll",
                "description": "Balances get all",
                "type": "object",
                "allOf": [
                    {
                        "$ref": "#/components/schemas/PaginatedCollection"
                    },
                    {
                        "properties": {
                            "data": {
                                "title": "data",
                                "description": "data",
                                "type": "array",
                                "format": "array",
                                "items": {
                                    "$ref": "#/components/schemas/BalaceGetAllCollection"
                                }
                            }
                        },
                        "type": "object"
                    }
                ]
            },
            "CardLimitCollection": {
                "title": "CardLimitCollection",
                "description": "Card limit resource collection",
                "properties": {
                    "data": {
                        "title": "data",
                        "description": "All not deleted limits of the card, including limits created by the system (e.g. ONE_SHOT)",
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/CardLimitResource"
                        }
                    }
                },
                "type": "object"
            },
            "CardLimitResource": {
                "title": "CardLimitResource",
                "description": "CardLimitResource",
                "properties": {
                    "id": {
                        "description": "Unique id of the limit",
                        "type": "string",
                        "format": "uuid",
                        "example": "492ec5ee-7f66-11ec-a8a3-0242ac120002"
                    },
                    "type": {
                        "$ref": "#/components/schemas/CardLimitType"
                    },
                    "maxAmount": {
                        "description": "Maximum total amount of transactions in minor units of the card currency. Null when the limit has no amount condition.",
                        "type": "integer",
                        "format": "int64",
                        "example": 50000,
                        "nullable": true
                    },
                    "maxAttempts": {
                        "description": "Maximum number of transactions. Null when the limit has no quantity condition.",
                        "type": "integer",
                        "example": 10,
                        "nullable": true
                    },
                    "period": {
                        "description": "Period after which the limit usage is reset. Null when the usage is never reset.",
                        "type": "string",
                        "enum": [
                            "DAILY",
                            "WEEKLY",
                            "MONTHLY"
                        ],
                        "example": "MONTHLY",
                        "nullable": true
                    },
                    "expiration": {
                        "description": "Date and time after which the limit is no longer checked, format Y-m-d H:i:s",
                        "type": "string",
                        "example": "2099-12-24 00:00:00",
                        "nullable": true
                    },
                    "currency": {
                        "description": "Currency of the card, in which maxAmount is expressed",
                        "type": "string",
                        "example": "PLN",
                        "nullable": true
                    },
                    "mcc_list": {
                        "description": "Merchant category codes of MCC_BLACKLIST / MCC_WHITELIST limit, null for other types",
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "example": [
                            "5812",
                            "5814"
                        ],
                        "nullable": true
                    },
                    "merchant_id_list": {
                        "description": "Merchant identifiers of MERCHANT_ID_BLACKLIST / MERCHANT_ID_WHITELIST limit, null for other types",
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "example": [
                            "9AF3C2B1D4E5"
                        ],
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "CustomerResource": {
                "title": "CustomerResource",
                "description": "CustomerResource",
                "properties": {
                    "id": {
                        "description": "Id",
                        "type": "integer",
                        "example": 1125
                    },
                    "firstName": {
                        "description": "First name",
                        "type": "string",
                        "example": "Jane",
                        "nullable": true
                    },
                    "lastName": {
                        "description": "Last name",
                        "type": "string",
                        "example": "Doe",
                        "nullable": true
                    },
                    "birthDate": {
                        "description": "Birth date",
                        "type": "string",
                        "format": "date",
                        "example": "1970-01-01",
                        "nullable": true
                    },
                    "address": {
                        "nullable": true,
                        "allOf": [
                            {
                                "$ref": "#/components/schemas/VerificationAddress"
                            }
                        ]
                    }
                },
                "type": "object"
            },
            "CustomerBalance": {
                "title": "CustomerBalanceResource",
                "description": "CustomerBalanceResource"
            },
            "CustomerBalanceBrief": {
                "title": "CustomerBalanceBrief",
                "description": "Customer balance resource",
                "properties": {
                    "id": {
                        "title": "Balance id",
                        "description": "id",
                        "type": "string",
                        "format": "uuid",
                        "example": "97eee13e-7669-11eb-9439-0242ac130002"
                    },
                    "balance": {
                        "title": "Balance in gross",
                        "description": "balance",
                        "type": "integer",
                        "format": "int",
                        "example": "1567"
                    },
                    "currency": {
                        "title": "Currency code ISO 4217",
                        "description": "currency",
                        "type": "string",
                        "format": "string",
                        "example": "PLN"
                    },
                    "description": {
                        "title": "description",
                        "description": "Description of balance",
                        "type": "string",
                        "format": "string",
                        "example": "My account",
                        "nullable": true
                    },
                    "dcUserId": {
                        "title": "dcUserId",
                        "description": "DC Id of user",
                        "type": "string",
                        "format": "int",
                        "example": "1337",
                        "nullable": true
                    },
                    "dcCorporationId": {
                        "title": "dcCorporationId",
                        "description": "DC Id of corporation",
                        "type": "string",
                        "format": "uuid",
                        "example": "97eee13e-7669-11eb-9439-0242ac137777",
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "CustomerBalanceCard": {
                "title": "CustomerBalanceCard",
                "description": "Customer balance card resource",
                "properties": {
                    "id": {
                        "title": "DataCore card id",
                        "description": "id",
                        "type": "integer",
                        "format": "int",
                        "example": 7
                    },
                    "exp": {
                        "title": "Card expiration date in format YYYY-MM-DD",
                        "description": "exp",
                        "type": "integer",
                        "format": "DateTime",
                        "example": "2026-01-31"
                    },
                    "type": {
                        "title": "Card type",
                        "description": "type",
                        "type": "string",
                        "format": "string",
                        "example": "VIRTUAL"
                    },
                    "activationDate": {
                        "title": "Card activation date in format YYYY-MM-DD",
                        "description": "activationDate",
                        "type": "string",
                        "format": "DateTime",
                        "example": "2026-01-31",
                        "nullable": true
                    },
                    "configId": {
                        "title": "Configuration identifier",
                        "description": "configId",
                        "type": "string",
                        "format": "string",
                        "example": "0013009713"
                    },
                    "externalCardId": {
                        "title": "External card id",
                        "description": "externalCardId",
                        "type": "string",
                        "format": "string",
                        "example": "283744800001390"
                    }
                },
                "type": "object"
            },
            "CustomerBalanceDetails": {
                "title": "CustomerBalanceDetails",
                "description": "Customer balance details resource",
                "type": "object",
                "allOf": [
                    {
                        "$ref": "#/components/schemas/CustomerBalanceBrief"
                    },
                    {
                        "properties": {
                            "cards": {
                                "title": "cards",
                                "description": "Cards",
                                "type": "array",
                                "items": {
                                    "$ref": "#/components/schemas/CustomerBalanceCard"
                                }
                            }
                        },
                        "type": "object"
                    }
                ]
            },
            "Card": {
                "title": "CardDetails",
                "description": "CardDetails",
                "properties": {
                    "id": {
                        "title": "DataCore card id",
                        "description": "id",
                        "type": "integer",
                        "format": "int",
                        "example": 7
                    },
                    "exp": {
                        "title": "Card expiration date in format YYYY-MM-DD",
                        "description": "exp",
                        "type": "integer",
                        "format": "DateTime",
                        "example": "2026-01-31"
                    },
                    "type": {
                        "title": "Card type",
                        "description": "type",
                        "type": "string",
                        "format": "string",
                        "enum": [
                            "REAL",
                            "VIRTUAL"
                        ],
                        "example": "VIRTUAL"
                    },
                    "activationDate": {
                        "title": "Card activation date in format YYYY-MM-DD",
                        "description": "activationDate",
                        "type": "string",
                        "format": "DateTime",
                        "example": "2026-01-31",
                        "nullable": true
                    },
                    "configId": {
                        "title": "Configuration identifier",
                        "description": "configId",
                        "type": "string",
                        "format": "string",
                        "example": "0013009713"
                    },
                    "externalCardId": {
                        "title": "External card id",
                        "description": "externalCardId",
                        "type": "string",
                        "format": "string",
                        "example": "283744800001390"
                    },
                    "dcUserId": {
                        "title": "DC user id",
                        "description": "dcUserId",
                        "type": "string",
                        "format": "int",
                        "example": "1337"
                    },
                    "dcCorporationId": {
                        "title": "DC corporation id",
                        "description": "dcCorporationId",
                        "type": "string",
                        "format": "string",
                        "example": "a271f0e9-065b-4e3c-be24-9bac54fbd550"
                    },
                    "balanceId": {
                        "title": "Customer balance ID",
                        "description": "balanceId",
                        "type": "string",
                        "format": "string",
                        "example": "29bacfc2-124d-433a-a9cf-8c7a9bcbdbed"
                    }
                },
                "type": "object"
            },
            "CardAllowedConfig": {
                "title": "CardAllowedConfig",
                "description": "CardAllowedConfig Resource",
                "properties": {
                    "id": {
                        "title": "Id",
                        "description": "Id",
                        "type": "string",
                        "format": "string",
                        "example": "0013009713"
                    },
                    "name": {
                        "title": "name",
                        "description": "name",
                        "type": "string",
                        "format": "string",
                        "example": "Debit Standard"
                    },
                    "currency": {
                        "title": "Array of currency codes in ISO 4217 format",
                        "description": "currency",
                        "type": "array",
                        "format": "array",
                        "items": {
                            "type": "string",
                            "example": "PLN"
                        },
                        "example": "['PLN', 'EUR']"
                    },
                    "bin": {
                        "title": "bin of a card (Bank Identification Number",
                        "description": "bin",
                        "type": "string",
                        "format": "string",
                        "example": "538406"
                    },
                    "type": {
                        "title": "name",
                        "description": "type of card",
                        "type": "string",
                        "format": "string",
                        "enum": [
                            "VIRTUAL",
                            "REAL"
                        ],
                        "example": "VIRTUAL"
                    },
                    "visualId": {
                        "title": "visualId",
                        "description": "id of visual for this card",
                        "type": "string",
                        "format": "string",
                        "example": "17"
                    }
                },
                "type": "object"
            },
            "CardCollection": {
                "title": "CardCollection",
                "description": "Card collection"
            },
            "CardDetails": {
                "title": "CardDetails",
                "description": "CardDetails",
                "properties": {
                    "id": {
                        "title": "DataCore card id",
                        "description": "Id",
                        "type": "integer",
                        "format": "int",
                        "example": "1125"
                    },
                    "type": {
                        "title": "Card type",
                        "description": "type",
                        "type": "string",
                        "format": "string",
                        "enum": [
                            "REAL",
                            "VIRTUAL"
                        ],
                        "example": "VIRTUAL"
                    },
                    "cvv": {
                        "title": "cvv",
                        "description": "card security code",
                        "type": "string",
                        "format": "string",
                        "example": "573"
                    },
                    "cardNo": {
                        "title": "card number",
                        "description": "card full pan number",
                        "type": "string",
                        "format": "string",
                        "example": "5227128362110426"
                    },
                    "exp": {
                        "title": "card expiration date. Format: Y-m-d ",
                        "description": "card expiration date. Format: Y-m-d ",
                        "type": "string",
                        "format": "date",
                        "example": "2026-01-31"
                    },
                    "issuerCardId": {
                        "title": "Issuer card id",
                        "description": "Id from card issuer",
                        "type": "string",
                        "format": "string",
                        "example": "704144800000021"
                    },
                    "dcCorporationId": {
                        "title": "DC corporation id",
                        "description": "dcCorporationId",
                        "type": "string",
                        "format": "string",
                        "example": "29bacfc2-124d-433a-a9cf-8c7a9bcbdbed"
                    },
                    "balanceId": {
                        "title": "Customer balance ID",
                        "description": "balanceId",
                        "type": "string",
                        "format": "string",
                        "example": "29bacfc2-124d-433a-a9cf-8c7a9bcbdbed"
                    }
                },
                "type": "object"
            },
            "CardGetAll": {
                "title": "CardCollection",
                "description": "Card collection",
                "type": "object",
                "allOf": [
                    {
                        "$ref": "#/components/schemas/PaginatedCollection"
                    },
                    {
                        "properties": {
                            "data": {
                                "title": "data",
                                "description": "data",
                                "type": "array",
                                "format": "array",
                                "items": {
                                    "$ref": "#/components/schemas/Card"
                                }
                            }
                        },
                        "type": "object"
                    }
                ]
            },
            "SimpleVirtualCardResource": {
                "title": "SimpleVirtualCardResource",
                "description": "SimpleVirtualCardResource",
                "properties": {
                    "id": {
                        "title": "DataCore card id",
                        "description": "Id",
                        "type": "integer",
                        "format": "int",
                        "example": "1125"
                    },
                    "issuerCardId": {
                        "title": "Issuer card id",
                        "description": "Id from card issuer",
                        "type": "string",
                        "format": "string",
                        "example": "704144800000021"
                    }
                },
                "type": "object"
            },
            "VirtualCardResource": {
                "title": "VirtualCardResource",
                "description": "VirtualCardResource",
                "properties": {
                    "id": {
                        "title": "DataCore card id",
                        "description": "Id",
                        "type": "integer",
                        "format": "int",
                        "example": "1125"
                    },
                    "cardNo": {
                        "title": "card number",
                        "description": "card full pan number",
                        "type": "string",
                        "format": "string",
                        "example": "5227128362110426"
                    },
                    "exp": {
                        "title": "card expiration date. Format: Y-m-d ",
                        "description": "card expiration date. Format: Y-m-d ",
                        "type": "string",
                        "format": "date",
                        "example": "2026-01-31"
                    },
                    "cvv": {
                        "title": "cvv",
                        "description": "card security code",
                        "type": "string",
                        "format": "string",
                        "example": "573"
                    },
                    "issuerCardId": {
                        "title": "Issuer card id",
                        "description": "Id from card issuer",
                        "type": "string",
                        "format": "string",
                        "example": "704144800000021"
                    }
                },
                "type": "object"
            },
            "CDD": {
                "title": "CDD",
                "description": "Customer Due Diligence object",
                "properties": {
                    "id": {
                        "description": "Id of CDD",
                        "type": "string",
                        "format": "uuid",
                        "example": "9d52da25-76ce-474a-a379-a66ac07ea8f6"
                    },
                    "verificationId": {
                        "description": "Id of Verification",
                        "type": "string",
                        "format": "uuid",
                        "example": "900a18b5-ca04-4bb2-8403-b2fdeeb0e084"
                    },
                    "listName": {
                        "description": "Checked where",
                        "type": "string",
                        "example": "known-list-published-on-1997-04-02-by-ACME"
                    },
                    "sourceName": {
                        "description": "Checked by whom",
                        "type": "string",
                        "example": "Elizabeth"
                    },
                    "date": {
                        "description": "Checked when",
                        "type": "string",
                        "format": "date-time",
                        "example": "2021-05-06T20:08:33+00:00"
                    }
                },
                "type": "object"
            },
            "CddCollection": {
                "title": "CddCollection",
                "description": "Cdd collection",
                "type": "object",
                "allOf": [
                    {
                        "$ref": "#/components/schemas/PaginatedCollection"
                    },
                    {
                        "properties": {
                            "data": {
                                "title": "data",
                                "description": "data",
                                "type": "array",
                                "format": "array",
                                "items": {
                                    "$ref": "#/components/schemas/CDD"
                                }
                            }
                        },
                        "type": "object"
                    }
                ]
            },
            "KycData": {
                "title": "KycData",
                "description": "KYC data for a verification",
                "properties": {
                    "id": {
                        "type": "string",
                        "format": "uuid",
                        "example": "e389e2c2-f99d-11ea-adc1-0242ac120002"
                    },
                    "status": {
                        "type": "string",
                        "example": "accepted"
                    },
                    "customerId": {
                        "type": "integer",
                        "example": 1125
                    },
                    "createdAt": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2026-07-27 12:03:45"
                    },
                    "updatedAt": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2026-07-27 12:03:45"
                    },
                    "kycLevel": {
                        "type": "string",
                        "example": "HIGH",
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "Verification": {
                "title": "Verification",
                "description": "Verification Resource",
                "properties": {
                    "id": {
                        "title": "Id",
                        "description": "Id",
                        "type": "string",
                        "format": "string",
                        "example": "e389e2c2-f99d-11ea-adc1-0242ac120002"
                    },
                    "status": {
                        "title": "status",
                        "description": "status",
                        "type": "string",
                        "format": "string",
                        "example": "accepted"
                    },
                    "customerId": {
                        "title": "customerId",
                        "description": "customerId",
                        "type": "integer",
                        "format": "int",
                        "example": "7"
                    },
                    "firstName": {
                        "title": "firstName",
                        "description": "firstName",
                        "type": "string",
                        "format": "string",
                        "example": "John"
                    },
                    "lastName": {
                        "title": "lastName",
                        "description": "lastName",
                        "type": "string",
                        "format": "string",
                        "example": "Doe"
                    },
                    "birthDate": {
                        "title": "birthDate",
                        "description": "birthDate",
                        "type": "string",
                        "format": "date",
                        "example": "1970-01-01"
                    },
                    "nationality": {
                        "title": "nationality",
                        "description": "nationality",
                        "type": "string",
                        "format": "string",
                        "example": "polish"
                    },
                    "riskLvl": {
                        "title": "rislLvl",
                        "description": "riskLvl",
                        "type": "string",
                        "format": "string",
                        "enum": [
                            "HIGH",
                            "NORMAL",
                            "LOW",
                            "NOT_ACCEPTABLE"
                        ],
                        "example": "LOW"
                    },
                    "nextVerificationDate": {
                        "title": "nextVerificationDate",
                        "description": "nextVerificationDate",
                        "type": "string",
                        "format": "date",
                        "example": "2020-01-20 12:03:45"
                    },
                    "createdAt": {
                        "title": "createdAt",
                        "description": "createdAt",
                        "type": "string",
                        "format": "date",
                        "example": "2020-01-20 12:03:45",
                        "nullable": true
                    },
                    "updatedAt": {
                        "title": "updatedAt",
                        "description": "updatedAt",
                        "type": "string",
                        "format": "date",
                        "example": "2020-01-20 12:03:45"
                    },
                    "usaResident": {
                        "title": "usaResident",
                        "description": "Is USA tax resident",
                        "type": "boolean",
                        "format": "boolean",
                        "example": "true",
                        "nullable": true
                    },
                    "taxResident": {
                        "description": "Is list of countries customer tax residentIs",
                        "type": "array",
                        "items": {
                            "type": "string",
                            "example": "DEU"
                        },
                        "nullable": true
                    },
                    "rejectReason": {
                        "title": "rejectReason",
                        "description": "Reasons for verification rejection",
                        "type": "array",
                        "items": {
                            "type": "string",
                            "enum": [
                                "INVALID_CUSTOMER_DATA",
                                "BLURRED_DOCUMENT_PHOTO",
                                "INVALID_DOCUMENT_PHOTO",
                                "BLURRED_SELFIE",
                                "INVALID_SELFIE",
                                "RESTRICTED_PESEL",
                                "INCORRECT_PESEL",
                                "UNDERAGE",
                                "ILLEGAL_DOCUMENT",
                                "EXPIRED_DOCUMENT",
                                "MISSING_ENTIRE_DOCUMENT",
                                "SELFIE_WITHOUT_DOCUMENT",
                                "FACE_COVERED",
                                "PAYMENT_CARD_NOT_DOCUMENT",
                                "MISSING_DIACRITICAL_MARKS",
                                "NON_LATIN_ALPHABET",
                                "OUTSIDE_EEA",
                                "ILLEGAL_EMAIL",
                                "NOT_MATCH_PREFIX"
                            ],
                            "example": "EXPIRED_DOCUMENT"
                        }
                    },
                    "sourceOfFounds": {
                        "description": "All sources of founds customer set in JSON",
                        "properties": {
                            "business_activity": {
                                "schema": "objectArray",
                                "type": "array",
                                "items": {
                                    "properties": {
                                        "nip": {
                                            "description": "VAT number",
                                            "type": "string",
                                            "example": "5934273049"
                                        },
                                        "regon": {
                                            "description": "National Business Registry Number",
                                            "type": "string",
                                            "example": "DSD-5492/44004"
                                        }
                                    },
                                    "type": "object"
                                },
                                "nullable": true
                            },
                            "maintained_by_family": {
                                "schema": "objectArray",
                                "type": "array",
                                "items": {
                                    "properties": {
                                        "first_name": {
                                            "type": "string",
                                            "example": "John"
                                        },
                                        "last_name": {
                                            "type": "string",
                                            "example": "Smith"
                                        },
                                        "birth_date": {
                                            "type": "string",
                                            "format": "date",
                                            "example": "22-12-1950"
                                        }
                                    },
                                    "type": "object"
                                },
                                "nullable": true
                            }
                        },
                        "type": "object",
                        "nullable": "true"
                    },
                    "customData": {
                        "title": "customData",
                        "description": "Custom verification data provided by client",
                        "type": "object",
                        "example": {
                            "customerHeight": "180cm",
                            "locationOfBirth": "Lagos, Nigeria",
                            "nin": "12345678901"
                        },
                        "nullable": "true"
                    },
                    "financialInstitutions": {
                        "title": "financialInstitutions",
                        "description": "Financial institution data grouped by institution name",
                        "type": "object",
                        "example": {
                            "unblock": {
                                "uniqueCode": "UNIQ-13458"
                            }
                        },
                        "additionalProperties": {
                            "type": "object"
                        }
                    },
                    "address": {
                        "$ref": "#/components/schemas/VerificationAddress"
                    }
                },
                "type": "object"
            },
            "VerificationAddress": {
                "properties": {
                    "city": {
                        "title": "City",
                        "description": "city",
                        "type": "string",
                        "example": "Lublin"
                    },
                    "street": {
                        "title": "Street",
                        "description": "street",
                        "type": "string",
                        "example": "Rusałka"
                    },
                    "number": {
                        "title": "House number",
                        "description": "number",
                        "type": "string",
                        "example": "17a",
                        "nullable": true
                    },
                    "apartment": {
                        "title": "Apartment number",
                        "description": "apartment",
                        "type": "string",
                        "example": "2",
                        "nullable": true
                    },
                    "postCode": {
                        "title": "Post code",
                        "description": "postCode",
                        "type": "string",
                        "example": "20-128"
                    },
                    "province": {
                        "title": "Province",
                        "description": "province",
                        "type": "string",
                        "example": "Mazowieckie",
                        "nullable": true
                    },
                    "country": {
                        "title": "Country Alpha-2 code in ISO-3166",
                        "description": "country",
                        "type": "string",
                        "example": "PL"
                    }
                },
                "type": "object"
            },
            "VerificationCollection": {
                "title": "VerificationCollection",
                "description": "Verification Resource",
                "properties": {
                    "data": {
                        "title": "data",
                        "description": "data",
                        "type": "array",
                        "format": "array",
                        "items": {
                            "$ref": "#/components/schemas/Verification"
                        }
                    },
                    "links": {
                        "$ref": "#/components/schemas/PaginatorLinks"
                    },
                    "meta": {
                        "$ref": "#/components/schemas/PaginatorMeta"
                    }
                },
                "type": "object"
            },
            "VerificationCustomer": {
                "properties": {
                    "id": {
                        "title": "DataCore user id",
                        "description": "id",
                        "type": "integer",
                        "example": "7",
                        "nullable": true
                    },
                    "firstName": {
                        "title": "First name",
                        "description": "firstName",
                        "type": "string",
                        "example": "John"
                    },
                    "lastName": {
                        "title": "Last name",
                        "description": "lastName",
                        "type": "string",
                        "example": "Doe"
                    },
                    "birthDate": {
                        "title": "Birth date",
                        "description": "birthDate",
                        "type": "string",
                        "format": "date",
                        "example": "1970-01-01"
                    }
                },
                "type": "object"
            },
            "VerificationDetails": {
                "title": "VerificationDetails",
                "description": "VerificationDetailsResource",
                "type": "object",
                "allOf": [
                    {
                        "$ref": "#/components/schemas/Verification"
                    },
                    {
                        "properties": {
                            "pesel": {
                                "title": "pesel",
                                "description": "Customer PESEL",
                                "type": "string",
                                "example": "70010155587",
                                "nullable": true
                            },
                            "identityCardNo": {
                                "title": "identityCardNo",
                                "description": "Number of identity card",
                                "type": "string",
                                "example": "ARG691869",
                                "nullable": true
                            },
                            "kycLevel": {
                                "title": "kycLevel",
                                "description": "KYC Level",
                                "type": "string",
                                "example": "LOW,MEDIUM,HIGH,EXTENDED",
                                "nullable": true
                            },
                            "customer": {
                                "$ref": "#/components/schemas/VerificationCustomer"
                            },
                            "address": {
                                "$ref": "#/components/schemas/VerificationAddress"
                            },
                            "documents": {
                                "title": "documents",
                                "description": "Verification documents",
                                "type": "array",
                                "items": {
                                    "$ref": "#/components/schemas/VerificationDocument"
                                }
                            }
                        },
                        "type": "object"
                    }
                ]
            },
            "VerificationDocument": {
                "title": "VerificationDocument",
                "description": "Verification document resource",
                "properties": {
                    "id": {
                        "title": "Document identifier",
                        "description": "id",
                        "type": "string",
                        "format": "uuid",
                        "example": "70f91efb-3989-4289-916c-db4eed741a4e"
                    },
                    "type": {
                        "title": "Type of document",
                        "description": "type",
                        "type": "string",
                        "format": "string",
                        "example": "idCard"
                    },
                    "url": {
                        "title": "Document URL",
                        "description": "url",
                        "type": "string",
                        "format": "url",
                        "example": "https://example.com/example.png"
                    },
                    "documentExpirationDate": {
                        "description": "Document expiration Date",
                        "type": "string",
                        "format": "date",
                        "example": "2025-01-30"
                    }
                },
                "type": "object"
            },
            "LockCollection": {
                "title": "LockCollection",
                "description": "Resource locks collection",
                "type": "object",
                "allOf": [
                    {
                        "$ref": "#/components/schemas/PaginatedCollection"
                    },
                    {
                        "properties": {
                            "data": {
                                "title": "data",
                                "description": "data",
                                "type": "array",
                                "format": "array",
                                "items": {
                                    "$ref": "#/components/schemas/LockResource"
                                }
                            }
                        },
                        "type": "object"
                    }
                ]
            },
            "LockResource": {
                "title": "Lock",
                "description": "Resource lock object",
                "properties": {
                    "id": {
                        "description": "unique identifier",
                        "format": "uuid",
                        "example": "492ec5ee-7f66-11ec-a8a3-0242ac120002"
                    },
                    "resourceType": {
                        "description": "Type of resource to be locked",
                        "type": "string",
                        "enum": [
                            "customer",
                            "corporation"
                        ],
                        "example": "customer"
                    },
                    "resourceId": {
                        "description": "Resource identifier",
                        "type": "string",
                        "example": "1337"
                    },
                    "reason": {
                        "description": "reason of resource lock",
                        "type": "string",
                        "enum": [
                            "DOCUMENT_EXPIRED",
                            "FRAUD_SUSPECTED",
                            "SCREENING_DETECTED",
                            "TEMPORARY_LOCKED",
                            "PEKAO_LOCK",
                            "ZEN_LOCK",
                            "PROSECUTOR_LOCK",
                            "FENIGE_LOCK",
                            "POLICE_LOCK",
                            "MANY_CARDS_LOCK",
                            "NEGATIVE_VERIFICATION",
                            "PRADO_VERIFICATION"
                        ],
                        "example": "DOCUMENT_EXPIRED"
                    }
                },
                "type": "object"
            },
            "MasterBalance": {
                "title": "MasterBalance",
                "description": "Master Balance",
                "properties": {
                    "id": {
                        "title": "Master Balance Identifier",
                        "description": "id",
                        "type": "string",
                        "format": "uuid",
                        "example": "97eee13e-7669-11eb-9439-0242ac130002"
                    },
                    "currency": {
                        "title": "Currency code ISO 4217",
                        "description": "currency",
                        "type": "string",
                        "format": "string",
                        "example": "PLN"
                    },
                    "balance": {
                        "title": "Balance in gross",
                        "description": "balance",
                        "type": "integer",
                        "format": "int",
                        "example": "1567"
                    },
                    "type": {
                        "title": "Type of Balance",
                        "description": "balance",
                        "type": "string",
                        "format": "string",
                        "example": "[CREDIT / DEPOSIT]"
                    },
                    "dcCorporationId": {
                        "title": "dcCorporationId",
                        "description": "DC Id of corporation",
                        "type": "string",
                        "format": "uuid",
                        "example": "97eee13e-7669-11eb-9439-0242ac137777",
                        "nullable": true
                    },
                    "createdAt": {
                        "title": "createdAt",
                        "description": "createdAt",
                        "type": "string",
                        "format": "date",
                        "example": {
                            "date": "2023-03-02 13:21:37.000000",
                            "timezone_type": 3,
                            "timezone": "UTC"
                        }
                    },
                    "updatedAt": {
                        "title": "updatedAt",
                        "description": "updatedAt",
                        "type": "string",
                        "format": "date",
                        "example": {
                            "date": "2023-09-02 13:21:37.000000",
                            "timezone_type": 3,
                            "timezone": "UTC"
                        }
                    }
                },
                "type": "object"
            },
            "PaginatedCollection": {
                "title": "PaginatedCollection",
                "description": "Paginated resource collection",
                "properties": {
                    "data": {
                        "title": "data",
                        "description": "data",
                        "type": "array",
                        "format": "array",
                        "items": {}
                    },
                    "links": {
                        "$ref": "#/components/schemas/PaginatorLinks"
                    },
                    "meta": {
                        "$ref": "#/components/schemas/PaginatorMeta"
                    }
                },
                "type": "object"
            },
            "DailySettlement": {
                "title": "DailySettlement",
                "description": "Daily Settlement object",
                "properties": {
                    "id": {
                        "title": "Daily Settlement identifier",
                        "description": "Internal settlement identifier",
                        "type": "string",
                        "format": "uuid",
                        "example": "97eee13e-7669-11eb-9439-0242ac130002"
                    },
                    "transactionDate": {
                        "title": "Transaction date",
                        "description": "Date and time related transaction was performed",
                        "type": "string",
                        "format": "date-time",
                        "example": "2020-01-20 12:03:45"
                    },
                    "transactionId": {
                        "title": "Transaction external identifier",
                        "description": "External identifier of related transaction",
                        "type": "string",
                        "example": "00812304"
                    },
                    "amount": {
                        "title": "Transaction amount",
                        "description": "Amount expressed in currency fractional unit",
                        "type": "integer",
                        "example": "350"
                    },
                    "currency": {
                        "title": "Transaction currency",
                        "description": "Currency code ISO 4217",
                        "type": "string",
                        "example": "PLN"
                    },
                    "cardId": {
                        "title": "Card identifier",
                        "description": "DataCore card id",
                        "type": "integer",
                        "example": "10181"
                    },
                    "type": {
                        "title": "Transaction event type",
                        "description": "Event type, one of: DEDUCT, LOAD",
                        "type": "string",
                        "example": "Deduct"
                    },
                    "configId": {
                        "title": "Configuration identifier",
                        "description": "Card configuration identifier",
                        "type": "string",
                        "example": "0013009713"
                    },
                    "processedAt": {
                        "title": "Processed at",
                        "description": "Date and time settlement has been processed. Null if not processed yet.",
                        "type": "string",
                        "format": "date-time",
                        "example": null,
                        "nullable": true
                    },
                    "description": {
                        "title": "description",
                        "description": "Description of daily settlement.",
                        "type": "string",
                        "example": "AE Sklep POLPOL"
                    }
                },
                "type": "object"
            },
            "DailySettlementCollection": {
                "title": "DailySettlementCollection",
                "description": "Daily Settlement resource collection",
                "type": "object",
                "allOf": [
                    {
                        "$ref": "#/components/schemas/PaginatedCollection"
                    },
                    {
                        "properties": {
                            "data": {
                                "title": "data",
                                "description": "data",
                                "type": "array",
                                "format": "array",
                                "items": {
                                    "$ref": "#/components/schemas/DailySettlement"
                                }
                            }
                        },
                        "type": "object"
                    }
                ]
            },
            "DailySettlementDetails": {
                "title": "DailySettlementDetails",
                "description": "Detailed Daily Settlement object",
                "type": "object",
                "allOf": [
                    {
                        "$ref": "#/components/schemas/DailySettlement"
                    },
                    {
                        "properties": {
                            "settlementAmount": {
                                "title": "Settlement amount",
                                "description": "Amount expressed in currency fractional unit",
                                "type": "integer",
                                "example": "350"
                            },
                            "transactionNarrative": {
                                "title": "Transaction Narrative",
                                "description": "Transaction description consists of MerchantName followed by three digit country code ISO 3166-1",
                                "type": "string",
                                "example": "MariuszPol POL"
                            },
                            "transactionType": {
                                "title": "Transaction type",
                                "description": "2 character string identifying the type of transaction: 00 => POS, 01 => ATM, 02 => Adjustment, 09 => Cashback at POS, 21 => Deposit",
                                "type": "string",
                                "example": "00"
                            },
                            "systemDate": {
                                "title": "System date",
                                "description": "Date and time transaction was performed",
                                "type": "string",
                                "format": "date-time",
                                "example": "2020-01-20 12:03:45"
                            },
                            "sequenceNumber": {
                                "title": "Sequence Number",
                                "description": "Sequence Number",
                                "type": "string",
                                "example": "13"
                            },
                            "trackingNumber": {
                                "title": "Tracking Number",
                                "description": "Tracking Number",
                                "type": "string",
                                "example": "213142400000013"
                            },
                            "interchangeAmount": {
                                "title": "Interchange amount",
                                "description": "Interchange amount expressed in currency fractional unit",
                                "type": "integer",
                                "example": "350"
                            }
                        },
                        "type": "object"
                    }
                ]
            },
            "ExportedReport": {
                "title": "ExportedReport",
                "description": "Exported report resource",
                "properties": {
                    "url": {
                        "title": "Report URL",
                        "description": "url",
                        "type": "string",
                        "format": "url",
                        "example": "https://example.com/example.png"
                    }
                },
                "type": "object"
            },
            "CollateralBalanceTransaction": {
                "title": "CollateralBalanceTransaction",
                "description": "Transaction object",
                "properties": {
                    "id": {
                        "title": "Transaction identifier",
                        "description": "Internal transaction identifier",
                        "type": "string",
                        "format": "uuid",
                        "example": "97eee13e-7669-11eb-9439-0242ac130002"
                    },
                    "externalId": {
                        "title": "Transaction external identifier",
                        "description": "Transaction external identifier",
                        "type": "string",
                        "example": "97eee13e-9439-11eb-7669-0242ac130002"
                    },
                    "transactionDate": {
                        "title": "Transaction date",
                        "description": "Date and time transaction was performed",
                        "type": "string",
                        "format": "date-time",
                        "example": "2020-01-20 12:03:45"
                    },
                    "amount": {
                        "title": "Transaction amount",
                        "description": "Initial amount expressed in currency fractional unit",
                        "type": "integer",
                        "example": "350"
                    },
                    "currency": {
                        "title": "Transaction currency",
                        "description": "Currency code ISO 4217",
                        "type": "string",
                        "example": "PLN"
                    },
                    "type": {
                        "title": "Transaction type",
                        "description": "Transaction type, one of: collateralCredit, collateralDebit, collateralForcedDebit",
                        "type": "string",
                        "example": "collateralDebit"
                    },
                    "status": {
                        "title": "Transaction status",
                        "description": "Status of transaction, one of: AUTHORIZED, CLEARED, REVERSED, ERROR",
                        "type": "string",
                        "example": "AUTHORIZED"
                    },
                    "description": {
                        "title": "Transaction description",
                        "description": "",
                        "type": "string",
                        "example": "service fee"
                    }
                },
                "type": "object"
            },
            "CollateralBalanceTransactionCollection": {
                "title": "CollateralBalanceTransactionCollection",
                "description": "CollateralBalanceTransaction resource collection",
                "type": "object",
                "allOf": [
                    {
                        "$ref": "#/components/schemas/PaginatedCollection"
                    },
                    {
                        "properties": {
                            "data": {
                                "title": "data",
                                "description": "data",
                                "type": "array",
                                "format": "array",
                                "items": {
                                    "$ref": "#/components/schemas/CollateralBalanceTransaction"
                                }
                            }
                        },
                        "type": "object"
                    }
                ]
            },
            "Transaction": {
                "title": "Transaction",
                "description": "Transaction object",
                "properties": {
                    "id": {
                        "title": "Transaction identifier",
                        "description": "Internal transaction identifier",
                        "type": "string",
                        "format": "uuid",
                        "example": "97eee13e-7669-11eb-9439-0242ac130002"
                    },
                    "externalId": {
                        "title": "Transaction external identifier",
                        "description": "Transaction external identifier",
                        "type": "string",
                        "example": "97eee13e-9439-11eb-7669-0242ac130002"
                    },
                    "transactionDate": {
                        "title": "Transaction date",
                        "description": "Date and time transaction was performed",
                        "type": "string",
                        "format": "date-time",
                        "example": "2020-01-20 12:03:45"
                    },
                    "amount": {
                        "title": "Transaction amount",
                        "description": "Initial amount expressed in currency fractional unit",
                        "type": "integer",
                        "example": "350"
                    },
                    "finalAmount": {
                        "title": "Transaction final amount",
                        "description": "Final amount of transaction. Equals to amount + adjustmentAmount - reversalAmount",
                        "type": "integer",
                        "example": "160"
                    },
                    "currency": {
                        "title": "Transaction currency",
                        "description": "Currency code ISO 4217",
                        "type": "string",
                        "example": "PLN"
                    },
                    "eventType": {
                        "title": "Transaction event type",
                        "description": "Event type, one of: Deduct, DeductAdjustment, LoadAdjustment",
                        "type": "string",
                        "example": "Deduct"
                    },
                    "customerId": {
                        "title": "Customer identifier",
                        "description": "DataCore user id",
                        "type": "integer",
                        "example": "7"
                    },
                    "cardId": {
                        "title": "Card identifier",
                        "description": "DataCore card id",
                        "type": "integer",
                        "example": "10181"
                    },
                    "configId": {
                        "title": "Configuration identifier",
                        "description": "Card configuration identifier",
                        "type": "string",
                        "example": "0013009713"
                    },
                    "status": {
                        "title": "Transaction status",
                        "description": "Status of transaction, one of: AUTHORIZED, CLEARED, REVERSED, ERROR",
                        "type": "string",
                        "example": "AUTHORIZED"
                    },
                    "description": {
                        "title": "Transaction description",
                        "description": "",
                        "type": "string",
                        "example": "Audioteka WARSZAWA"
                    },
                    "type": {
                        "title": "Transaction type",
                        "description": "",
                        "type": "string",
                        "example": "forexCredit"
                    }
                },
                "type": "object"
            },
            "TransactionCollection": {
                "title": "TransactionCollection",
                "description": "Transaction resource collection",
                "type": "object",
                "allOf": [
                    {
                        "$ref": "#/components/schemas/PaginatedCollection"
                    },
                    {
                        "properties": {
                            "data": {
                                "title": "data",
                                "description": "data",
                                "type": "array",
                                "format": "array",
                                "items": {
                                    "$ref": "#/components/schemas/Transaction"
                                }
                            }
                        },
                        "type": "object"
                    }
                ]
            },
            "TransactionDetails": {
                "title": "TransactionDetails",
                "description": "Detailed transaction object",
                "type": "object",
                "allOf": [
                    {
                        "$ref": "#/components/schemas/Transaction"
                    },
                    {
                        "properties": {
                            "adjustmentAmount": {
                                "title": "Transaction adjustment amount",
                                "description": "Summarised amount of adjustments related to transaction",
                                "type": "integer",
                                "example": "10"
                            },
                            "reversalAmount": {
                                "title": "Transaction reversal amount",
                                "description": "Summarised amount of reversals related to transaction",
                                "type": "integer",
                                "example": "200"
                            },
                            "finalAmount": {
                                "title": "Transaction final amount",
                                "description": "Final amount of transaction. Equals to amount + adjustmentAmount - reversalAmount",
                                "type": "integer",
                                "example": "160"
                            },
                            "type": {
                                "title": "Type of transaction",
                                "description": "2 character string identifying the type of transaction: 00 => POS, 01 => ATM, 02 => Adjustment, 09 => Cashback at POS, 21 => Deposit",
                                "type": "string",
                                "example": "00",
                                "nullable": true
                            },
                            "captureMode": {
                                "title": "Capture mode",
                                "description": "Identify type of MDES transaction",
                                "type": "string",
                                "example": "ECOM",
                                "nullable": true
                            },
                            "area": {
                                "title": "Area of transaction",
                                "description": "Area of transaction, specific per project to distinguish transaction from many company areas like P2P, UCP etc.",
                                "type": "string",
                                "example": "PREPAID",
                                "nullable": true
                            },
                            "transactionEvents": {
                                "title": "Transaction Events",
                                "description": "Collection of events related to transaction",
                                "type": "array",
                                "items": {
                                    "$ref": "#/components/schemas/TransactionEvent"
                                }
                            }
                        },
                        "type": "object"
                    }
                ]
            },
            "TransactionEvent": {
                "title": "TransactionEvent",
                "description": "Transaction Event object",
                "properties": {
                    "id": {
                        "title": "Transaction Event Identifier",
                        "description": "Transaction Event Identifier",
                        "type": "string",
                        "format": "uuid",
                        "example": "f661b8d8-3587-4642-a43d-42837e174044"
                    },
                    "type": {
                        "title": "Transaction Event type",
                        "description": "Event type, one of: Deduct, DeductAdjustment, LoadAdjustment",
                        "type": "string",
                        "example": "Deduct"
                    },
                    "transactionExternalId": {
                        "title": "Transaction Event external identifier",
                        "description": "Transaction Event external identifier",
                        "type": "string",
                        "format": "uuid",
                        "example": "79b97b81-52de-4ef6-b781-39b873ee6752"
                    },
                    "referenceTransactionExternalId": {
                        "title": "Reference Transaction external identifier",
                        "description": "External identifier of referenced Transaction",
                        "type": "string",
                        "example": null,
                        "nullable": true
                    },
                    "cardId": {
                        "title": "Card identifier",
                        "description": "DataCore card id",
                        "type": "integer",
                        "example": "10181"
                    },
                    "customerId": {
                        "title": "Customer identifier",
                        "description": "DataCore user id",
                        "type": "integer",
                        "example": "7"
                    },
                    "amount": {
                        "title": "Transaction Event amount",
                        "description": "Event amount expressed in currency fractional unit",
                        "type": "integer",
                        "example": "350"
                    },
                    "originalAmount": {
                        "title": "Original Amount",
                        "description": "Original Amount",
                        "type": "integer",
                        "example": null,
                        "nullable": true
                    },
                    "originalCurrency": {
                        "title": "Original Currency",
                        "description": "Original Currency",
                        "type": "string",
                        "example": null,
                        "nullable": true
                    },
                    "description": {
                        "title": "Description",
                        "description": "Transaction description consists of MerchantName followed by three digit country code ISO 3166-1",
                        "type": "string",
                        "example": "MariuszPol POL",
                        "nullable": true
                    },
                    "transactionType": {
                        "title": "Type of transaction",
                        "description": "2 character string identifying the type of transaction: 00 => POS, 01 => ATM, 02 => Adjustment, 09 => Cashback at POS, 21 => Deposit",
                        "type": "string",
                        "example": "00",
                        "nullable": true
                    },
                    "adjustmentReason": {
                        "title": "Adjustment reason",
                        "description": "Adjustment reason",
                        "type": "string",
                        "example": null,
                        "nullable": true
                    },
                    "additionalData": {
                        "title": "Additional Data",
                        "description": "Additional data in KLV format",
                        "type": "string",
                        "example": null,
                        "nullable": true
                    },
                    "transactionDate": {
                        "title": "Transaction date",
                        "description": "Date and time transaction was performed",
                        "type": "string",
                        "format": "date",
                        "example": "2020-01-20 12:03:45"
                    },
                    "referenceTransactionDate": {
                        "title": "Referenced Transaction date",
                        "description": "Date and time referenced transaction was performed",
                        "type": "string",
                        "format": "date",
                        "example": null,
                        "nullable": true
                    },
                    "cardTrackingNumber": {
                        "title": "Card tracking number",
                        "description": "Card tracking number",
                        "type": "string",
                        "example": null,
                        "nullable": true
                    },
                    "configId": {
                        "title": "Configuration identifier",
                        "description": "Card configuration identifier",
                        "type": "string",
                        "example": "0013009713"
                    },
                    "status": {
                        "title": "Transaction status",
                        "description": "Status of transaction, one of: AUTHORIZED, CLEARED, REVERSED, ERROR",
                        "type": "string",
                        "example": "AUTHORIZED"
                    },
                    "declineReason": {
                        "title": "Decline reason",
                        "description": "Decline reason",
                        "type": "string",
                        "example": null,
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "BalanceLimitCreateRequest": {
                "required": [
                    "type",
                    "maxAmount",
                    "period"
                ],
                "properties": {
                    "type": {
                        "description": "Type of balance limit (case-insensitive): CASH_OUT - outgoing card transactions, CASH_IN - incoming funds (currently not enforced).",
                        "type": "string",
                        "enum": [
                            "CASH_IN",
                            "CASH_OUT"
                        ],
                        "example": "CASH_OUT"
                    },
                    "maxAmount": {
                        "description": "Maximum amount within the period, in minor units of the balance currency (e.g. 50000 = 500.00). 0 blocks all transactions covered by the limit.",
                        "type": "integer",
                        "format": "int64",
                        "minimum": 0,
                        "example": 50000
                    },
                    "period": {
                        "description": "Period after which the used amount is reset (case-insensitive): DAILY - every day at 23:59, WEEKLY - every Monday at 00:00, MONTHLY - on the 1st day of the month at 00:00.",
                        "type": "string",
                        "enum": [
                            "DAILY",
                            "WEEKLY",
                            "MONTHLY"
                        ],
                        "example": "MONTHLY"
                    },
                    "expiration": {
                        "description": "Date after which the limit is no longer enforced. Must be later than today. Without expiration the limit is permanent.",
                        "type": "string",
                        "format": "date",
                        "example": "2099-12-24",
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "BalanceLimitUpdateRequest": {
                "description": "Only the passed fields are changed. Type, period and currency of a limit cannot be changed.",
                "properties": {
                    "maxAmount": {
                        "description": "Maximum amount within the period, in minor units of the balance currency.",
                        "type": "integer",
                        "format": "int64",
                        "minimum": 0,
                        "example": 100000
                    },
                    "expiration": {
                        "description": "Date after which the limit is no longer enforced. Must be later than today. Null makes the limit permanent.",
                        "type": "string",
                        "format": "date",
                        "example": "2099-12-24",
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "CardLimitCreateRequest": {
                "required": [
                    "type"
                ],
                "properties": {
                    "type": {
                        "description": "Type of card limit (case-insensitive). Fields required by each type are listed in the endpoint description.",
                        "type": "string",
                        "enum": [
                            "TRX_ALL",
                            "TRX_E_COM",
                            "TRX_ATM",
                            "POS",
                            "FOREIGN_AMOUNT",
                            "FOREIGN_QUANTITY",
                            "QUANTITY",
                            "AMOUNT_PLN",
                            "AMOUNT_EUR",
                            "MCC_BLACKLIST",
                            "MCC_WHITELIST",
                            "MERCHANT_ID_BLACKLIST",
                            "MERCHANT_ID_WHITELIST"
                        ],
                        "example": "TRX_ALL"
                    },
                    "maxAmount": {
                        "description": "Maximum total amount of transactions covered by the limit, in minor units of the card currency (e.g. 50000 = 500.00). If the maximum limit value feature is enabled, values above the configured maximum are rejected with OVER_THE_LIMIT.",
                        "type": "integer",
                        "format": "int64",
                        "minimum": 0,
                        "example": 50000
                    },
                    "maxAttempts": {
                        "description": "Maximum number of transactions covered by the limit.",
                        "type": "integer",
                        "minimum": 0,
                        "example": 10
                    },
                    "period": {
                        "description": "Period after which the limit usage is reset (case-insensitive): DAILY - every day at 23:59, WEEKLY - every Monday at 00:00, MONTHLY - on the 1st day of the month at 00:00. Without a period the usage is never reset.",
                        "type": "string",
                        "enum": [
                            "DAILY",
                            "WEEKLY",
                            "MONTHLY"
                        ],
                        "example": "MONTHLY"
                    },
                    "expiration": {
                        "description": "Date after which the limit is no longer checked. Must be later than today.",
                        "type": "string",
                        "format": "date",
                        "example": "2099-12-24"
                    },
                    "mcc_list": {
                        "description": "Merchant category codes. Required (non-empty) for MCC_BLACKLIST and MCC_WHITELIST, not used by other types.",
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "example": [
                            "5812",
                            "5814"
                        ]
                    },
                    "merchant_id_list": {
                        "description": "Merchant identifiers. Required (non-empty) for MERCHANT_ID_BLACKLIST and MERCHANT_ID_WHITELIST, not used by other types.",
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "example": [
                            "9AF3C2B1D4E5"
                        ]
                    }
                },
                "type": "object"
            },
            "CardLimitType": {
                "description": "Type of card limit. ONE_SHOT is created by the system for disposable cards and only appears in responses.",
                "type": "string",
                "enum": [
                    "TRX_ALL",
                    "TRX_E_COM",
                    "TRX_ATM",
                    "POS",
                    "FOREIGN_AMOUNT",
                    "FOREIGN_QUANTITY",
                    "QUANTITY",
                    "AMOUNT_PLN",
                    "AMOUNT_EUR",
                    "MCC_BLACKLIST",
                    "MCC_WHITELIST",
                    "MERCHANT_ID_BLACKLIST",
                    "MERCHANT_ID_WHITELIST",
                    "ONE_SHOT"
                ],
                "example": "TRX_ALL"
            },
            "CardLimitUpdateRequest": {
                "description": "Only the passed fields are changed. Type and currency of a limit cannot be changed. The rules of the limit type are checked again on the values after the change.",
                "properties": {
                    "maxAmount": {
                        "description": "Maximum total amount of transactions in minor units of the card currency. Null removes the amount condition (not allowed for types that require maxAmount).",
                        "type": "integer",
                        "format": "int64",
                        "minimum": 0,
                        "example": 50000,
                        "nullable": true
                    },
                    "maxAttempts": {
                        "description": "Maximum number of transactions. Null removes the quantity condition (not allowed for types that require maxAttempts).",
                        "type": "integer",
                        "minimum": 0,
                        "example": 10,
                        "nullable": true
                    },
                    "period": {
                        "description": "Period after which the limit usage is reset (case-insensitive).",
                        "type": "string",
                        "enum": [
                            "DAILY",
                            "WEEKLY",
                            "MONTHLY"
                        ],
                        "example": "MONTHLY"
                    },
                    "expiration": {
                        "description": "Date after which the limit is no longer checked. Must be later than today.",
                        "type": "string",
                        "format": "date",
                        "example": "2099-12-24"
                    }
                },
                "type": "object"
            },
            "SecureCardLimitUpdateRequest": {
                "type": "object",
                "allOf": [
                    {
                        "$ref": "#/components/schemas/CardLimitUpdateRequest"
                    },
                    {
                        "properties": {
                            "mcc_list": {
                                "description": "Replaces the merchant category codes of an MCC_BLACKLIST or MCC_WHITELIST limit. Must not be empty for these types.",
                                "type": "array",
                                "items": {
                                    "type": "string"
                                },
                                "example": [
                                    "5812",
                                    "5814"
                                ]
                            }
                        },
                        "type": "object"
                    }
                ]
            },
            "Address": {
                "title": "Address",
                "description": "Address",
                "properties": {
                    "id": {
                        "title": "Address identifier in uuid format",
                        "description": "id",
                        "type": "string",
                        "format": "string",
                        "example": "d415805e-028a-4578-9012-f0844346b230"
                    },
                    "city": {
                        "title": "City name",
                        "description": "city",
                        "type": "string",
                        "format": "string",
                        "example": "Lublin"
                    },
                    "number": {
                        "title": "Number",
                        "description": "Number",
                        "type": "string",
                        "format": "string",
                        "example": "17a"
                    },
                    "apartment": {
                        "title": "Apartment",
                        "description": "Apartment",
                        "type": "string",
                        "format": "string",
                        "example": "44"
                    },
                    "postCode": {
                        "title": "Post Code",
                        "description": "Post code",
                        "type": "string",
                        "format": "string",
                        "example": "20-103"
                    },
                    "country": {
                        "title": "Country code in format: Alpha-2 code ISO-3166-1",
                        "description": "Country code",
                        "type": "string",
                        "format": "string",
                        "example": "PL"
                    }
                },
                "type": "object"
            },
            "Customer": {
                "title": "CustomerResource",
                "description": "Customer",
                "properties": {
                    "id": {
                        "title": "DataCore user identifier",
                        "description": "id",
                        "type": "integer",
                        "format": "integer",
                        "example": "1124"
                    },
                    "firstName": {
                        "title": "firstName",
                        "description": "firstName",
                        "type": "string",
                        "format": "string",
                        "example": "John"
                    },
                    "lastName": {
                        "title": "lastName",
                        "description": "lastName",
                        "type": "string",
                        "format": "string",
                        "example": "Doe"
                    },
                    "birthDate": {
                        "title": "BirthDate",
                        "description": "BirthDate",
                        "type": "string",
                        "format": "string",
                        "example": "1970-01-01"
                    }
                },
                "type": "object"
            },
            "Document": {
                "title": "Document",
                "description": "DocumentEntity",
                "properties": {
                    "id": {
                        "title": "id",
                        "description": "id",
                        "type": "string",
                        "format": "string",
                        "example": "c331758b-9f7c-4808-81e6-72f342fc0c79"
                    },
                    "type": {
                        "title": "type of document",
                        "description": "type",
                        "type": "string",
                        "format": "string",
                        "example": "passport"
                    },
                    "path": {
                        "title": "file path",
                        "description": "path",
                        "type": "string",
                        "format": "string",
                        "example": "documents/3796/5a5b253b-ac14-4566-a89f-8c5d26544c4e/IEoETVaFOF1Qx4AuKN8YBBUB8Y9lOanAU2Izato3.jpeg"
                    }
                },
                "type": "object"
            },
            "PaginatorLinks": {
                "title": "PaginatorLinks",
                "description": "Paginator Links",
                "properties": {
                    "first": {
                        "title": "first",
                        "description": "first",
                        "type": "string",
                        "format": "string",
                        "example": "<app_url>/<route>?page=1"
                    },
                    "last": {
                        "title": "last",
                        "description": "last",
                        "type": "string",
                        "format": "string",
                        "example": "<app_url>/<route>?page=4"
                    },
                    "prev": {
                        "title": "prev",
                        "description": "prev",
                        "type": "string",
                        "format": "string",
                        "example": "null"
                    },
                    "next": {
                        "title": "next",
                        "description": "next",
                        "type": "string",
                        "format": "string",
                        "example": "<app_url>/<route>?page=2"
                    }
                },
                "type": "object"
            },
            "PaginatorMeta": {
                "title": "PaginatorLinks",
                "description": "Paginator Links",
                "properties": {
                    "currentPage": {
                        "title": "current_page",
                        "description": "current_page",
                        "type": "integer",
                        "format": "int",
                        "example": "1"
                    },
                    "from": {
                        "title": "from",
                        "description": "from",
                        "type": "integer",
                        "format": "int",
                        "example": "4"
                    },
                    "last_page": {
                        "title": "last_page",
                        "description": "last_page",
                        "type": "integer",
                        "format": "int",
                        "example": "4"
                    },
                    "path": {
                        "title": "path",
                        "description": "path",
                        "type": "string",
                        "format": "string",
                        "example": "<app_url>/<route>"
                    },
                    "per_page": {
                        "title": "per_page",
                        "description": "per_page",
                        "type": "integer",
                        "format": "int",
                        "example": "20"
                    },
                    "to": {
                        "title": "to",
                        "description": "to",
                        "type": "integer",
                        "format": "int",
                        "example": "4"
                    },
                    "total": {
                        "title": "total",
                        "description": "total",
                        "type": "integer",
                        "format": "int",
                        "example": "4"
                    }
                },
                "type": "object"
            },
            "Report": {
                "description": "Billing report",
                "properties": {
                    "customerId": {
                        "description": "DataCore user id",
                        "type": "integer",
                        "example": 1337
                    },
                    "balanceId": {
                        "description": "Id of balance",
                        "type": "string",
                        "format": "uuid",
                        "example": "3dc88ad5-7053-454b-bcb8-e067c436f17d"
                    },
                    "rangeFrom": {
                        "description": "Beginning date of report",
                        "type": "string",
                        "format": "date-time",
                        "example": "2023-01-01 00:00:00"
                    },
                    "rangeTo": {
                        "description": "End date of report",
                        "type": "string",
                        "format": "date-time",
                        "example": "2023-01-31 23:59:59"
                    },
                    "type": {
                        "description": "Report type",
                        "type": "string",
                        "example": "customer_monthly_settlement"
                    },
                    "reportLink": {
                        "description": "Link to report file",
                        "type": "string",
                        "example": "https://s3.verestro.dev/asdf"
                    }
                },
                "type": "object"
            },
            "AdminCardOrderDetailsResponse": {
                "properties": {
                    "id": {
                        "description": "Order UUID",
                        "type": "string",
                        "format": "uuid",
                        "example": "39927556-7848-4dff-a0d2-24c23915bfa9"
                    },
                    "dcCardId": {
                        "description": "DataCore card ID",
                        "type": "integer",
                        "example": 45554,
                        "nullable": true
                    },
                    "dcUserId": {
                        "description": "DataCore user ID",
                        "type": "integer",
                        "example": 305,
                        "nullable": true
                    },
                    "firstName": {
                        "description": "Cardholder first name",
                        "type": "string",
                        "example": "John",
                        "nullable": true
                    },
                    "lastName": {
                        "description": "Cardholder last name",
                        "type": "string",
                        "example": "Doe",
                        "nullable": true
                    },
                    "country": {
                        "description": "Delivery country code",
                        "type": "string",
                        "example": "PL"
                    },
                    "city": {
                        "description": "Delivery city",
                        "type": "string",
                        "example": "Warsaw"
                    },
                    "street": {
                        "description": "Delivery street",
                        "type": "string",
                        "example": "Main St"
                    },
                    "number": {
                        "description": "Delivery building number",
                        "type": "string",
                        "example": "1A"
                    },
                    "postCode": {
                        "description": "Delivery post code",
                        "type": "string",
                        "example": "00-001"
                    },
                    "balanceId": {
                        "description": "Associated balance ID",
                        "type": "string",
                        "example": "a1b2c3d4-..."
                    },
                    "configId": {
                        "description": "Card config ID",
                        "type": "string",
                        "example": "fakeTerminal"
                    },
                    "cardId": {
                        "description": "Issued card UUID",
                        "type": "string",
                        "format": "uuid",
                        "example": "550e8400-...",
                        "nullable": true
                    },
                    "visualId": {
                        "description": "Visual design ID",
                        "type": "integer",
                        "example": 3,
                        "nullable": true
                    },
                    "deliveryType": {
                        "description": "Delivery type",
                        "type": "string",
                        "example": "S",
                        "nullable": true
                    },
                    "phone": {
                        "description": "Cardholder phone number",
                        "type": "string",
                        "example": "+48123456789",
                        "nullable": true
                    },
                    "dcCorporationId": {
                        "description": "Corporation UUID",
                        "type": "string",
                        "format": "uuid",
                        "example": "7c9e6679-...",
                        "nullable": true
                    },
                    "deliveryStatus": {
                        "description": "Delivery status",
                        "type": "string",
                        "enum": [
                            "IN_TRANSIT",
                            "DELIVERED",
                            "READY_TO_PICKUP"
                        ],
                        "nullable": true
                    },
                    "createdAt": {
                        "description": "Creation date",
                        "type": "string",
                        "example": "2023-01-01 12:00",
                        "nullable": true
                    }
                },
                "type": "object"
            },
            "AdminCardOrderItem": {
                "properties": {
                    "id": {
                        "description": "Order UUID",
                        "type": "string",
                        "format": "uuid",
                        "example": "39927556-7848-4dff-a0d2-24c23915bfa9"
                    },
                    "dcCardId": {
                        "description": "DataCore card ID",
                        "type": "integer",
                        "example": 45554,
                        "nullable": true
                    },
                    "dcUserId": {
                        "description": "DataCore user ID",
                        "type": "integer",
                        "example": 305,
                        "nullable": true
                    },
                    "firstName": {
                        "description": "Cardholder first name",
                        "type": "string",
                        "example": "John",
                        "nullable": true
                    },
                    "lastName": {
                        "description": "Cardholder last name",
                        "type": "string",
                        "example": "Doe",
                        "nullable": true
                    },
                    "city": {
                        "description": "Delivery city",
                        "type": "string",
                        "example": "Warsaw"
                    }
                },
                "type": "object"
            },
            "PaginationData": {
                "properties": {
                    "current_page": {
                        "description": "Current page number",
                        "type": "integer",
                        "example": 1
                    },
                    "total_elements": {
                        "description": "Total number of elements",
                        "type": "integer",
                        "example": 100
                    },
                    "total_pages": {
                        "description": "Total number of pages",
                        "type": "integer",
                        "example": 5
                    },
                    "per_page": {
                        "description": "Elements per page",
                        "type": "integer",
                        "example": 20
                    }
                },
                "type": "object"
            },
            "ResourceNotFound": {
                "properties": {
                    "status": {
                        "type": "string",
                        "example": "RESOURCE_NOT_FOUND"
                    }
                },
                "type": "object"
            },
            "CustomerNotFound": {
                "properties": {
                    "status": {
                        "type": "string",
                        "example": "CANT_FIND_CUSTOMER"
                    }
                },
                "type": "object"
            }
        },
        "responses": {
            "422": {
                "description": "Request validation failed",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/ErrorResponse"
                        },
                        "examples": {
                            "InvalidType": {
                                "summary": "INVALID_TYPE",
                                "value": {
                                    "status": "INVALID_TYPE"
                                }
                            },
                            "InvalidCurrency": {
                                "summary": "INVALID_CURRENCY",
                                "value": {
                                    "status": "INVALID_CURRENCY"
                                }
                            },
                            "InvalidDcUser": {
                                "summary": "INVALID_DC_USER_ID",
                                "value": {
                                    "status": "INVALID_DC_USER_ID"
                                }
                            },
                            "InvalidDcCorporationId": {
                                "summary": "INVALID_DC_CORPORATION_ID",
                                "value": {
                                    "status": "INVALID_DC_CORPORATION_ID"
                                }
                            },
                            "CorporationAccessDenied": {
                                "summary": "CORPORATION_ACCESS_DENIED",
                                "value": {
                                    "status": "CORPORATION_ACCESS_DENIED"
                                }
                            }
                        }
                    }
                }
            }
        },
        "examples": {
            "InvalidLockTypeException": {
                "summary": "RESOURCE_NOT_FOUND",
                "value": {
                    "status": "INVALID_LOCK_TYPE"
                }
            },
            "NoActiveDocumentException": {
                "summary": "NO_ACTIVE_DOCUMENTS",
                "value": {
                    "status": "NO_ACTIVE_DOCUMENTS"
                }
            },
            "ResourceNotFound": {
                "summary": "RESOURCE_NOT_FOUND",
                "value": {
                    "status": "RESOURCE_NOT_FOUND"
                }
            },
            "CustomerNotFound": {
                "summary": "CUSTOMER_NOT_FOUND",
                "value": {
                    "status": "CUSTOMER_NOT_FOUND"
                }
            },
            "CorporationNotFound": {
                "summary": "CORPORATION_NOT_FOUND",
                "value": {
                    "status": "CORPORATION_NOT_FOUND"
                }
            },
            "CustomerBalanceNotFound": {
                "summary": "CUSTOMER_BALANCE_NOT_FOUND",
                "value": {
                    "status": "CUSTOMER_BALANCE_NOT_FOUND"
                }
            },
            "CorporationBalanceNotFound": {
                "summary": "CORPORATION_BALANCE_NOT_FOUND",
                "value": {
                    "status": "CORPORATION_BALANCE_NOT_FOUND"
                }
            },
            "CardNotFound": {
                "summary": "CARD_NOT_FOUND",
                "value": {
                    "status": "CARD_NOT_FOUND"
                }
            },
            "CardInvalid": {
                "summary": "INVALID_CARD",
                "value": {
                    "status": "INVALID_CARD"
                }
            },
            "CardLimitNotFound": {
                "summary": "CARD_LIMIT_NOT_FOUND",
                "value": {
                    "status": "CARD_LIMIT_NOT_FOUND"
                }
            },
            "BalanceLimitNotFound": {
                "summary": "BALANCE_LIMIT_NOT_FOUND",
                "value": {
                    "status": "BALANCE_LIMIT_NOT_FOUND"
                }
            },
            "CardBudgetNotFound": {
                "summary": "CARD_BUDGET_NOT_FOUND",
                "value": {
                    "status": "CARD_BUDGET_NOT_FOUND"
                }
            },
            "InvalidConfiguration": {
                "summary": "CANNOT_MATCH_CONFIGURATION",
                "value": {
                    "status": "CANNOT_MATCH_CONFIGURATION"
                }
            },
            "WpinNotFound": {
                "summary": "CANT_FIND_WPIN",
                "value": {
                    "status": "CANT_FIND_WPIN"
                }
            },
            "VerificationNotFound": {
                "summary": "VERIFICATION_NOT_FOUND",
                "value": {
                    "status": "VERIFICATION_NOT_FOUND"
                }
            },
            "VerificationDocumentNotExist": {
                "summary": "VERIFICATION_DOCUMENT_NOT_EXIST",
                "value": {
                    "status": "VERIFICATION_DOCUMENT_NOT_EXIST"
                }
            },
            "verificationDocumentAlreadyAttachedToOtherVerification": {
                "summary": "VERIFICATION_DOCUMENT_ALREADY_ATTACHED_TO_OTHER_VERIFICATION",
                "value": {
                    "status": "VERIFICATION_DOCUMENT_ALREADY_ATTACHED_TO_OTHER_VERIFICATION"
                }
            },
            "BalanceSummaryNotFound": {
                "summary": "CANT_FIND_BALANCE_SUMMARY",
                "value": {
                    "status": "CANT_FIND_BALANCE_SUMMARY"
                }
            },
            "OperationNotFound": {
                "summary": "OPERATION_NOT_FOUND",
                "value": {
                    "status": "OPERATION_NOT_FOUND"
                }
            },
            "CantCreateLinkedCard": {
                "summary": "CANT_CREATE_LINKED_CARD",
                "value": {
                    "status": "CANT_CREATE_LINKED_CARD"
                }
            },
            "InvalidCard": {
                "summary": "INVALID_CARD",
                "value": {
                    "status": "INVALID_CARD"
                }
            },
            "ChangePinFailure": {
                "summary": "CANT_CHANGE_PIN",
                "value": {
                    "status": "CANT_CHANGE_PIN"
                }
            },
            "LockCardFailure": {
                "summary": "CANT_LOCK_CARD",
                "value": {
                    "status": "CANT_LOCK_CARD"
                }
            },
            "UnlockCardFailure": {
                "summary": "CANT_UNLOCK_CARD",
                "value": {
                    "status": "CANT_UNLOCK_CARD"
                }
            },
            "LinkCardFailure": {
                "summary": "CANT_LINK_CARD",
                "value": {
                    "status": "CANT_LINK_CARD"
                }
            },
            "ActivateCardFailure": {
                "summary": "CANT_ACTIVATE_CARD",
                "value": {
                    "status": "CANT_ACTIVATE_CARD"
                }
            },
            "UpdateCvvFailure": {
                "summary": "CANT_UPDATE_CVV",
                "value": {
                    "status": "CANT_UPDATE_CVV"
                }
            },
            "DeleteSourceCardFailure": {
                "summary": "CANT_DELETE_SOURCE_CARD",
                "value": {
                    "status": "CANT_DELETE_SOURCE_CARD"
                }
            },
            "StoreCardFailure": {
                "summary": "CANT_STORE_CARD",
                "value": {
                    "status": "CANT_STORE_CARD"
                }
            },
            "CantAcceptVerification": {
                "summary": "CANT_ACCEPT_VERIFICATION",
                "value": {
                    "status": "CANT_ACCEPT_VERIFICATION"
                }
            },
            "CantUpdateBudget": {
                "summary": "CANT_UPDATE_BUDGET",
                "value": {
                    "status": "CANT_UPDATE_BUDGET"
                }
            },
            "CustomerBalanceNotCleared": {
                "summary": "CUSTOMER_BALANCE_NOT_CLEARED",
                "value": {
                    "status": "CUSTOMER_BALANCE_NOT_CLEARED"
                }
            },
            "CustomerAccountingBalanceNotCleared": {
                "summary": "CUSTOMER_ACCOUNTING_BALANCE_NOT_CLEARED",
                "value": {
                    "status": "CUSTOMER_ACCOUNTING_BALANCE_NOT_CLEARED"
                }
            },
            "LastCustomerBalanceLeft": {
                "summary": "CANT_DELETE_LAST_CUSTOMER_BALANCE",
                "value": {
                    "status": "CANT_DELETE_LAST_CUSTOMER_BALANCE"
                }
            },
            "InvalidCurrency": {
                "summary": "INVALID_CURRENCY",
                "value": {
                    "status": "INVALID_CURRENCY"
                }
            },
            "InvalidBalance": {
                "summary": "INVALID_BALANCE",
                "value": {
                    "status": "INVALID_BALANCE"
                }
            },
            "BalanceDisabled": {
                "summary": "BALANCE_DISABLED",
                "value": {
                    "status": "BALANCE_DISABLED"
                }
            },
            "InvalidAmount": {
                "summary": "INVALID_AMOUNT",
                "value": {
                    "status": "INVALID_AMOUNT"
                }
            },
            "InvalidCdd": {
                "summary": "INVALID_CDD",
                "value": {
                    "status": "INVALID_CDD",
                    "details": "List name cannot be empty."
                }
            },
            "CantDeleteCustomer": {
                "summary": "CANT_DELETE_CUSTOMER",
                "value": {
                    "status": "CANT_DELETE_CUSTOMER"
                }
            },
            "CantActivateCard": {
                "summary": "MAC_ALREADY_ACTIVATED",
                "value": {
                    "status": "MAC_ALREADY_ACTIVATED"
                }
            },
            "CantDecryptPayload": {
                "summary": "CANT_DECRYPT_PAYLOAD",
                "value": {
                    "status": "CANT_DECRYPT_PAYLOAD"
                }
            },
            "CustomerAlreadyRegistered": {
                "summary": "CUSTOMER_ALREADY_REGISTERED",
                "value": {
                    "status": "CUSTOMER_ALREADY_REGISTERED"
                }
            },
            "HasPendingVerifications": {
                "summary": "CUSTOMER_VERIFICATION_IN_PROGRESS",
                "value": {
                    "status": "CUSTOMER_VERIFICATION_IN_PROGRESS"
                }
            },
            "PermanentlyLocked": {
                "summary": "CUSTOMER_PERMANENTLY_LOCKED",
                "value": {
                    "status": "CUSTOMER_PERMANENTLY_LOCKED"
                }
            },
            "InvalidCountryCode": {
                "summary": "INVALID_COUNTRY_CODE",
                "value": {
                    "status": "INVALID_COUNTRY_CODE"
                }
            },
            "BudgetAlreadyExists": {
                "summary": "BUDGET_ALREADY_EXISTS",
                "value": {
                    "status": "BUDGET_ALREADY_EXISTS"
                }
            },
            "InsufficientFunds": {
                "summary": "INSUFFICIENT_FUNDS",
                "value": {
                    "status": "INSUFFICIENT_FUNDS"
                }
            },
            "MasterBalanceNotFound": {
                "summary": "MASTER_BALANCE_NOT_FOUND",
                "value": {
                    "status": "MASTER_BALANCE_NOT_FOUND"
                }
            },
            "CurrencyDifferenceError": {
                "summary": "CURRENCY_DIFFERENCE_ERROR",
                "value": {
                    "status": "CURRENCY_DIFFERENCE_ERROR"
                }
            },
            "TransactionAmountExceeded": {
                "summary": "TRANSACTION_AMOUNT_EXCEEDED",
                "value": {
                    "status": "TRANSACTION_AMOUNT_EXCEEDED"
                }
            },
            "TransactionIdConflict": {
                "summary": "TRANSACTION_ID_CONFLICT",
                "value": {
                    "status": "TRANSACTION_ID_CONFLICT"
                }
            },
            "TransactionAlreadyCleared": {
                "summary": "TRANSACTION_ALREADY_CLEARED",
                "value": {
                    "status": "TRANSACTION_ALREADY_CLEARED"
                }
            },
            "TransactionAlreadyReversed": {
                "summary": "TRANSACTION_ALREADY_REVERSED",
                "value": {
                    "status": "TRANSACTION_ALREADY_REVERSED"
                }
            },
            "FraudSuspected": {
                "summary": "FRAUD_SUSPECTED",
                "value": {
                    "status": "FRAUD_SUSPECTED"
                }
            },
            "CardIssuerError": {
                "summary": "CARD_ISSUER_ERROR",
                "value": {
                    "status": "CARD_ISSUER_ERROR"
                }
            },
            "EncryptionRequired": {
                "summary": "ENCRYPTION_REQUIRED",
                "value": {
                    "status": "ENCRYPTION_REQUIRED"
                }
            },
            "InvalidHeaderValue": {
                "summary": "INVALID_HEADER_VALUE",
                "value": {
                    "status": "INVALID_HEADER_VALUE"
                }
            },
            "InvalidPublicKey": {
                "summary": "INVALID_PUBLIC_KEY",
                "value": {
                    "status": "INVALID_PUBLIC_KEY"
                }
            },
            "InvalidParameter": {
                "summary": "INVALID_PARAMETER",
                "value": {
                    "status": "INVALID_PARAMETER",
                    "0": "description"
                }
            },
            "InvalidPayload": {
                "summary": "INVALID_PAYLOAD",
                "value": {
                    "status": "INVALID_PAYLOAD"
                }
            },
            "CustomerLocked": {
                "summary": "CUSTOMER_LOCKED",
                "value": {
                    "status": "CUSTOMER_LOCKED"
                }
            },
            "CardExpired": {
                "summary": "CARD_EXPIRED",
                "value": {
                    "status": "CARD_EXPIRED"
                }
            },
            "CardLocked": {
                "summary": "CARD_LOCKED",
                "value": {
                    "status": "CARD_LOCKED"
                }
            },
            "AlreadyExists": {
                "summary": "ALREADY_EXISTS",
                "value": {
                    "status": "ALREADY_EXISTS"
                }
            },
            "InvalidTransactionType": {
                "summary": "INVALID_TRANSACTION_TYPE",
                "value": {
                    "status": "INVALID_TRANSACTION_TYPE"
                }
            },
            "InvalidTransactionStatus": {
                "summary": "INVALID_TRANSACTION_STATUS",
                "value": {
                    "status": "INVALID_TRANSACTION_STATUS"
                }
            },
            "InvalidDescription": {
                "summary": "INVALID_DESCRIPTION",
                "value": {
                    "status": "INVALID_DESCRIPTION"
                }
            },
            "InvalidResource": {
                "summary": "INVALID_RESOURCE",
                "value": {
                    "status": "INVALID_RESOURCE"
                }
            },
            "TransactionNotFound": {
                "summary": "TRANSACTION_NOT_FOUND",
                "value": {
                    "status": "TRANSACTION_NOT_FOUND"
                }
            },
            "InvalidTransactionReference": {
                "summary": "INVALID_TRANSACTION_REFERENCE",
                "value": {
                    "status": "INVALID_TRANSACTION_REFERENCE"
                }
            },
            "SettlementNotFound": {
                "summary": "SETTLEMENT_NOT_FOUND",
                "value": {
                    "status": "SETTLEMENT_NOT_FOUND"
                }
            },
            "InvalidStatus": {
                "summary": "INVALID_STATUS",
                "value": {
                    "status": "INVALID_STATUS"
                }
            },
            "InvalidSettlementId": {
                "summary": "INVALID_SETTLEMENT_ID",
                "value": {
                    "status": "INVALID_SETTLEMENT_ID"
                }
            },
            "InvalidTransactionId": {
                "summary": "INVALID_TRANSACTION_ID",
                "value": {
                    "status": "INVALID_TRANSACTION_ID"
                }
            },
            "InvalidExternalTransactionId": {
                "summary": "INVALID_EXTERNAL_TRANSACTION_ID",
                "value": {
                    "status": "INVALID_EXTERNAL_TRANSACTION_ID"
                }
            },
            "InvalidLimitParameters": {
                "summary": "INVALID_LIMIT_PARAMETERS",
                "value": {
                    "status": "INVALID_LIMIT_PARAMETERS"
                }
            },
            "InvalidMaxAmount": {
                "summary": "INVALID_MAX_AMOUNT",
                "value": {
                    "status": "INVALID_MAX_AMOUNT"
                }
            },
            "InvalidMaxAttempts": {
                "summary": "INVALID_MAX_ATTEMPTS",
                "value": {
                    "status": "INVALID_MAX_ATTEMPTS"
                }
            },
            "InvalidMccList": {
                "summary": "INVALID_MCC_LIST",
                "value": {
                    "status": "INVALID_MCC_LIST"
                }
            },
            "CurrencyWithTypeMismatch": {
                "summary": "CURRENCY_WITH_TYPE_MISMATCH",
                "value": {
                    "status": "CURRENCY_WITH_TYPE_MISMATCH"
                }
            },
            "InvalidResourceType": {
                "summary": "INVALID_RESOURCE_TYPE",
                "value": {
                    "status": "INVALID_RESOURCE_TYPE"
                }
            },
            "InvalidResourceId": {
                "summary": "INVALID_RESOURCE_ID",
                "value": {
                    "status": "INVALID_RESOURCE_ID"
                }
            },
            "InvalidSenderResourceId": {
                "summary": "INVALID_SENDER_RESOURCE",
                "value": {
                    "status": "INVALID_SENDER_RESOURCE"
                }
            },
            "InvalidReceiverResourceId": {
                "summary": "INVALID_RECEIVER_RESOURCE",
                "value": {
                    "status": "INVALID_RECEIVER_RESOURCE"
                }
            },
            "InvalidReason": {
                "summary": "INVALID_REASON",
                "value": {
                    "status": "INVALID_REASON"
                }
            },
            "CardLimitError": {
                "summary": "CARD_LIMIT_ERROR",
                "value": {
                    "status": "CARD_LIMIT_ERROR"
                }
            },
            "CardLimitExceeded": {
                "summary": "CARD_LIMIT_EXCEEDED",
                "value": {
                    "status": "CARD_LIMIT_EXCEEDED"
                }
            },
            "DepositBalanceNotFound": {
                "summary": "DEPOSIT_BALANCE_NOT_FOUND",
                "value": {
                    "status": "DEPOSIT_BALANCE_NOT_FOUND"
                }
            },
            "InsufficientFundsOnDeposit": {
                "summary": "INSUFFICIENT_FUNDS_ON_DEPOSIT_BALANCE",
                "value": {
                    "status": "INSUFFICIENT_FUNDS_ON_DEPOSIT_BALANCE"
                }
            },
            "AmlException": {
                "summary": "AML_EXCEPTION",
                "value": {
                    "status": "AML_EXCEPTION"
                }
            },
            "InternalServerError": {
                "summary": "INTERNAL_SERVER_ERROR",
                "value": {
                    "status": "INTERNAL_SERVER_ERROR"
                }
            },
            "BadGateway": {
                "summary": "BAD_GATEWAY",
                "value": {
                    "status": "BAD_GATEWAY"
                }
            },
            "VerificationAlreadyExist": {
                "summary": "VERIFICATION_ALREADY_EXIST",
                "value": {
                    "status": "VERIFICATION_ALREADY_EXIST"
                }
            },
            "KycNotVerified": {
                "summary": "KYC_NOT_VERIFIED",
                "value": {
                    "status": "KYC_NOT_VERIFIED"
                }
            },
            "MethodNotAllowed": {
                "summary": "METHOD_NOT_ALLOWED",
                "value": {
                    "status": "METHOD_NOT_ALLOWED"
                }
            },
            "NotFound": {
                "summary": "NOT_FOUND",
                "value": {
                    "status": "NOT_FOUND"
                }
            },
            "NotImplemented": {
                "summary": "NOT_IMPLEMENTED",
                "value": {
                    "status": "NOT_IMPLEMENTED"
                }
            },
            "ConfigIdRequired": {
                "summary": "CONFIG_ID_REQUIRED",
                "value": {
                    "status": "CONFIG_ID_REQUIRED"
                }
            },
            "InvalidBalanceId": {
                "summary": "INVALID_BALANCE_ID",
                "value": {
                    "status": "INVALID_BALANCE_ID"
                }
            },
            "BalanceIdRequired": {
                "summary": "BALANCE_ID_REQUIRED",
                "value": {
                    "status": "BALANCE_ID_REQUIRED"
                }
            },
            "BalanceNotFound": {
                "summary": "BALANCE_NOT_FOUND",
                "value": {
                    "status": "BALANCE_NOT_FOUND"
                }
            },
            "InvalidCustomerId": {
                "summary": "INVALID_CUSTOMER_ID",
                "value": {
                    "status": "INVALID_CUSTOMER_ID"
                }
            },
            "InvalidRangeFrom": {
                "summary": "INVALID_RANGE_FROM",
                "value": {
                    "status": "INVALID_RANGE_FROM"
                }
            },
            "InvalidRangeTo": {
                "summary": "INVALID_RANGE_TO",
                "value": {
                    "status": "INVALID_RANGE_TO"
                }
            },
            "FieldIsRequired": {
                "summary": "FIELD_IS_REQUIRED",
                "value": {
                    "status": "FIELD_IS_REQUIRED"
                }
            },
            "DateIsInvalid": {
                "summary": "DATE_IS_INVALID",
                "value": {
                    "status": "DATE_IS_INVALID"
                }
            },
            "DateFormatIsInvalid": {
                "summary": "DATE_FORMAT_IS_INVALID",
                "value": {
                    "status": "DATE_FORMAT_IS_INVALID"
                }
            },
            "InvalidBalanceOwner": {
                "summary": "INVALID_BALANCE_OWNER",
                "value": {
                    "status": "INVALID_BALANCE_OWNER"
                }
            },
            "InvalidContrahentData": {
                "summary": "INVALID_CONTRAHENT_DATA",
                "value": {
                    "status": "INVALID_CONTRAHENT_DATA"
                }
            },
            "InvalidId": {
                "summary": "INVALID_ID_FORMAT",
                "value": {
                    "status": "INVALID_ID_FORMAT"
                }
            },
            "create error": {
                "summary": "CANNOT_CREATE",
                "value": {
                    "status": "CANNOT_CREATE"
                }
            },
            "invalid limit currency": {
                "summary": "INVALID_LIMIT_CURRENCY",
                "value": {
                    "status": "INVALID_LIMIT_CURRENCY"
                }
            },
            "limit already exists": {
                "summary": "LIMIT_ALREADY_EXISTS",
                "value": {
                    "status": "LIMIT_ALREADY_EXISTS"
                }
            },
            "BalanceLimitFieldIsRequired": {
                "summary": "FIELD_IS_REQUIRED",
                "value": {
                    "status": "FIELD_IS_REQUIRED",
                    "errors": {
                        "maxAmount": [
                            "FIELD_IS_REQUIRED"
                        ]
                    }
                }
            },
            "BalanceLimitInvalidType": {
                "summary": "INVALID_TYPE",
                "value": {
                    "status": "INVALID_TYPE",
                    "errors": {
                        "type": [
                            "INVALID_TYPE"
                        ]
                    }
                }
            },
            "BalanceLimitInvalidPeriod": {
                "summary": "INVALID_PERIOD",
                "value": {
                    "status": "INVALID_PERIOD",
                    "errors": {
                        "period": [
                            "INVALID_PERIOD"
                        ]
                    }
                }
            },
            "BalanceLimitValueMustBeInteger": {
                "summary": "VALUE_MUST_BE_INTEGER_TYPE",
                "value": {
                    "status": "VALUE_MUST_BE_INTEGER_TYPE",
                    "errors": {
                        "maxAmount": [
                            "VALUE_MUST_BE_INTEGER_TYPE"
                        ]
                    }
                }
            },
            "BalanceLimitMaxAmountCannotBeNegative": {
                "summary": "MAX_AMOUNT_CANNOT_BE_NEGATIVE",
                "value": {
                    "status": "MAX_AMOUNT_CANNOT_BE_NEGATIVE",
                    "errors": {
                        "maxAmount": [
                            "MAX_AMOUNT_CANNOT_BE_NEGATIVE"
                        ]
                    }
                }
            },
            "BalanceLimitDateIsInvalid": {
                "summary": "DATE_IS_INVALID",
                "value": {
                    "status": "DATE_IS_INVALID",
                    "errors": {
                        "expiration": [
                            "DATE_IS_INVALID"
                        ]
                    }
                }
            },
            "BalanceLimitCannotCreate": {
                "summary": "CANNOT_CREATE",
                "value": {
                    "status": "CANNOT_CREATE"
                }
            },
            "BalanceLimitAlreadyExists": {
                "summary": "LIMIT_ALREADY_EXISTS",
                "value": {
                    "status": "LIMIT_ALREADY_EXISTS"
                }
            },
            "CardLimitCreateTrxAll": {
                "summary": "TRX_ALL - max 10 transactions for 50.00 per month",
                "value": {
                    "type": "TRX_ALL",
                    "maxAmount": 5000,
                    "maxAttempts": 10,
                    "period": "MONTHLY"
                }
            },
            "CardLimitCreateEcom": {
                "summary": "TRX_E_COM - max 5 e-commerce transactions for 10.00 per day",
                "value": {
                    "type": "TRX_E_COM",
                    "maxAmount": 1000,
                    "maxAttempts": 5,
                    "period": "DAILY"
                }
            },
            "CardLimitCreateAtm": {
                "summary": "TRX_ATM - max 2 ATM withdrawals for 300.00 per week",
                "value": {
                    "type": "TRX_ATM",
                    "maxAmount": 30000,
                    "maxAttempts": 2,
                    "period": "WEEKLY"
                }
            },
            "CardLimitCreatePos": {
                "summary": "POS - max 1000.00 in card-present transactions per day",
                "value": {
                    "type": "POS",
                    "maxAmount": 100000,
                    "period": "DAILY"
                }
            },
            "CardLimitCreateForeignAmount": {
                "summary": "FOREIGN_AMOUNT - max 200.00 in foreign currency transactions per month",
                "value": {
                    "type": "FOREIGN_AMOUNT",
                    "maxAmount": 20000,
                    "period": "MONTHLY"
                }
            },
            "CardLimitCreateForeignQuantity": {
                "summary": "FOREIGN_QUANTITY - max 3 foreign currency transactions per day",
                "value": {
                    "type": "FOREIGN_QUANTITY",
                    "maxAttempts": 3,
                    "period": "DAILY"
                }
            },
            "CardLimitCreateQuantity": {
                "summary": "QUANTITY - max 100 transactions per day",
                "value": {
                    "type": "QUANTITY",
                    "maxAttempts": 100,
                    "period": "DAILY"
                }
            },
            "CardLimitCreateAmountPln": {
                "summary": "AMOUNT_PLN - max 500.00 PLN per week (PLN card only)",
                "value": {
                    "type": "AMOUNT_PLN",
                    "maxAmount": 50000,
                    "period": "WEEKLY"
                }
            },
            "CardLimitCreateAmountEur": {
                "summary": "AMOUNT_EUR - max 200.00 EUR per month (EUR card only)",
                "value": {
                    "type": "AMOUNT_EUR",
                    "maxAmount": 20000,
                    "period": "MONTHLY"
                }
            },
            "CardLimitCreateMccBlacklist": {
                "summary": "MCC_BLACKLIST - decline transactions in restaurants",
                "value": {
                    "type": "MCC_BLACKLIST",
                    "mcc_list": [
                        "5812"
                    ]
                }
            },
            "CardLimitCreateMccWhitelist": {
                "summary": "MCC_WHITELIST - allow transactions only in restaurants",
                "value": {
                    "type": "MCC_WHITELIST",
                    "mcc_list": [
                        "5812"
                    ]
                }
            },
            "CardLimitCreateMerchantIdBlacklist": {
                "summary": "MERCHANT_ID_BLACKLIST - decline transactions at given merchants",
                "value": {
                    "type": "MERCHANT_ID_BLACKLIST",
                    "merchant_id_list": [
                        "9AF3C2B1D4E5"
                    ]
                }
            },
            "CardLimitCreateMerchantIdWhitelist": {
                "summary": "MERCHANT_ID_WHITELIST - allow transactions only at given merchants",
                "value": {
                    "type": "MERCHANT_ID_WHITELIST",
                    "merchant_id_list": [
                        "9AF3C2B1D4E5"
                    ]
                }
            },
            "CardLimitInvalidType": {
                "summary": "INVALID_TYPE",
                "value": {
                    "status": "INVALID_TYPE",
                    "errors": {
                        "type": [
                            "INVALID_TYPE"
                        ]
                    }
                }
            },
            "CardLimitTypeNotAccessible": {
                "summary": "Limit type requires a role the user does not have",
                "value": {
                    "status": "The type of the limit is not accessed for this user",
                    "errors": {
                        "type": [
                            "The type of the limit is not accessed for this user"
                        ]
                    }
                }
            },
            "CardLimitInvalidPeriod": {
                "summary": "INVALID_PERIOD",
                "value": {
                    "status": "INVALID_PERIOD",
                    "errors": {
                        "period": [
                            "INVALID_PERIOD"
                        ]
                    }
                }
            },
            "CardLimitDateIsInvalid": {
                "summary": "DATE_IS_INVALID",
                "value": {
                    "status": "DATE_IS_INVALID",
                    "errors": {
                        "expiration": [
                            "DATE_IS_INVALID"
                        ]
                    }
                }
            },
            "CardLimitValueMustBeInteger": {
                "summary": "VALUE_MUST_BE_INTEGER_TYPE",
                "value": {
                    "status": "VALUE_MUST_BE_INTEGER_TYPE",
                    "errors": {
                        "maxAttempts": [
                            "VALUE_MUST_BE_INTEGER_TYPE"
                        ]
                    }
                }
            },
            "CardLimitOverTheLimit": {
                "summary": "OVER_THE_LIMIT",
                "value": {
                    "status": "OVER_THE_LIMIT",
                    "errors": {
                        "maxAmount": [
                            "OVER_THE_LIMIT"
                        ]
                    }
                }
            },
            "CardLimitValidationMultiFields": {
                "summary": "VALIDATION (status of the first failed field)",
                "value": {
                    "status": "INVALID_TYPE",
                    "errors": {
                        "type": [
                            "INVALID_TYPE"
                        ],
                        "period": [
                            "INVALID_PERIOD"
                        ],
                        "expiration": [
                            "DATE_IS_INVALID"
                        ]
                    }
                }
            }
        },
        "securitySchemes": {
            "bearerAuth": {
                "type": "http",
                "description": "Depending on methods you're calling two types of tokens are supported. Admin methods - JWT from admin panel. Customer methods - session token obtained from DataCore (eg. after pair device).",
                "name": "Authorization",
                "in": "header",
                "scheme": "bearer"
            }
        }
    },
    "tags": [
        {
            "name": "Admin - Balances",
            "description": "Admin - Balances"
        },
        {
            "name": "Admin - Balance Summary",
            "description": "Admin - Balance Summary"
        },
        {
            "name": "Admin - Customer Balance",
            "description": "Admin - Customer Balance"
        },
        {
            "name": "Admin - Master Balance",
            "description": "Admin - Master Balance"
        },
        {
            "name": "Admin - Billings",
            "description": "Admin - Billings"
        },
        {
            "name": "Admin - Cards",
            "description": "Admin - Cards"
        },
        {
            "name": "Admin - Customer Cards",
            "description": "Admin - Customer Cards"
        },
        {
            "name": "Admin - Transactions",
            "description": "Admin - Transactions"
        },
        {
            "name": "Admin - Corporations",
            "description": "Admin - Corporations"
        },
        {
            "name": "Admin - Customers Due Diligence",
            "description": "Admin - Customers Due Diligence"
        },
        {
            "name": "Admin - Customers",
            "description": "Admin - Customers"
        },
        {
            "name": "Admin - Verifications",
            "description": "Admin - Verifications"
        },
        {
            "name": "Admin - Locks",
            "description": "Admin - Locks"
        },
        {
            "name": "Admin - Transactions report",
            "description": "Admin - Transactions report"
        },
        {
            "name": "Admin - Allowed Actions",
            "description": "Admin - Allowed Actions"
        },
        {
            "name": "Public Key",
            "description": "Public Key"
        },
        {
            "name": "Async Operation",
            "description": "Async Operation"
        }
    ],
    "externalDocs": {
        "description": "JWE ENCRYPTION",
        "url": "https://developer.verestro.com/books/card-management-system/page/overview#bkmrk-step-1.-configuratio-0"
    },
    "security": [
        {
            "bearerAuth": []
        }
    ]
}