{ "openapi": "3.0.0", "info": { "title": "Antaca Api Customer Documentation", "description": "\n\nThis documentation describes the capabilities of ANTACA API related to\naccount maintenance and card issuing. \n\n\n\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\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| | |\n", "version": "1.0.0" }, "paths": { "/customers/me/balances": { "get": { "tags": [ "Customer Balance" ], "summary": "Get customer balances", "operationId": "getCustomerBalances", "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CustomerBalanceEntity" } } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomerNotFound" } } } } } }, "post": { "tags": [ "Customer Balance" ], "summary": "Create customer balance", "operationId": "createCustomerBalance", "requestBody": { "description": "Input data", "required": true, "content": { "application/json": { "schema": { "properties": { "currency": { "description": "Valid three letter ISO 4217 currency code.", "type": "string", "example": "PLN" }, "description": { "description": "Name of balance", "type": "string", "example": "My account", "nullable": "true" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomerBalanceBrief" } } } }, "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": { "InvalidCurrency": { "$ref": "#/components/examples/InvalidCurrency" } } } } } } } }, "/customers/me/balances/{balanceId}": { "get": { "tags": [ "Customer Balance" ], "summary": "Get customer balance", "operationId": "getCustomerBalance", "parameters": [ { "name": "balanceId", "in": "path", "description": "Id of balance", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomerBalanceEntity" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "CustomerBalanceNotFound": { "$ref": "#/components/examples/CustomerBalanceNotFound" }, "CustomerNotFound": { "$ref": "#/components/examples/CustomerNotFound" } } } } } } }, "delete": { "tags": [ "Customer Balance" ], "summary": "Delete customer balance", "operationId": "deleteCustomerBalance", "parameters": [ { "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" } } } } }, "409": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "CustomerBalanceNotCleared": { "$ref": "#/components/examples/CustomerBalanceNotCleared" }, "LastCustomerBalanceLeft": { "$ref": "#/components/examples/LastCustomerBalanceLeft" } } } } } } }, "patch": { "tags": [ "Customer Balance" ], "summary": "Update customer balance", "operationId": "updateCustomerBalance", "parameters": [ { "name": "balanceId", "in": "path", "description": "Id of balance", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "description": "Input data", "required": true, "content": { "application/json": { "schema": { "properties": { "description": { "description": "Name of balance", "type": "string", "example": "My account", "nullable": "true" } }, "type": "object" } } } }, "responses": { "204": { "description": "NoContent" }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "CustomerBalanceNotFound": { "$ref": "#/components/examples/CustomerBalanceNotFound" } } } } } } } }, "/customers/me/cards/{cardId}/limits": { "get": { "tags": [ "Customer Cards" ], "summary": "Get limits of given card", "description": "Allows to retrieve all limits for given card", "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/CardLimitCollection" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "CardNotFound": { "$ref": "#/components/examples/CardNotFound" } } } } } } }, "post": { "tags": [ "Customer Cards" ], "summary": "Add limits for card usage", "description": "Allows to add card usage limit. For all kinds of limit types, properties as 'maxAmount', 'maxLimit' or 'period' should be passed in the request to make the limit work properly.\n\nTRX_ALL - limit for every kind of transaction. With this value, at least one of parameters: 'maxAmount' or 'maxAttempts' should be passed in the request. \nFor example - I want to make no more than 10 transactions for a total amount of 5000 (minor value) per month:\n * type: TRX_ALL\n * maxAmount: 5000\n * maxAttempts: 10\n * period: monthly\nTRX_E_COM - limit for e-commerce transaction. All properties as maxAmount, maxAttempts will be checked only if it is e-commerce transaction. \nFor example - I want to make no more than 5 e-commerce transaction for a total amount of 1000 (minor value) per day:\n * type: TRX_E_COM\n * maxAmount: 1000\n * maxAttempts: 5\n * period: daily\nTRX_ATM - limit for atm transaction. All properties as maxAmount, maxAttempts will be checked only if it is atm transaction. \nFor example - I want to make no more than 2 ATM withdrawals for a total amount of 300 (minor value) per week:\n * type: TRX_ATM\n * maxAmount: 300\n * maxAttempts: 2\n * period: weekly\nFOREIGN_AMOUNT - limit for the value of transactions made in a different currency than the currency of a card. \nFor example - I want to spent no more than 200 in foreign amount per month:\n * type: FOREIGN_AMOUNT\n * maxAmount: 200\n * period: monthly\nFOREIGN_QUANTITY - limit for the quantity of transactions made in different currency than the currency of a card. With this value, property 'maxAttempts' should be passed in the request. \nFor example - I want to make no more than 3 transaction in foreign currency per day:\n * type: FOREIGN_QUANTITY\n * maxAttempts: 3\n * period: daily\nQUANTITY - limit for transaction quantity. With this value, property 'maxAttempts' should be passed. \nFor example - I want to make no more than 100 transaction per day:\n * type: QUANTITY\n * maxAttempts: 100\n * period: daily\nAMOUNT_PLN - limit for value of transaction made in PLN currency. With this value, property 'maxAmount' should be passed. \nFor example - I want to spent no more than 500 PLN (use the minor value in code) per week:\n * type: AMOUNT_PLN\n * maxAmount: 50000\n * period: weekly\nAMOUNT_EUR - limit for value of transaction made in EUR currency. With this value, property 'maxAmount' should be passed. \nFor example - I want to spent no more than 200 EUR (use the minor value in code) per month:\n * type: AMOUNT_EUR\n * maxAmount: 20000\n * period: monthly\nMCC_BLACKLIST - limit for transaction made in terminal with specific merchant category code. With this value, property 'mcc_list' should be passed.\nFor example - I would not like to spend money in restaurants with this card:\n * type: MCC_BLACKLIST\n * mcc_list: [5812]\nMCC_WHITELIST - limit for transaction made in terminal without specific merchant category code. With this value, property 'mcc_list' should be passed.\nFor example - I would like to spend money only in restaurants with this card:\n * type: MCC_WHITELIST\n * mcc_list: [5812]\n ", "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": { "type": { "description": "Type of card limitation", "type": "string", "enum": [ "TRX_ALL", "TRX_E_COM", "TRX_ATM", "FOREIGN_AMOUNT", "QUANTITY", "AMOUNT_PLN", "MCC_BLACKLIST", "MCC_WHITELIST", "AMOUNT_EUR" ], "example": "TRX_ALL" }, "maxAmount": { "description": "Maximum amount of money that can be spend by this card. Value in penny.", "type": "integer", "example": "10000000" }, "maxAttempts": { "description": "Number of transaction that can be handled with this card.", "type": "integer", "example": "99" }, "period": { "description": "Describes if limit is periodically. For example, if card can handle transactions for 100PLN per day, or maybe 100 transactions per week", "type": "string", "enum": [ "DAILY", "WEEKLY", "MONTHLY" ], "example": "DAILY" }, "expiration": { "description": "Date of card limit expiration. After that, limit will be no longer checked", "type": "string", "format": "date", "example": "2099-12-24" } }, "type": "object" } } } }, "responses": { "201": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CardLimitResource" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "CARD_NOT_FOUND" } }, "type": "object" } } } }, "422": { "description": "Request validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "InvalidLimitParameters": { "$ref": "#/components/examples/InvalidLimitParameters" }, "InvalidMaxAmount": { "$ref": "#/components/examples/InvalidMaxAmount" }, "InvalidMaxAttempts": { "$ref": "#/components/examples/InvalidMaxAttempts" }, "CurrencyWithTypeMismatch": { "$ref": "#/components/examples/CurrencyWithTypeMismatch" }, "InvalidType": { "summary": "INVALID_TYPE", "value": { "status": "INVALID_TYPE", "errors": { "type": [ "INVALID_TYPE" ] } } }, "ValidationMultiFields": { "summary": "VALIDATION", "value": { "status": "INVALID_TYPE", "errors": { "type": [ "INVALID_TYPE" ], "period": [ "INVALID_PERIOD" ], "expiration": [ "DATE_IS_INVALID" ] } } } } } } } } } }, "/customers/me/cards/{cardId}/limits/{limitId}": { "get": { "tags": [ "Customer Cards" ], "summary": "Get specific card limit", "description": "Allows to retrieve specific limit for given card", "parameters": [ { "name": "cardId", "in": "path", "description": "DataCore card id", "required": true, "schema": { "type": "integer", "example": 1125 } }, { "name": "limitId", "in": "path", "description": "Card limit id", "required": true, "schema": { "type": "string", "format": "uuid", "example": "492ec5ee-7f66-11ec-a8a3-0242ac120002" } } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CardLimitResource" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "CardNotFound": { "$ref": "#/components/examples/CardNotFound" }, "CardLimitNotFound": { "$ref": "#/components/examples/CardLimitNotFound" } } } } } } }, "delete": { "tags": [ "Customer Cards" ], "summary": "Delete card limit", "description": "Allows to delete specific limit for given card", "parameters": [ { "name": "cardId", "in": "path", "description": "DataCore card id", "required": true, "schema": { "type": "integer", "example": 1125 } }, { "name": "limitId", "in": "path", "description": "Card limit id", "required": true, "schema": { "type": "string", "format": "uuid", "example": "492ec5ee-7f66-11ec-a8a3-0242ac120002" } } ], "responses": { "204": { "description": "Successful operation" }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "CardNotFound": { "$ref": "#/components/examples/CardNotFound" }, "CardLimitNotFound": { "$ref": "#/components/examples/CardLimitNotFound" } } } } } } }, "patch": { "tags": [ "Customer Cards" ], "summary": "Update card limit", "description": "Allows to update parameters of specific limit for given card", "parameters": [ { "name": "cardId", "in": "path", "description": "DataCore card id", "required": true, "schema": { "type": "integer", "example": 1125 } }, { "name": "limitId", "in": "path", "description": "Card limit id", "required": true, "schema": { "type": "string", "format": "uuid", "example": "492ec5ee-7f66-11ec-a8a3-0242ac120002" } } ], "requestBody": { "description": "Input data", "required": true, "content": { "application/json": { "schema": { "properties": { "maxAmount": { "description": "Maximum amount of money that can be spend by this card. Value in penny.", "type": "integer", "example": "10000000", "nullable": "true" }, "maxAttempts": { "description": "Number of transaction that can be handled with this card.", "type": "integer", "example": "99", "nullable": "true" }, "period": { "description": "Describes if limit is periodically. For example, if card can handle transactions for 100PLN per day, or maybe 100 transactions per week", "type": "string", "enum": [ "DAILY", "WEEKLY", "MONTHLY" ], "example": "DAILY", "nullable": "true" }, "expiration": { "description": "Date of card limit expiration. After that, limit will be no longer checked", "type": "string", "format": "date", "example": "2099-12-24", "nullable": "true" } }, "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" }, "CardLimitNotFound": { "$ref": "#/components/examples/CardLimitNotFound" } } } } }, "422": { "description": "Request validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "InvalidLimitParameters": { "$ref": "#/components/examples/InvalidLimitParameters" }, "InvalidMaxAmount": { "$ref": "#/components/examples/InvalidMaxAmount" }, "InvalidMaxAttempts": { "$ref": "#/components/examples/InvalidMaxAttempts" }, "InvalidType": { "summary": "INVALID_TYPE", "value": { "status": "INVALID_TYPE", "errors": { "type": [ "INVALID_TYPE" ] } } }, "ValidationMultiFields": { "summary": "VALIDATION", "value": { "status": "INVALID_TYPE", "errors": { "type": [ "INVALID_TYPE" ], "period": [ "INVALID_PERIOD" ], "expiration": [ "DATE_IS_INVALID" ] } } } } } } } } } }, "/customers/me/cards/virtual/async": { "post": { "tags": [ "Customer Cards" ], "summary": "Create new virtual card assigned to customer balance. [Async Process]", "description": "\n## BE NOTIFIED\n- For this method is required to pass configuration **id** obtained from EP(**CustomerCards**):: `GET /customers/me/cards/config`\n- This method initialize async process to follow current status of running process and this is only required step for card creation. \n- Please use this link if you want track progress of async process and want to be redirected to created resource EP(**AsyncOperation**):: `GET /async_operations/{id}` \n- Following process is not mandatory. Card will be added anyway so you can obtain it from GET /cards endpoint further.\n", "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" }, "configId": { "description": "Configuration identifier obtained from method: /customers/me/cards/config", "type": "string", "example": "0013009713" } }, "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": { "CustomerBalanceNotFound": { "$ref": "#/components/examples/CustomerBalanceNotFound" }, "CustomerNotFound": { "$ref": "#/components/examples/CustomerNotFound" }, "InvalidConfiguration": { "$ref": "#/components/examples/InvalidConfiguration" }, "InvalidCurrency": { "$ref": "#/components/examples/InvalidCurrency" } } } } } } } }, "/customers/me/cards/virtual": { "post": { "tags": [ "Customer Cards" ], "summary": "Create new virtual card assigned to customer balance.", "description": "\nFor this method is required to pass configuration id obtained from GET /customers/me/cards/config \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 ", "requestBody": { "description": "Input data", "required": true, "content": { "application/json": { "schema": { "properties": { "balanceId": { "description": "Customer balance id for which card should be linked", "type": "string" }, "configId": { "description": "Configuration identifier obtained from method: /customers/me/cards/config", "type": "string", "example": "0013009713" } }, "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" }, "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" } } } } } } } }, "/customers/me/cards/{cardId}": { "get": { "tags": [ "Customer Cards" ], "summary": "Get customer card details", "description": "Returns details of customer card\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", "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/CardDetails" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "CardNotFound": { "$ref": "#/components/examples/CardNotFound" } } } } } } }, "delete": { "tags": [ "Customer Cards" ], "summary": "Delete customer's card", "description": "Method delete prepaid card. Be careful, this card is deleted from all services (prepaid, dc, tutuka)", "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" } } } } } } } }, "/customers/me/cards/{cardId}/lock": { "post": { "tags": [ "Customer Cards" ], "summary": "Lock customer's card.", "description": "Method locks prepaid card. Card is also locked in tutuka system (card issuer) and DataCore (card storage).", "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": { "reason": { "description": "Reason for locking the card", "type": "string", "enum": [ "CARD_LOST", "CARD_STOLEN", "PENDING_QUERY", "CARD_CONSOLIDATION", "CARD_INACTIVE", "PIN_TRIES_EXCEEDED", "SUSPECTED_FRAUD", "CARD_REPLACED" ], "example": "CARD_STOLEN" }, "note": { "description": "A note / reason about stopping the card", "type": "string", "example": "Some note about stopping the card" } }, "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" }, "LockCardFailure": { "$ref": "#/components/examples/LockCardFailure" }, "CardIssuerError": { "$ref": "#/components/examples/CardIssuerError" } } } } }, "422": { "description": "Request validation failed", "content": { "application/json": { "schema": { "properties": { "status": { "description": "Validation status", "type": "string", "enum": [ "INVALID_REASON", "INVALID_NOTE" ], "example": "INVALID_REASON" }, "errors": { "type": "object" } }, "type": "object" } } } } } } }, "/customers/me/cards/{cardId}/unlock": { "post": { "tags": [ "Customer Cards" ], "summary": "Unlock customer's card.", "description": "Method unlocks prepaid card. Card is also unlocked in tutuka system (card issuer) and DataCore (card storage).", "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": { "note": { "description": "A note / reason about unstopping the card", "type": "string", "example": "Some note about unstopping the card" } }, "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" }, "UnlockCardFailure": { "$ref": "#/components/examples/UnlockCardFailure" }, "CardIssuerError": { "$ref": "#/components/examples/CardIssuerError" } } } } }, "422": { "description": "Request validation failed", "content": { "application/json": { "schema": { "properties": { "status": { "description": "Validation status", "type": "string", "example": "INVALID_NOTE" }, "errors": { "type": "object" } }, "type": "object" } } } } } } }, "/customers/me/cards/{cardId}/activation": { "post": { "tags": [ "Customer Cards" ], "summary": "Activate previously ordered card", "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": { "properties": { "status": { "description": "Cant find card with requested id or card does not belong to logged user", "type": "string", "example": "CARD_NOT_FOUND" } }, "type": "object" } } } } } } }, "/customers/me/cards/config": { "get": { "tags": [ "Customer 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", "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CardAllowedConfig" } } } } } } } }, "/customers/me/cards/{cardId}/pin": { "post": { "tags": [ "Customer Cards" ], "summary": "Change card pin", "description": "Method allows to update card pin", "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" } } } } } } } }, "/customers/me/cards/{cardId}/cvv": { "post": { "tags": [ "Customer 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)", "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" }, "InvalidCard": { "$ref": "#/components/examples/InvalidCard" }, "CardIssuerError": { "$ref": "#/components/examples/CardIssuerError" } } } } } } } }, "/customers/me/cards/{cardId}/budget": { "get": { "tags": [ "Customer Cards" ], "summary": "Get card budget", "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" } } } } } } } }, "/customers/me/cards/physical": { "post": { "tags": [ "Customer Cards" ], "summary": "Order new physical card. This method starts order process.", "requestBody": { "description": "Input data format", "required": true, "content": { "application/json": { "schema": { "properties": { "firstName": { "description": "First name of card holder", "type": "string", "example": "Jane" }, "lastName": { "description": "Last name of card holder", "type": "string", "example": "Doe" }, "city": { "description": "City of card holder. Also this is part of address on which card will be send", "type": "string", "example": "Lublin" }, "street": { "description": "Part of address on which card will be send", "type": "string", "example": "Rusałka" }, "number": { "description": "House/appartment number. Also this is part of address on which card will be send", "type": "string", "example": "17a" }, "postCode": { "description": "Postal code of city. Also this is part of address on which card will be send", "type": "string", "example": "20-123" }, "country": { "description": "Country of card holder", "type": "string", "example": "Polska" }, "balanceId": { "description": "Identifier of balance to which card will be attached", "type": "string", "example": "e31b76e0-21df-11ed-861d-0242ac120002" }, "configId": { "description": "Card configuration identifier. Could be obtained from 'GET /customers/me/cards/config'", "type": "string", "example": "0013009713" } }, "type": "object" } } } }, "responses": { "202": { "description": "Successful operation" }, "422": { "description": "Request validation failed", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "enum": [ "INVALID_FIRST_NAME", "INVALID_LAST_NAME", "INVALID_CITY", "INVALID_STREET", "INVALID_NUMBER", "INVALID_POST_CODE", "INVALID_COUNTRY", "INVALID_BALANCE_ID", "CANNOT_MATCH_CONFIGURATION" ], "example": "INVALID_FIRST_NAME" } }, "type": "object" } } } } } } }, "/customers/me/verifications/status": { "get": { "tags": [ "Customer Registration" ], "summary": "Obtain verification status", "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" ] } }, "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" } } } } } } }, "/customers/me/register": { "post": { "tags": [ "Customer Registration" ], "summary": "Initialize customer verification process", "description": "Method is first step for customer registration. After this step, admin should accept or reject verification request", "requestBody": { "description": "Input data format", "content": { "multipart/form-data": { "schema": { "required": [ "firstName", "lastName", "birthDate", "city", "street", "postCode", "country", "documentType", "imageFace", "imageFront" ], "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" }, "city": { "description": "City of custmer", "type": "string", "example": "Lublin" }, "street": { "description": "Customer street", "type": "string", "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" }, "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" }, "nationality": { "description": "Customer nationality", "type": "string", "example": "polish", "nullable": "true" }, "imageFace": { "description": "Customer face photo. Allowed formats: jpeg, jpg, png. Maximum file size - 2MB", "type": "string", "format": "binary" }, "imageFront": { "description": "Front photo of document passed in request. Allowed formats: jpeg, jpg, png. Maximum file size - 2MB", "type": "string", "format": "binary" }, "documentType": { "description": "Type of document passed in request. Allowed formats: passport,idCard", "type": "string", "enum": [ "passport", "idCard" ], "example": "passport" }, "documentExpirationDate": { "description": "Document expiration Date", "type": "string", "format": "date", "example": "2025-01-30" }, "imageBack": { "description": "Back photo of document passed in request. Required only if document type is idCard. Allowed formats: jpeg, jpg, png. Maximum file size - 2MB", "type": "string", "format": "binary" }, "usaResident": { "description": "Customer is tax resident in USA
true=1 false=0", "type": "boolean", "format": "boolean", "nullable": "true" }, "taxResident": { "description": "Client's tax residency listexampaleRequest:
\n| Body Key | Body Value |\n|:-------------:|------:|\n| taxResident[0] | DE |", "format": "array", "nullable": "true" }, "sourceOfFunds": { "description": "\nArray of customer's funds sources:\n\nbusiness_activity: Nip (VAT number) or/and REGON (National Business Registry Number) is required when you send business_activity field
\nsalary: Profession is required when salary is send.
\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" } }, "type": "object" }, "encoding": "form-data" } } }, "responses": { "201": { "description": "successful operation", "content": { "application/json": { "schema": { "properties": { "id": { "description": "Verification identifier in uuid format", "type": "string", "format": "uuid", "example": "3dc88ad5-7053-454b-bcb8-e067c436f17d" } }, "type": "object" } } } }, "422": { "description": "Request validation failed", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string" }, "errors": { "type": "object" } }, "type": "object" }, "examples": { "FIELD_IS_REQUIRED": { "summary": "FIELD_IS_REQUIRED", "value": { "status": "FIELD_IS_REQUIRED", "errors": { "fieldName": [ "FIELD_IS_REQUIRED" ] } } }, "CustomerAlreadyRegistered": { "$ref": "#/components/examples/CustomerAlreadyRegistered" }, "HasPendingVerifications": { "$ref": "#/components/examples/HasPendingVerifications" }, "PermanentlyLocked": { "$ref": "#/components/examples/PermanentlyLocked" }, "DateIsInvalid": { "$ref": "#/components/examples/DateIsInvalid" }, "DateFormatIsInvalid": { "$ref": "#/components/examples/DateFormatIsInvalid" }, "InvalidFileSize": { "summary": "INVALID_FILE_SIZE", "value": { "status": "INVALID_FILE_SIZE" } }, "InvalidFileFormat": { "summary": "INVALID_FILE_FORMAT", "value": { "status": "INVALID_FILE_FORMAT" } } } } } } } } }, "/customers/me": { "get": { "tags": [ "Customer" ], "summary": "Get customer details", "description": "Returns customer details with list of addresses", "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomerResource" } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "properties": { "status": { "type": "string", "example": "CUSTOMER_NOT_FOUND" } }, "type": "object" } } } } } } }, "/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 \nKeep in mind that along with status this method can return Location header involving url path to created resource.", "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 }, "cardType": { "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 } }, "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" } }, "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" }, "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" }, "CardLimitCollection": { "title": "CardLimitCollection", "description": "Card limit resource collection", "properties": { "data": { "title": "data", "description": "data", "type": "array", "format": "array", "items": { "$ref": "#/components/schemas/CardLimitResource" } } }, "type": "object" }, "CardLimitResource": { "title": "CardLimitResource", "description": "CardLimitResource", "properties": { "id": { "title": "Unique id of created resource", "description": "id", "format": "uuid", "example": "492ec5ee-7f66-11ec-a8a3-0242ac120002" }, "type": { "title": "Card limit type", "description": "Type of card limitation", "type": "string", "enum": [ "TRX_ALL", "TRX_E_COM", "TRX_ATM", "FOREIGN_QUANTITY", "FOREIGN_AMOUNT", "QUANTITY", "AMOUNT_PLN", "AMOUNT_EUR" ], "example": "TRX_ALL" }, "maxAmount": { "title": "maxAmount", "description": "Maximum amount to spend", "format": "int", "example": "4555555552" }, "maxAttempts": { "title": "maxAttempts", "description": "Maximum number of transactions", "format": "int", "example": "99" }, "period": { "title": "period", "description": "Period for card limit", "type": "string", "enum": [ "DAILY", "WEEKLY", "MONTHLY" ], "example": "DAILY" }, "expiration": { "title": "expiration", "description": "Date of limit expiration", "format": "date", "example": "2024-12-24 12:00:00" }, "currency": { "title": "currency", "description": "Currency of a card", "format": "string", "example": "PLN" }, "mcc_list": { "title": "mcc_list", "description": "Merchant cartegory codes of black/white list", "format": "array", "example": [ "4821", "4822" ] } }, "type": "object" }, "CustomerResource": { "title": "CustomerResource", "description": "CustomerResource", "properties": { "id": { "description": "Id", "type": "integer", "example": 1125 }, "firstName": { "description": "First name", "type": "string", "example": "Jane" }, "lastName": { "description": "Last name", "type": "string", "example": "Doe" }, "birthDate": { "description": "Birth date", "type": "string", "format": "date", "example": "1970-01-01" }, "address": { "$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" } } } } ] }, "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" } }, "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" }, "CardAllowedConfigCollection": { "title": "CardAllowedConfigCollection", "description": "CardAllowedConfig Resource" }, "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" } }, "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" } } } } ] }, "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" }, "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", "example": "LOW" }, "createdAt": { "title": "createdAt", "description": "createdAt", "type": "string", "format": "date", "example": "2020-01-20 12:03:45" }, "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 }, "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" } }, "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" }, "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 }, "customer": { "$ref": "#/components/schemas/VerificationCustomer" }, "address": { "$ref": "#/components/schemas/VerificationAddress" }, "documents": { "title": "documents", "description": "Verification documents", "type": "array", "items": { "$ref": "#/components/schemas/VerificationDocument" } }, "identityCardNo": { "title": "identityCardNo", "description": "Number of identity card", "type": "string", "example": "ARG691869", "nullable": true } } } ] }, "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" } } } } ] }, "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" ], "example": "customer" }, "resourceId": { "description": "Resource identifier", "type": "string", "example": "1337" }, "reason": { "description": "reason of resource lock", "type": "string", "enum": [ "DOCUMENT_EXPIRED" ], "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" } } } } ] }, "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" } } } ] }, "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", "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" } } } } ] }, "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" }, "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": "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" } } } } ] }, "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" } } } } ] }, "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" }, "CardLimitEntity": { "title": "Card limit", "description": "Card Limit", "properties": { "maxAmount": { "title": "Maximum amount for spend", "description": "maxAmount", "type": "integer", "format": "int", "example": "7", "nullable": true }, "timePeriod": { "title": "Time validity of card limit.", "description": "timePeriod", "type": "string", "format": "DateTime", "example": "daily", "nullable": true }, "maxAttempts": { "title": "Maximum allowed number of transactions", "description": "maxAttempts", "type": "integer", "format": "int", "example": "7", "nullable": true }, "type": { "title": "Card limit type", "description": "type", "type": "string", "format": "string" }, "expiration": { "title": "Time after limit will expire.", "description": "expiration", "type": "string", "format": "DateTime", "example": "2023-01-01 12:00:00", "nullable": true } }, "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": "