Contomobile Payment Cloud is a solution designed for payment institutions to execute transfers of their customers.
\nThe changes below must be implemented by 31 January 2027. In this documentation new methods are marked with π.
\nTransition from unstructured to structured addresses
\nPostalAddressObject / AddressObject) now uses structured fields: department, subdepartment, street, buildingNumber, buildingName, floor, postBox, room, postCode, townName, townLocationName, districtName, countrySubdivision, together with countryCode and the unstructured address line line.countryCode and line are mandatory. townName is mandatory from the agreed date.payer.postalAddress and beneficiary.postalAddress (POST /payments/transfer, GET /payments/transfer, incoming_payment webhook); residenceAddress and postalAddress of individual customers; registrationAddress and postalAddress of corporate customers.New methods π
\nPUT /customers/individual β updates residenceAddress and postalAddress of an existing individual customer.PUT /customers/corporate β updates registrationAddress and postalAddress of an existing corporate customer.Action required: the addresses of all existing customers must be updated to the structured format using the new PUT methods.
To start using Contomobile Payment Cloud, you need to contact support (support@contomobile.com) to get access to the Sandbox/Production environment. You need to provide IP addresses from which API requests will be made.
\nYou must use a valid Client ID+Secret to send requests to the API endpoints.
\nThe API only responds to HTTPS-secured communications.
\nThe API returns request responses in JSON format. When an API request returns an error, it is sent in the JSON response as an error key.
\nContomobile Payment Cloud API uses X-Client-Id and X-Client-Secret HTTP headers for authentication. You must include these headers in each request to Contomobile Payment Cloud API.
Access to the API is restricted by a list of IP addresses, because of that you need to provide IP addresses from which API requests will be made.
\nIf X-Client-Id and/or X-Client-Secret HTTP headers is missing, malformed, or invalid, you will receive an HTTP 401 Unauthorized response code.
API requests are not limited.
\nIf the API responds with HTTP status code 200, it will contain the HTTP response body in JSON format. The JSON response is normalized - each response will have data and status JSON keys.
The value of data JSON key may be null if the API returns nothing, otherwise it will be an JSON Object or JSON Array (read APIs description).
The status JSON key is always an JSON Object of following structure:
An HTTP 200 response from our servers indicates that your request was processed in our side but it does not mean that everything is OK - you need to check a value in status.isSuccess JSON key from the response body: if the value is true then everything is OK, otherwise you will get an array of errors in the status.messages JSON key.
An HTTP 401 response from our servers indicates that X-Client-Id and/or X-Client-Secret HTTP headers is missing, malformed, or invalid in your request.
An HTTP 500 response from our servers indicates that your request was not processed in our side and you should check and correct your request.
An HTTP 503 response from our servers indicates there is an unexpected spike in API access traffic. The server is usually operational within the next five minutes. If the outage persists or you receive any other form of an HTTP 5XX error, contact support (support@contomobile.com).
Returns a balance of your main account. The balance should be large enough so that your clients can transfer money without problems. If the account balance falls, then the account needs to be replenished - this can be done using an international payment or another method (contact support for more information).
\n","urlObject":{"path":["accounts","balance"],"host":["{{baseUrl}}"],"query":[{"description":{"content":"(required) The currency on main account (three-letter ISO currency code). Currently should be EUR only
\n","type":"text/plain"},"key":"currency","value":"EUR"}],"variable":[]}},"response":[{"id":"2188331a-87f7-44ad-a365-f3b2f0806eec","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://payment-cloud-cnt2.contomobiledev.com/accounts/balance?currency=EUR","protocol":"https","host":["payment-cloud-cnt2","contomobiledev","com"],"path":["accounts","balance"],"query":[{"key":"currency","value":"EUR","description":"(required) The currency on main account (three-letter ISO currency code). Currently should be EUR only"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"balance\": {\n \"currency\": \"EUR\",\n \"availableBalance\": 78494.36\n }\n },\n \"status\": {\n \"correlationId\": \"WEBAPI-4eccb642-eb42-442f-a10d-048a5d1b5d13\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"},{"id":"e1034f1e-e720-4d03-988f-bb62933fbd61","name":"Unauthorized","originalRequest":{"method":"GET","header":[],"url":"{{baseUrl}}/accounts/balance"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"AUTH-1c0985b8-fb81-4707-a3dd-081bd017d0dd\",\n \"isSuccess\": false,\n \"statusCode\": 401,\n \"messages\": [\n {\n \"code\": null,\n \"priority\": \"ERROR\",\n \"title\": \"Unauthorized.\",\n \"description\": null,\n \"field\": null\n }\n ]\n }\n}"},{"id":"9142f548-c2b0-4904-b3a1-35663b739ac4","name":"Currency missing","originalRequest":{"method":"GET","header":[],"url":"{{baseUrl}}/accounts/balance"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"WEBAPI-8303b5ce-be84-4968-91ac-aa6c15d15f04\",\n \"isSuccess\": false,\n \"statusCode\": 200,\n \"messages\": [\n {\n \"code\": \"FIELD_IS_MANDATORY\",\n \"priority\": \"ERROR\",\n \"title\": \"Field is mandatory.\",\n \"description\": null,\n \"field\": \"currency\"\n }\n ]\n }\n}"}],"_postman_id":"e070cd0f-e0ac-4826-b94e-e615692ec5a4"}],"id":"bc0d97a2-960f-4689-b80d-0e1ec6dc6a04","description":"After becoming a Contomobile Payment Cloud client you will get an individual IBAN number in EUR currency from which all payments will be made. You must maintain a non-zero account balance because otherwise you will not be able to make a SEPA payments. /accounts/ resource allows you to manage your account.
Initiate beneficiary verification.
\nCall to initiate Verification of Payee. Service is allowed upon additional agreement between Contomobile and the client.
\nRequest body
\nResponse body
\n","urlObject":{"path":["beneficiary","verification"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"f77cf0ca-199e-4bc6-a0dd-fb308382ab1f","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"beneficiaryName\":\"UAB \\\"COPY PRO\\\"\",\r\n \"beneficiaryAccount\":\"LT367410010240500073\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/beneficiary/verification"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 08 May 2026 11:29:53 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"182"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"requestId\": \"c16a9187-395e-4e5e-a23d-73cd0363874c\"\n },\n \"status\": {\n \"correlationId\": \"WEBAPI-30b0f00e-c0dd-4bb0-9a2d-d2a912ec397d\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"},{"id":"b8d8ced8-8fc9-4b57-8c76-b95f520ab56f","name":"VOP not allowed","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"beneficiaryName\":\"UAB \\\"COPY PRO\\\"\",\r\n \"beneficiaryAccount\":\"LT367410010240500073\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/beneficiary/verification"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 08 May 2026 11:16:26 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"253"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"WEBAPI-2a067dae-6e0c-4214-9d32-b3eaf5904fc2\",\n \"isSuccess\": false,\n \"statusCode\": 200,\n \"messages\": [\n {\n \"code\": \"SERVICE_IS_NOT_ALLOWED\",\n \"priority\": \"ERROR\",\n \"title\": \"Service is not allowed.\",\n \"description\": null,\n \"field\": null\n }\n ]\n }\n}"},{"id":"45450dbe-0d69-4762-a176-dfe034a2ae51","name":"Invalid IBAN","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"beneficiaryName\":\"Dupont Jean\",\r\n \"beneficiaryAccount\":\"BE12345678901234\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/beneficiary/verification"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 08 May 2026 11:17:15 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"251"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"WEBAPI-f800e617-1691-47be-9eb2-df2c5dcbf3db\",\n \"isSuccess\": false,\n \"statusCode\": 200,\n \"messages\": [\n {\n \"code\": \"INVALID_IBAN\",\n \"priority\": \"ERROR\",\n \"title\": \"IBAN account number is invalid.\",\n \"description\": null,\n \"field\": null\n }\n ]\n }\n}"}],"_postman_id":"7394d844-a1bb-4087-a5e7-1e52fc4d0faa"},{"name":"Verification status","id":"19dffcfd-6988-467d-ae32-1a0d6989806d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseUrl}}/beneficiary/verification-status?request_id=ca66c271-226f-4921-bf07-e7a22f438e7a","description":"Receive beneficiary verification status.
\nRequest body
\n","urlObject":{"path":["beneficiary","verification-status"],"host":["{{baseUrl}}"],"query":[{"key":"request_id","value":"ca66c271-226f-4921-bf07-e7a22f438e7a"}],"variable":[]}},"response":[{"id":"83245be0-cfd1-4cbb-bc46-f49b86b882b7","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/beneficiary/verification-status?request_id=c16a9187-395e-4e5e-a23d-73cd0363874c","host":["{{baseUrl}}"],"path":["beneficiary","verification-status"],"query":[{"key":"request_id","value":"c16a9187-395e-4e5e-a23d-73cd0363874c"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 08 May 2026 11:33:04 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"210"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"status\": \"MATCHED\",\n \"correctName\": null,\n \"errorCode\": null,\n \"errorDescription\": null\n },\n \"status\": {\n \"correlationId\": \"WEBAPI-1b69aef6-0faa-402a-a121-cd7c6b65e73d\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"},{"id":"bbcda368-b801-483d-87ac-5e3d0c0312ae","name":"Partial match","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/beneficiary/verification-status?request_id=ca66c271-226f-4921-bf07-e7a22f438e7a","host":["{{baseUrl}}"],"path":["beneficiary","verification-status"],"query":[{"key":"request_id","value":"ca66c271-226f-4921-bf07-e7a22f438e7a"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 08 May 2026 11:34:32 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"234"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"status\": \"PARTIALLY_MATCHED\",\n \"correctName\": \"UAB \\\"COPY PRO\\\"\",\n \"errorCode\": null,\n \"errorDescription\": null\n },\n \"status\": {\n \"correlationId\": \"WEBAPI-70baa937-5267-484c-805b-b5899c638195\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"}],"_postman_id":"19dffcfd-6988-467d-ae32-1a0d6989806d"}],"id":"edec3d70-987e-400b-bafa-3fe987bd59b2","description":"The beneficiary services described in this section are part of the Contomobile API platform and are used for Verification of Payee (VOP) functionality. Verification of Payee is a European Union regulatory requirement intended to reduce fraud and misdirected payments by validating whether the beneficiary account belongs to the specified beneficiary before payment execution.
\nContomobile Verification of Payee API currently supports beneficiary verification using beneficiary account and beneficiary name only. This functionality is provided by Contomobile as an optional service and is not enabled by default for all clients. Clients interested in using VOP services must contact Contomobile support to arrange the required agreement and enablement process before accessing these endpoints.
\n","_postman_id":"edec3d70-987e-400b-bafa-3fe987bd59b2"},{"name":"Customers","item":[{"name":"Individuals (private persons)","item":[{"name":"Create customer","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"dc98f6cb-b7da-4bce-8cdc-b9dcfe7ead98"}},{"listen":"prerequest","script":{"exec":["var uuid = require(\"uuid\")\r","pm.collectionVariables.set('lastPrivateCustRef', uuid.v4());"],"type":"text/javascript","packages":{},"requests":{},"id":"34f2ea11-77a3-4184-a421-30b1f7b5873d"}}],"id":"89a06aac-dd9d-42ac-a862-c6367c8f7c55","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"60c3080d-3db2-4380-9a9d-36bff78535a6\",\r\n \"riskLevel\": \"low\",\r\n \"firstName\": \"Kiley\",\r\n \"lastName\": \"Wolf\",\r\n \"citizenships\": [\r\n \"GB\",\r\n \"US\",\r\n \"LT\"\r\n ],\r\n \"residenceAddress\": {\r\n \"countryCode\": \"LT\",\r\n \"townName\": \"Mayertmouth\",\r\n \"street\": \"Veda Place\",\r\n \"buildingNumber\": \"400\",\r\n \"postCode\": \"LT-580\",\r\n \"department\": \"Automotive\",\r\n \"subdepartment\": \"Books\",\r\n \"buildingName\": \"Barrows, Nicolas and Langworth Business Center\",\r\n \"floor\": \"15\",\r\n \"postBox\": \"PO Box 506\",\r\n \"room\": \"235\",\r\n \"townLocationName\": \"Vada Manors\",\r\n \"districtName\": \"New Shemar district\",\r\n \"countrySubdivision\": \"South Bianka county\",\r\n \"line\": \"38307 Quitzon Lock, New Lizeth\"\r\n },\r\n \"postalAddress\": {\r\n \"countryCode\": \"LV\",\r\n \"townName\": \"West Ernestobury\",\r\n \"street\": \"Margarita Mountains\",\r\n \"buildingNumber\": \"959\",\r\n \"postCode\": \"LV-219\",\r\n \"department\": \"Shoes\",\r\n \"subdepartment\": \"Health\",\r\n \"buildingName\": \"Dietrich LLC Business Center\",\r\n \"floor\": \"56\",\r\n \"postBox\": \"PO Box 759\",\r\n \"room\": \"732\",\r\n \"townLocationName\": \"Stokes Island\",\r\n \"districtName\": \"St. Paul district\",\r\n \"countrySubdivision\": \"Lewisville county\",\r\n \"line\": \"6862 Leuschke Streets, Tonawanda\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/customers/individual","description":"This endpoint allows you to create a new private customer in the system. It requires a JSON payload containing customer details.
\nreference (string): A unique reference identifier for the customer.
\nriskLevel (string): The risk level associated with the customer. This can be set to values such as \"low\", \"medium\", or \"high\".
\nfirstName (string): The first name of the customer.
\nlastName (string): The last name of the customer.
\ncitizenships (array of strings): An array of citizenship codes representing the customer's citizenships. For example, \"GB\" for Great Britain.
\nresidenceAddress (object): The address where the customer resides. See AddressObject.
\npostalAddress (object): The postal address for the customer. See AddressObject.
\nAddressObject
\nStructured address together with unstructured address line.
\ncountryCode and the unstructured address line line are mandatory and must always be provided together with the structured address fields. townName is mandatory from the agreed date. All other fields are optional and may be null.
Status Code: 200 OK
\nContent-Type: application/json
\nResponse Body:
\ndata (null): This field is currently not used and will return null.
\nstatus (object): Contains the status of the request.
\ncorrelationId (string): An identifier for tracking the request.
\nisSuccess (boolean): Indicates whether the request was successful.
\nstatusCode (integer): The status code of the operation.
\nmessages (array of strings): An array of messages related to the request status.
\nEnsure that the required fields are populated correctly to avoid validation errors.
\nThe response will indicate success or failure, with additional details available in the status object.
Updates the structured addresses of an existing individual customer.
\nThe customer is identified by the reference that was used when the customer was created using POST /customers/individual service.
Request body
\nAddressObject
\nStructured address together with unstructured address line.
\ncountryCode and the unstructured address line line are mandatory and must always be provided together with the structured address fields. townName is mandatory from the agreed date. All other fields are optional and may be null.
Response body
\nThe value of data JSON key is null. Check status.isSuccess for the result.
This endpoint retrieves detailed information about a private customer based on the provided reference. It is useful for obtaining customer details such as personal information and address data.
\n","urlObject":{"path":["customers","individual"],"host":["{{baseUrl}}"],"query":[{"description":{"content":"Private customer reference
\n","type":"text/plain"},"key":"reference","value":"60c3080d-3db2-4380-9a9d-36bff78535a6"}],"variable":[]}},"response":[],"_postman_id":"accceaba-d59d-479a-8f95-5c448bf3b506"},{"name":"List of customers","id":"9447b81e-e496-42bc-b4a4-d688a19571ab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseUrl}}/customers/individuals?page=1&page_size=100&citizenship=&first_name=&last_name=&risk_level=&residence_address_country=&postal_address_country=","description":"This endpoint allows you to retrieve a list of private customers based on specified query parameters.
\nOn a successful request, the API returns a status code of 200 along with a JSON response containing the following structure:
\ndata: An object containing:
individuals: An array of private customer objects, each including:
reference: A reference identifier for the customer.
riskLevel: The risk level associated with the customer.
firstName: The first name of the customer.
lastName: The last name of the customer.
citizenships: An array of citizenships for the customer.
residenceAddress: Residence address (see AddressObject in POST /customers/individual).
postalAddress: Postal address (see AddressObject in POST /customers/individual).
_links: An object containing:
self: A link to the current resource, with a href and a templated flag.status: An object containing:
correlationId: A unique identifier for tracking the request.
isSuccess: A boolean indicating the success of the request.
statusCode: The status code of the operation.
messages: An array of messages related to the request.
Ensure that the parameters are properly encoded in the URL when making the request.
\nThe response will include an array of private customers that match the specified filters.
\nPage number of returning list of private customers
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Page size of returning list of private customers
\n","type":"text/plain"},"key":"page_size","value":"100"},{"description":{"content":"Filter resultset by citizenship country code
\n","type":"text/plain"},"key":"citizenship","value":""},{"description":{"content":"Filter resultset by first name pattern
\n","type":"text/plain"},"key":"first_name","value":""},{"description":{"content":"Filter resultset by last name pattern
\n","type":"text/plain"},"key":"last_name","value":""},{"description":{"content":"Filter resultset by risk level
\n","type":"text/plain"},"key":"risk_level","value":""},{"description":{"content":"Filter resultset by residence address country code
\n","type":"text/plain"},"key":"residence_address_country","value":""},{"description":{"content":"Filter resultset by postal address country code
\n","type":"text/plain"},"key":"postal_address_country","value":""}],"variable":[]}},"response":[{"id":"be35a743-1aec-44f5-bbe4-77a16f424505","name":"List of private customers","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/customers/privates?page=1&page_size=100&citizenship=US&first_name=o&last_name=o&risk_level=low&residence_address_country=LT&postal_address_country=LV","host":["{{baseUrl}}"],"path":["customers","privates"],"query":[{"key":"page","value":"1","description":"Page number of returning list of private customers"},{"key":"page_size","value":"100","description":"Page size of returning list of private customers"},{"key":"citizenship","value":"US","description":"Filter resultset by citizenship country code"},{"key":"first_name","value":"o","description":"Filter resultset by first name pattern"},{"key":"last_name","value":"o","description":"Filter resultset by last name pattern"},{"key":"risk_level","value":"low","description":"Filter resultset by risk level"},{"key":"residence_address_country","value":"LT","description":"Filter resultset by residence address country code"},{"key":"postal_address_country","value":"LV","description":"Filter resultset by postal address country code"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"individuals\": [\r\n {\r\n \"reference\": \"60c3080d-3db2-4380-9a9d-36bff78535a6\",\r\n \"riskLevel\": \"low\",\r\n \"firstName\": \"Shannon\",\r\n \"lastName\": \"Considine\",\r\n \"citizenships\": [\r\n \"GB\",\r\n \"LT\",\r\n \"US\"\r\n ],\r\n \"residenceAddress\": {\r\n \"countryCode\": \"LT\",\r\n \"townName\": \"Vilnius\",\r\n \"street\": \"Gedimino pr.\",\r\n \"buildingNumber\": \"9\",\r\n \"postCode\": \"LT-01103\",\r\n \"department\": null,\r\n \"subdepartment\": null,\r\n \"buildingName\": null,\r\n \"floor\": null,\r\n \"postBox\": null,\r\n \"room\": null,\r\n \"townLocationName\": null,\r\n \"districtName\": null,\r\n \"countrySubdivision\": null,\r\n \"line\": \"Gedimino pr. 9, Vilnius\"\r\n },\r\n \"postalAddress\": {\r\n \"countryCode\": \"LV\",\r\n \"townName\": \"Riga\",\r\n \"street\": \"Brivibas iela\",\r\n \"buildingNumber\": \"21\",\r\n \"postCode\": \"LV-1010\",\r\n \"department\": null,\r\n \"subdepartment\": null,\r\n \"buildingName\": null,\r\n \"floor\": null,\r\n \"postBox\": null,\r\n \"room\": null,\r\n \"townLocationName\": null,\r\n \"districtName\": null,\r\n \"countrySubdivision\": null,\r\n \"line\": \"Brivibas iela 21, Riga\"\r\n }\r\n },\r\n {\r\n \"reference\": \"616abb76-28e3-4a2e-b8c9-dbf42feb1c71\",\r\n \"riskLevel\": \"low\",\r\n \"firstName\": \"Simone\",\r\n \"lastName\": \"Stokes\",\r\n \"citizenships\": [\r\n \"GB\",\r\n \"LT\",\r\n \"US\"\r\n ],\r\n \"residenceAddress\": {\r\n \"countryCode\": \"LT\",\r\n \"townName\": \"Kaunas\",\r\n \"street\": \"Laisves al.\",\r\n \"buildingNumber\": \"53\",\r\n \"postCode\": \"LT-44309\",\r\n \"department\": null,\r\n \"subdepartment\": null,\r\n \"buildingName\": null,\r\n \"floor\": null,\r\n \"postBox\": null,\r\n \"room\": null,\r\n \"townLocationName\": null,\r\n \"districtName\": null,\r\n \"countrySubdivision\": null,\r\n \"line\": \"Laisves al. 53, Kaunas\"\r\n },\r\n \"postalAddress\": {\r\n \"countryCode\": \"LV\",\r\n \"townName\": \"Jelgava\",\r\n \"street\": \"LielΔ iela\",\r\n \"buildingNumber\": \"4\",\r\n \"postCode\": \"LV-3001\",\r\n \"department\": null,\r\n \"subdepartment\": null,\r\n \"buildingName\": null,\r\n \"floor\": null,\r\n \"postBox\": null,\r\n \"room\": null,\r\n \"townLocationName\": null,\r\n \"districtName\": null,\r\n \"countrySubdivision\": null,\r\n \"line\": \"LielΔ iela 4, Jelgava\"\r\n }\r\n },\r\n {\r\n \"reference\": \"64452834-7ae3-484c-8aa7-421bedef0447\",\r\n \"riskLevel\": \"low\",\r\n \"firstName\": \"Thomas\",\r\n \"lastName\": \"Barrows\",\r\n \"citizenships\": [\r\n \"GB\",\r\n \"LT\",\r\n \"US\"\r\n ],\r\n \"residenceAddress\": {\r\n \"countryCode\": \"LT\",\r\n \"townName\": \"Klaipeda\",\r\n \"street\": \"Tiltu g.\",\r\n \"buildingNumber\": \"12\",\r\n \"postCode\": \"LT-91246\",\r\n \"department\": null,\r\n \"subdepartment\": null,\r\n \"buildingName\": null,\r\n \"floor\": null,\r\n \"postBox\": null,\r\n \"room\": null,\r\n \"townLocationName\": null,\r\n \"districtName\": null,\r\n \"countrySubdivision\": null,\r\n \"line\": \"Tiltu g. 12, Klaipeda\"\r\n },\r\n \"postalAddress\": {\r\n \"countryCode\": \"LV\",\r\n \"townName\": \"Liepaja\",\r\n \"street\": \"Graudu iela\",\r\n \"buildingNumber\": \"7\",\r\n \"postCode\": \"LV-3401\",\r\n \"department\": null,\r\n \"subdepartment\": null,\r\n \"buildingName\": null,\r\n \"floor\": null,\r\n \"postBox\": null,\r\n \"room\": null,\r\n \"townLocationName\": null,\r\n \"districtName\": null,\r\n \"countrySubdivision\": null,\r\n \"line\": \"Graudu iela 7, Liepaja\"\r\n }\r\n }\r\n ],\r\n \"_links\": {\r\n \"self\": {\r\n \"href\": \"/pmcls-customers/privates?page=1&page_size=100&risk_level=low&first_name=o&last_name=o&citizenship=US&residence_address_country=LT&postal_address_country=LV\",\r\n \"templated\": false\r\n }\r\n }\r\n },\r\n \"status\": {\r\n \"correlationId\": \"WEBAPI-c2618c74-c8e1-4b2d-80d6-c2936353d608\",\r\n \"isSuccess\": true,\r\n \"statusCode\": 200,\r\n \"messages\": []\r\n }\r\n}"}],"_postman_id":"9447b81e-e496-42bc-b4a4-d688a19571ab"}],"id":"949d599c-f0fd-4a6c-bcb5-313958b4cb43","description":"Here you can find descriptions and examples how to create individual customer (natural person) using Contomobile Payment Cloud API.
\n","_postman_id":"949d599c-f0fd-4a6c-bcb5-313958b4cb43"},{"name":"Corporates","item":[{"name":"Create customer","event":[{"listen":"prerequest","script":{"exec":["var uuid = require(\"uuid\")\r","pm.collectionVariables.set('lastCorporateCustRef', uuid.v4());"],"type":"text/javascript","packages":{},"requests":{},"id":"8ca35818-9d47-4c7e-8261-2e29589599be"}}],"id":"5d09b449-f1a0-41eb-a752-bbfd5c0f57d3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"7faf55a6-3305-4fec-b7a7-9bdb9063afd8\",\r\n \"riskLevel\": \"low\",\r\n \"companyName\": \"Reilly and Sons\",\r\n \"businessActivity\": \"Nihil odit vero officia vel libero voluptatem.\",\r\n \"companyCode\": \"192\",\r\n \"leiCode\": \"L3I9ZG2KFGXZ61BMYR72\",\r\n \"registrationAddress\": {\r\n \"countryCode\": \"LT\",\r\n \"townName\": \"Arlington\",\r\n \"street\": \"McCullough Ports\",\r\n \"buildingNumber\": \"943\",\r\n \"postCode\": \"LT-266\",\r\n \"department\": \"Home\",\r\n \"subdepartment\": \"Electronics\",\r\n \"buildingName\": \"Wyman, Rath and Prosacco Business Center\",\r\n \"floor\": \"187\",\r\n \"postBox\": \"PO Box 240\",\r\n \"room\": \"340\",\r\n \"townLocationName\": \"Tess Extension\",\r\n \"districtName\": \"Lake Anabelle district\",\r\n \"countrySubdivision\": \"Fritschburgh county\",\r\n \"line\": \"027 Kozey Lights, Pearl City\"\r\n },\r\n \"postalAddress\": {\r\n \"countryCode\": \"LV\",\r\n \"townName\": \"Lake Wandaside\",\r\n \"street\": \"Tyrique Circle\",\r\n \"buildingNumber\": \"318\",\r\n \"postCode\": \"LV-722\",\r\n \"department\": \"Industrial\",\r\n \"subdepartment\": \"Baby\",\r\n \"buildingName\": \"Cummings - Borer Business Center\",\r\n \"floor\": \"736\",\r\n \"postBox\": \"PO Box 149\",\r\n \"room\": \"587\",\r\n \"townLocationName\": \"Parisian Passage\",\r\n \"districtName\": \"Arnoldmouth district\",\r\n \"countrySubdivision\": \"Costa Mesa county\",\r\n \"line\": \"1156 Trisha Islands, Encinitas\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/customers/corporate","description":"Creates a new corporate customer (legal person).
\nRequest body
\nAddressObject
\nStructured address together with unstructured address line.
\ncountryCode and the unstructured address line line are mandatory and must always be provided together with the structured address fields. townName is mandatory from the agreed date. All other fields are optional and may be null.
Updates the structured addresses of an existing corporate customer.
\nThe customer is identified by the reference that was used when the customer was created using POST /customers/corporate service.
Request body
\nAddressObject
\nStructured address together with unstructured address line.
\ncountryCode and the unstructured address line line are mandatory and must always be provided together with the structured address fields. townName is mandatory from the agreed date. All other fields are optional and may be null.
Response body
\nThe value of data JSON key is null. Check status.isSuccess for the result.
Here you can find descriptions and examples how to create corporate customer (legal person) using Contomobile Payment Cloud API.
\n","_postman_id":"caa8abe6-6a91-47b6-a787-3e5bbde7eb1a"}],"id":"269641ba-65be-4898-8189-d3ba95165a9a","description":"Here you can find descriptions and examples how to create customers using Contomobile Payment Cloud API.
\n","_postman_id":"269641ba-65be-4898-8189-d3ba95165a9a"},{"name":"Payments","item":[{"name":"Create new transfer","event":[{"listen":"prerequest","script":{"exec":["var uuid = require(\"uuid\")\r","const myUUID = uuid.v4();\r","\r","pm.collectionVariables.set('uid', myUUID.replace(/\\-/g, ''));"],"type":"text/javascript","packages":{},"requests":{},"id":"b88962fa-6b46-4cab-aed8-0f45f1f402f4"}}],"id":"936aba0c-2df2-4613-a02a-1a6f39f6788b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"paymentData\": {\r\n \"reference\": \"6c69bc50fb29401585c46bf9243932f6\",\r\n \"subAccountNumber\": \"LT254010000100507648\",\r\n \"amount\": 5.64,\r\n \"details\": \"Quidem consequatur earum.\",\r\n \"endToEndId\": \"692556\",\r\n \"beneficiary\": {\r\n \"name\": \"Sherri Bergstrom\",\r\n \"accountNumber\": \"DE68500105178297336485\",\r\n \"corporate\": {\r\n \"identificationType\": \"BICOrBEI\",\r\n \"identificationValue\": \"EZZESBZ1\"\r\n },\r\n \"postalAddress\": {\r\n \"countryCode\": \"TF\",\r\n \"townName\": \"Alexandromouth\",\r\n \"street\": \"Bauch Well\",\r\n \"buildingNumber\": \"756\",\r\n \"postCode\": \"LT-364\",\r\n \"department\": \"Jewelery\",\r\n \"subdepartment\": \"Outdoors\",\r\n \"buildingName\": \"Ledner - Wuckert Business Center\",\r\n \"floor\": \"717\",\r\n \"postBox\": \"PO Box 289\",\r\n \"room\": \"540\",\r\n \"townLocationName\": \"Joshua Camp\",\r\n \"districtName\": \"Gorczanyside district\",\r\n \"countrySubdivision\": \"West Noahfort county\",\r\n \"line\": \"269 Ferry Square, Lake Ridge\"\r\n }\r\n },\r\n \"payer\": {\r\n \"name\": \"Bartoletti and Sons\",\r\n \"corporate\": {\r\n \"identificationType\": \"BICOrBEI\",\r\n \"identificationValue\": \"ZNQOIMV1\"\r\n },\r\n \"postalAddress\": {\r\n \"countryCode\": \"GQ\",\r\n \"townName\": \"Maehaven\",\r\n \"street\": \"Maximillia Camp\",\r\n \"buildingNumber\": \"280\",\r\n \"postCode\": \"LT-67\",\r\n \"department\": \"Automotive\",\r\n \"subdepartment\": \"Toys\",\r\n \"buildingName\": \"Brown LLC Business Center\",\r\n \"floor\": \"39\",\r\n \"postBox\": \"PO Box 552\",\r\n \"room\": \"780\",\r\n \"townLocationName\": \"Desiree Trace\",\r\n \"districtName\": \"Gusikowskimouth district\",\r\n \"countrySubdivision\": \"East Marisa county\",\r\n \"line\": \"95458 Monica Lakes, Kutchhaven\"\r\n }\r\n },\r\n \"ultimatePayer\": {\r\n \"name\": \"Moore Group\",\r\n \"corporate\": {\r\n \"identificationType\": \"CUST\",\r\n \"identificationValue\": \"738258\"\r\n }\r\n },\r\n \"ultimateBeneficiary\": {\r\n \"name\": \"Padberg, Kautzer and Bednar\",\r\n \"individual\": {\r\n \"identificationType\": \"NIDN\",\r\n \"identificationValue\": \"695311\"\r\n }\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/payments/transfer","description":"Creates a new transfer. Currently only SEPA transfer is available.
\nRequest body
\nPaymentDataObject
\nStructuredDetailsObject
\nPayerObject
\nBeneficiaryObject
\nUltimatePayerObject
\nUltimateBeneficiaryObject
\nIndividualObject
\nCorporateObject
\nPostalAddressObject
\nStructured address together with unstructured address line.
\ncountryCode and the unstructured address line line are mandatory and must always be provided together with the structured address fields. townName is mandatory from the agreed date. All other fields are optional and may be null.
Returns payment transfer details by reference.
\nResponse body
\n","urlObject":{"path":["payments","transfer"],"host":["{{baseUrl}}"],"query":[{"description":{"content":"Your reference that was used when creating the payment transfer
\n","type":"text/plain"},"key":"reference","value":"6f662549d8c741ee80f24550d8e2e98f"}],"variable":[]}},"response":[{"id":"b5cad368-3810-47da-9bdf-eee4ad76a149","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/payments/transfer?reference=6f662549d8c741ee80f24550d8e2e98f","host":["{{baseUrl}}"],"path":["payments","transfer"],"query":[{"key":"reference","value":"6f662549d8c741ee80f24550d8e2e98f"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"paymentData\": {\r\n \"reference\": \"6f662549d8c741ee80f24550d8e2e98f\",\r\n \"subAccountNumber\": \"LT824010000100579566\",\r\n \"payer\": {\r\n \"name\": \"Vytas Vytaitis\",\r\n \"individual\": null,\r\n \"corporate\": null,\r\n \"postalAddress\": {\r\n \"townName\": \"Kowno\",\r\n \"countryCode\": \"LT\",\r\n \"department\": null,\r\n \"subdepartment\": null,\r\n \"street\": null,\r\n \"buildingNumber\": null,\r\n \"buildingName\": null,\r\n \"floor\": null,\r\n \"postBox\": null,\r\n \"room\": null,\r\n \"postCode\": null,\r\n \"townLocationName\": null,\r\n \"districtName\": null,\r\n \"countrySubdivision\": null,\r\n \"line\": \"Laisves al. 53, Kowno\"\r\n }\r\n },\r\n \"beneficiary\": {\r\n \"name\": \"Joel Bogan MD\",\r\n \"individual\": null,\r\n \"corporate\": null,\r\n \"accountNumber\": \"DE68500105178297336485\",\r\n \"postalAddress\": {\r\n \"townName\": \"Wilno\",\r\n \"countryCode\": \"LT\",\r\n \"department\": null,\r\n \"subdepartment\": null,\r\n \"street\": null,\r\n \"buildingNumber\": null,\r\n \"buildingName\": null,\r\n \"floor\": null,\r\n \"postBox\": null,\r\n \"room\": null,\r\n \"postCode\": null,\r\n \"townLocationName\": null,\r\n \"districtName\": null,\r\n \"countrySubdivision\": null,\r\n \"line\": \"Gedimino pr. 9, Wilno\"\r\n }\r\n },\r\n \"amount\": 5.64,\r\n \"details\": \"Ratione incidunt velit recusandae cumque ipsa quod.\",\r\n \"structuredDetails\": null,\r\n \"ultimatePayer\": null,\r\n \"ultimateBeneficiary\": null,\r\n \"endToEndId\": null\r\n },\r\n \"createdAt\": \"2026-09-10T13:19:24.029574+03:00\"\r\n },\r\n \"status\": {\r\n \"correlationId\": \"WEBAPI-32852e69-998d-4262-b5bc-bead49c39bec\",\r\n \"isSuccess\": true,\r\n \"statusCode\": 200,\r\n \"messages\": []\r\n }\r\n}"}],"_postman_id":"40f3ee1c-9f3a-4f8c-ac97-0dca7b1f30ce"},{"name":"Get identification types","id":"4fcbd35a-9392-4785-9dee-2cafcb883178","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseUrl}}/payments/party-identification-types","description":"Returns a list of available identification types of payer/beneficiary/ultimate payer/ultimate beneficiary.
\nResponse body
\nIdentificationTypeObject
\n","urlObject":{"path":["payments","party-identification-types"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"7d39b855-d376-426d-b409-84fedbcf0885","name":"Get identification types","originalRequest":{"method":"GET","header":[],"url":"{{baseUrl}}/payments/party-identification-types"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"individual\": [\r\n {\r\n \"identificationType\": \"DtAndPlcOfBirth\",\r\n \"description\": \"Date and place of birth\"\r\n },\r\n {\r\n \"identificationType\": \"ARNU\",\r\n \"description\": \"Alien registration number\"\r\n },\r\n {\r\n \"identificationType\": \"CCPT\",\r\n \"description\": \"Passport number\"\r\n },\r\n {\r\n \"identificationType\": \"CUST\",\r\n \"description\": \"Customer identification number\"\r\n },\r\n {\r\n \"identificationType\": \"DRLC\",\r\n \"description\": \"Drivers license number\"\r\n },\r\n {\r\n \"identificationType\": \"EMPL\",\r\n \"description\": \"Employer identification number\"\r\n },\r\n {\r\n \"identificationType\": \"NIDN\",\r\n \"description\": \"National identity number\"\r\n },\r\n {\r\n \"identificationType\": \"SOSE\",\r\n \"description\": \"Social security number\"\r\n },\r\n {\r\n \"identificationType\": \"TXID\",\r\n \"description\": \"Tax identification number\"\r\n },\r\n {\r\n \"identificationType\": \"Residence permit\",\r\n \"description\": \"Residence permit\"\r\n }\r\n ],\r\n \"corporate\": [\r\n {\r\n \"identificationType\": \"BICOrBEI\",\r\n \"description\": \"BIC code\"\r\n },\r\n {\r\n \"identificationType\": \"LEI\",\r\n \"description\": \"LEI code\"\r\n },\r\n {\r\n \"identificationType\": \"BANK\",\r\n \"description\": \"Bank\"\r\n },\r\n {\r\n \"identificationType\": \"CUST\",\r\n \"description\": \"Customer identification number\"\r\n },\r\n {\r\n \"identificationType\": \"DUNS\",\r\n \"description\": \"DUNS code\"\r\n },\r\n {\r\n \"identificationType\": \"EMPL\",\r\n \"description\": \"Employer identification number\"\r\n },\r\n {\r\n \"identificationType\": \"GS1G\",\r\n \"description\": \"GS1 location number\"\r\n },\r\n {\r\n \"identificationType\": \"TXID\",\r\n \"description\": \"Tax identification number\"\r\n },\r\n {\r\n \"identificationType\": \"COID\",\r\n \"description\": \"Business registration number\"\r\n }\r\n ]\r\n },\r\n \"status\": {\r\n \"correlationId\": \"WEBAPI-4a7101e4-f384-4a38-9eb1-62dae0a4e6a6\",\r\n \"isSuccess\": true,\r\n \"statusCode\": 200,\r\n \"messages\": []\r\n }\r\n}"}],"_postman_id":"4fcbd35a-9392-4785-9dee-2cafcb883178"},{"name":"Get structured details types","id":"816fb387-5595-45ee-93b8-cf8fc42bd5da","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseUrl}}/payments/structure-details-types","description":"Returns types of structured details of the payment for the SEPA payment
\nResponse body
\nDetailsTypeObject
\n","urlObject":{"path":["payments","structure-details-types"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"fb78d87e-9a4d-4a57-8fab-62ed6fdb8680","name":"Get structured details types","originalRequest":{"method":"GET","header":[],"url":"{{baseUrl}}/payments/structure-details-types"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"types\": [\r\n {\r\n \"type\": \"SCOR\",\r\n \"name\": \"Payment code\"\r\n }\r\n ]\r\n },\r\n \"status\": {\r\n \"correlationId\": \"WEBAPI-ea66b15e-7a71-4819-b3f6-8c3b4f602cbe\",\r\n \"isSuccess\": true,\r\n \"statusCode\": 200,\r\n \"messages\": []\r\n }\r\n}"}],"_postman_id":"816fb387-5595-45ee-93b8-cf8fc42bd5da"},{"name":"Cancel transfer","id":"35d8ccae-33b3-4140-868c-b46c44b71c0e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"2c0bcc4377514410b9d1db93d09f6a45\",\r\n \"reason\": {\r\n \"code\": \"DUPL\",\r\n \"additionalInformation\": \"Duplicated\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/payments/transfer-cancel","description":"This service should be used for payment cancellation.
\nRequest body
\n","urlObject":{"path":["payments","transfer-cancel"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"d41b5a89-d4c6-4364-8033-26bb013ba3f2","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"2c0bcc4377514410b9d1db93d09f6a45\",\r\n \"reason\": {\r\n \"code\": \"DUPL\",\r\n \"additionalInformation\": \"Duplicated\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/payments/transfer-cancel"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": null,\r\n \"status\": {\r\n \"correlationId\": \"WEBAPI-af2ef4fe-5207-444e-9458-aed978abf326\",\r\n \"isSuccess\": true,\r\n \"statusCode\": 200,\r\n \"messages\": []\r\n }\r\n}"},{"id":"577e20e7-fcec-4319-85a9-c9d336bcf3dd","name":"Required field is empty","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"\",\r\n \"reason\": {\r\n \"code\": \"DUPL\",\r\n \"additionalInformation\": \"Duplicated\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/payments/transfer-cancel"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"35d8ccae-33b3-4140-868c-b46c44b71c0e"}],"id":"1e171f7e-8c66-4bed-9b22-5f6b77fcea9e","description":"Here you can find descriptions and examples how to create transfers using Contomobile Payment Cloud API.
\n","_postman_id":"1e171f7e-8c66-4bed-9b22-5f6b77fcea9e"},{"name":"Sub-accounts","item":[{"name":"Create new sub-account","id":"9578ed87-54cf-4e86-9e4a-accf311d1a72","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"currency\": \"EUR\",\r\n \"individualReference\": \"12345\",\r\n \"corporateReference\": null\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/accounts/sub-account-currency","description":"Creates a new sub-account.
\nThe system limits the number of sub-accounts that you can create; by default the limit is 1000, but you can increase the limit by contacting support.
\nRequest body
\nResponse body
\n","urlObject":{"path":["accounts","sub-account-currency"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"847b8757-10a7-493d-996f-661c3ee71bc4","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"currency\": \"EUR\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://payment-cloud-cnt2.contomobiledev.com/accounts/sub-account-currency"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"subAccountId\": 357180,\n \"subAccountNumber\": \"LT873540023820279532\",\n \"subAccountCurrency\": \"EUR\"\n },\n \"status\": {\n \"correlationId\": \"WEBAPI-b30ed06c-1da4-4d05-8c08-9402d9b9910c\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"},{"id":"cbf3e586-7faa-4526-a7ea-b8277320e177","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"currency\": \"EUR\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://payment-cloud-cnt2.contomobiledev.com/accounts/sub-account-currency"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"AUTH-1c0985b8-fb81-4707-a3dd-081bd017d0dd\",\n \"isSuccess\": false,\n \"statusCode\": 401,\n \"messages\": [\n {\n \"code\": null,\n \"priority\": \"ERROR\",\n \"title\": \"Unauthorized.\",\n \"description\": null,\n \"field\": null\n }\n ]\n }\n}"},{"id":"79456fd4-c56f-4e28-ac70-287d446abcaa","name":"Create new sub-account related with individual","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"currency\": \"EUR\",\r\n \"individualReference\":\"170\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/accounts/sub-account-currency"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"subAccountId\": 100008428845,\r\n \"subAccountNumber\": \"LT764010000100567646\",\r\n \"subAccountCurrency\": \"EUR\"\r\n },\r\n \"status\": {\r\n \"correlationId\": \"WEBAPI-68a6dd5c-7540-4b33-a0ab-a97d5280acb4\",\r\n \"isSuccess\": true,\r\n \"statusCode\": 200,\r\n \"messages\": []\r\n }\r\n}"},{"id":"372cf625-2df8-404c-9241-26d1498b7bad","name":"Create new sub-account related with corporate","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"currency\": \"EUR\",\r\n \"corporateReference\":\"844\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/accounts/sub-account-currency"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"subAccountId\": 100008428845,\r\n \"subAccountNumber\": \"LT764010000100567646\",\r\n \"subAccountCurrency\": \"EUR\"\r\n },\r\n \"status\": {\r\n \"correlationId\": \"WEBAPI-68a6dd5c-7540-4b33-a0ab-a97d5280acb4\",\r\n \"isSuccess\": true,\r\n \"statusCode\": 200,\r\n \"messages\": []\r\n }\r\n}"}],"_postman_id":"9578ed87-54cf-4e86-9e4a-accf311d1a72"},{"name":"Get list of sub-accounts","id":"4524e192-f00e-4352-b152-d2aa9d82c23e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseUrl}}/accounts/sub-accounts?page=1&page_size=100&turnover_date=2026-01-01","description":"Returns a list of sub-accounts.
\nResponse body
\n","urlObject":{"path":["accounts","sub-accounts"],"host":["{{baseUrl}}"],"query":[{"description":{"content":"Page number of returning sub-account list
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Number of sub-accounts in one page
\n","type":"text/plain"},"key":"page_size","value":"100"},{"description":{"content":"Filters the results to sub-accounts that had turnover on the specified date.
\n","type":"text/plain"},"key":"turnover_date","value":"2026-01-01"}],"variable":[]}},"response":[{"id":"c5cb8cc3-f979-4a05-bcf6-b6ad3ea40e85","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/accounts/sub-accounts?page=1&page_size=100","host":["{{baseUrl}}"],"path":["accounts","sub-accounts"],"query":[{"key":"page","value":"1","description":"Page number of returning sub-account list"},{"key":"page_size","value":"100","description":"Number of sub-accounts in one page"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 29 Apr 2026 07:55:09 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"519"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"subAccounts\": [\n {\n \"subAccountId\": 358458,\n \"subAccountNumber\": \"LT683540023820344573\",\n \"subAccountCurrency\": \"EUR\",\n \"state\": \"active\",\n \"balance\": 0.17,\n \"individualReference\": null,\n \"corporateReference\": \"COR-0000-0000-0003\"\n },\n {\n \"subAccountId\": 358483,\n \"subAccountNumber\": \"LT223540023820713904\",\n \"subAccountCurrency\": \"EUR\",\n \"state\": \"active\",\n \"balance\": 0,\n \"individualReference\": \"12345\",\n \"corporateReference\": null\n }\n ]\n },\n \"status\": {\n \"correlationId\": \"WEBAPI-560b7afe-4f86-485a-ab81-450b3e30e340\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"}],"_postman_id":"4524e192-f00e-4352-b152-d2aa9d82c23e"},{"name":"Get sub-account","id":"19dbd4ae-ea12-470f-b649-e9b98d1f62cd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseUrl}}/accounts/sub-account?sub_account_id=100008449677","description":"Returns sub-accounts info by id.
\nResponse body
\n","urlObject":{"path":["accounts","sub-account"],"host":["{{baseUrl}}"],"query":[{"description":{"content":"Sub-account id
\n","type":"text/plain"},"key":"sub_account_id","value":"100008449677"}],"variable":[]}},"response":[{"id":"a0273b38-cd2d-4be2-9d0e-05e73da4cfc9","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/accounts/sub-account?sub_account_id=100008449677","host":["{{baseUrl}}"],"path":["accounts","sub-account"],"query":[{"key":"sub_account_id","value":"100008449677","description":"Sub-account id"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"subAccountNumber\": \"LT644010000100509565\",\r\n \"subAccountCurrency\": \"EUR\",\r\n \"state\": \"active\",\r\n \"balance\": 0,\r\n \"individualReference\": null,\r\n \"corporateReference\": null\r\n },\r\n \"status\": {\r\n \"correlationId\": \"WEBAPI-0c507871-4517-4cf3-8f46-2e1ab957e8a9\",\r\n \"isSuccess\": true,\r\n \"statusCode\": 200,\r\n \"messages\": []\r\n }\r\n}"}],"_postman_id":"19dbd4ae-ea12-470f-b649-e9b98d1f62cd"},{"name":"Disable sub-account","id":"bc039e19-c171-47f8-8e99-b460d10cc320","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"subAccountId\": \"357171\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/accounts/sub-account-disabled","description":"Should be used to disable sub-account.
\nAfter you disabled a sub-account you will not be able to:
\nmake a transfers on behalf of this sub-account;
\naccept incoming transfers to this sub-account.
\nThe undo service is currently unavailable so if you want to enable a disabled account, please contact support.
\nRequest body
\n","urlObject":{"path":["accounts","sub-account-disabled"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"ca891744-d319-4e42-978d-13752c17e85f","name":"Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"subAccountId\": \"357171\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/accounts/sub-account-disabled"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": null,\r\n \"status\": {\r\n \"correlationId\": \"WEBAPI-2b8d0d0e-630d-4610-8bcf-3fe903b08483\",\r\n \"isSuccess\": true,\r\n \"statusCode\": 200,\r\n \"messages\": []\r\n }\r\n}"},{"id":"52b6c62e-69e1-49bc-8121-9f1989136094","name":"Disabled sub-account","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"subAccountId\": \"357171\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/accounts/sub-account-disabled"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"WEBAPI-593478ad-4022-4802-9c16-4e9383e2f0bc\",\n \"isSuccess\": false,\n \"statusCode\": 200,\n \"messages\": [\n {\n \"code\": \"SUBACCOUNT_NOT_ACTIVE\",\n \"priority\": \"ERROR\",\n \"title\": \"The sub-account with the id: 357171 is already disabled\",\n \"description\": null,\n \"field\": null\n }\n ]\n }\n}"}],"_postman_id":"bc039e19-c171-47f8-8e99-b460d10cc320"},{"name":"Transactions","id":"57f683eb-0c58-4b20-bc65-46e2d01c3155","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseUrl}}/accounts/transactions?sub_account_id=100008351331&date_from=2003-10-20&date_till=2003-11-20&page=3&page_size=10","description":"The service returns a list of in/out transactions matching the specified query parameters.
\ndata.transactionsFilters transactions by the specified sub-account ID
\n","type":"text/plain"},"key":"sub_account_id","value":"100008351331"},{"description":{"content":"The start date of the period. Transactions from this date are included.
\n","type":"text/plain"},"key":"date_from","value":"2003-10-20"},{"description":{"content":"The end date of the period. Transactions up to and including this date are included. The maximum period is 31 days (1 month)
\n","type":"text/plain"},"key":"date_till","value":"2003-11-20"},{"description":{"content":"The page number to return. Pages are numbered starting from 1.
\n","type":"text/plain"},"key":"page","value":"3"},{"description":{"content":"The maximum number of transactions to return per page.
\n","type":"text/plain"},"key":"page_size","value":"10"}],"variable":[]}},"response":[{"id":"58746980-ddf1-4a5a-b298-ed16d024079b","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/accounts/transactions?sub_account_id=100008351331&date_from=2003-10-20&date_till=2003-11-20&page=3&page_size=10","host":["{{baseUrl}}"],"path":["accounts","transactions"],"query":[{"key":"sub_account_id","value":"100008351331","description":"Filters transactions by the specified sub-account ID"},{"key":"date_from","value":"2003-10-20","description":"The start date of the period. Transactions from this date are included."},{"key":"date_till","value":"2003-11-20","description":"The end date of the period. Transactions up to and including this date are included. The maximum period is 31 days (1 month)"},{"key":"page","value":"3","description":"The page number to return. Pages are numbered starting from 1."},{"key":"page_size","value":"10","description":"The maximum number of transactions to return per page."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"transactions\": [\r\n {\r\n \"id\": 100038189176,\r\n \"amount\": 0.98,\r\n \"currency\": \"EUR\",\r\n \"direction\": \"OUT\",\r\n \"date\": \"2003-10-20T15:50:19\",\r\n \"secondPartyName\": \"Jon Doe\",\r\n \"secondPartyAccountNumber\": \"LV59RIKO0002030060536\",\r\n \"secondPartyVaultId\": null,\r\n \"secondPartySubAccountId\": null,\r\n \"paymentDetails\": null,\r\n \"structuredDetailsCode\": \"CD001\",\r\n \"transferReference\": \"000000000-000000000-061\",\r\n \"incomingPaymentId\": null\r\n }\r\n ]\r\n },\r\n \"status\": {\r\n \"correlationId\": \"WEBAPI-64a7ae03-5451-4b0d-897e-1edc4925031e\",\r\n \"isSuccess\": true,\r\n \"statusCode\": 200,\r\n \"messages\": []\r\n }\r\n}"}],"_postman_id":"57f683eb-0c58-4b20-bc65-46e2d01c3155"}],"id":"58b32038-5c4e-4a7e-83ef-5325435954b5","description":"Sub-accounts are individual IBAN numbers that are linked to the main account. Sub-accounts allows you to associate them with your clients so that:
\nyou can easier make a SEPA transfers on behalf of your client;
\nthe beneficiary of a transfer will see the IBAN of sub-account, not a main account;
\nyou can simplify the processing of your customers' incoming payments as they can use these IBANs as credentials to request a transfer.
\nYou will not need to monitor the balance of sub-accounts, but only the balance of the main account.
\nTo use sub-accounts contact Contomobile Payment Cloud support.
\n","_postman_id":"58b32038-5c4e-4a7e-83ef-5325435954b5"},{"name":"Vaults","item":[{"name":"Create new vault","id":"c6d10211-0e83-43ab-8491-8b54f729ab32","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"currency\": \"EUR\",\r\n \"reference\": \"project-192\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/vaults/vault","description":"Creates a new vault.
\nThe system limits the number of vaults that you can create; by default the limit is 1000, but you can increase the limit by contacting support.
\nRequest body
\nResponse body
\n","urlObject":{"path":["vaults","vault"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"cbd0e4bc-a8f0-4d98-b25a-a049046e15eb","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"currency\": \"EUR\",\r\n \"reference\": \"project-470\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/vaults/vault"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 08 Apr 2026 06:04:46 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"170"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"vaultId\": 358462,\n \"vaultCurrency\": \"EUR\"\n },\n \"status\": {\n \"correlationId\": \"WEBAPI-eb0d52f8-f062-4015-9543-528a6609361f\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"},{"id":"6f0a17e7-ff79-4ecc-a55d-55f601958494","name":"Unauthorized","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"currency\": \"EUR\",\r\n \"reference\": \"project-797\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/vaults/vault"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 08 Apr 2026 06:05:57 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"234"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"WEBAPI-d48506ac-9ad0-45d8-b1c6-275598ee337f\",\n \"isSuccess\": false,\n \"statusCode\": 401,\n \"messages\": [\n {\n \"code\": null,\n \"priority\": \"ERROR\",\n \"title\": \"Authentication required.\",\n \"description\": null,\n \"field\": null\n }\n ]\n }\n}"},{"id":"8ef4ee3e-a456-4cdf-8cdc-dc56e7607cbc","name":"Currency missing","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"project-255\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/vaults/vault"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 08 Apr 2026 06:07:10 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"251"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"WEBAPI-58f43944-5874-4a7e-b4f9-ecf0b3e2bbbf\",\n \"isSuccess\": false,\n \"statusCode\": 200,\n \"messages\": [\n {\n \"code\": \"FIELD_IS_MANDATORY\",\n \"priority\": \"ERROR\",\n \"title\": \"Field is mandatory.\",\n \"description\": null,\n \"field\": \"currency\"\n }\n ]\n }\n}"}],"_postman_id":"c6d10211-0e83-43ab-8491-8b54f729ab32"},{"name":"Get list of vaults","id":"f945940a-5780-422c-85f8-25ae4ad31893","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseUrl}}/vaults/list?page=1&page_size=100","description":"Returns a list of vaults.
\nResponse body
\n","urlObject":{"path":["vaults","list"],"host":["{{baseUrl}}"],"query":[{"description":{"content":"Page number of returning vault list
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Number of vaults in one page
\n","type":"text/plain"},"key":"page_size","value":"100"}],"variable":[]}},"response":[{"id":"6520d38f-c232-4581-9f55-9fb44d07bbe7","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/vaults/list?page=1&page_size=100","host":["{{baseUrl}}"],"path":["vaults","list"],"query":[{"key":"page","value":"1","description":"Page number of returning vault list"},{"key":"page_size","value":"100","description":"Number of vaults in one page"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 08 Apr 2026 06:07:23 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"627"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"vaults\": [\n {\n \"vaultId\": 358457,\n \"vaultCurrency\": \"EUR\",\n \"state\": \"disabled\",\n \"balance\": 0,\n \"reference\": \"Project-001\"\n },\n {\n \"vaultId\": 358460,\n \"vaultCurrency\": \"EUR\",\n \"state\": \"active\",\n \"balance\": 0.16,\n \"reference\": \"project-343\"\n },\n {\n \"vaultId\": 358461,\n \"vaultCurrency\": \"EUR\",\n \"state\": \"active\",\n \"balance\": 0,\n \"reference\": \"project-403\"\n },\n {\n \"vaultId\": 358462,\n \"vaultCurrency\": \"EUR\",\n \"state\": \"active\",\n \"balance\": 0,\n \"reference\": \"project-166\"\n },\n {\n \"vaultId\": 358463,\n \"vaultCurrency\": \"EUR\",\n \"state\": \"active\",\n \"balance\": 0,\n \"reference\": \"project-735\"\n }\n ]\n },\n \"status\": {\n \"correlationId\": \"WEBAPI-a22f8eba-273a-48d2-b05d-a01e53d542f2\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"}],"_postman_id":"f945940a-5780-422c-85f8-25ae4ad31893"},{"name":"Get vault","id":"154e3cfe-ec37-47e9-954e-32783f9adaba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseUrl}}/vaults/vault?vault_id=100008449900","description":"Returns vault info by id.
\nResponse body
\n","urlObject":{"path":["vaults","vault"],"host":["{{baseUrl}}"],"query":[{"description":{"content":"Vault id
\n","type":"text/plain"},"key":"vault_id","value":"100008449900"}],"variable":[]}},"response":[{"id":"82c39830-0de0-47eb-afc8-9ea0c53cf62f","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/vaults/vault?vault_id=100008449882","host":["{{baseUrl}}"],"path":["vaults","vault"],"query":[{"key":"vault_id","value":"100008449882","description":"Vault id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 08 Apr 2026 06:07:23 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"627"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"vaultCurrency\": \"EUR\",\n \"state\": \"active\",\n \"balance\": 1.64,\n \"reference\": \"Project-65432100\"\n },\n \"status\": {\n \"correlationId\": \"WEBAPI-ed54992f-4927-45c9-8cf1-a737d3e25c32\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"}],"_postman_id":"154e3cfe-ec37-47e9-954e-32783f9adaba"},{"name":"Disable vault","id":"f2c85845-d048-48e6-b413-ec7395340e0a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"vaultId\": 987654321\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/vaults/disabled","description":"Should be used to disable a vault.
\nAfter you disabled a vault you will not be able to:
\nmake a transfers on behalf of this vault;
\naccept incoming transfers to this vault.
\nThe vault can only be disabled if balance is 0. The undo service is currently unavailable so if you want to enable a disabled account, please contact support.
\nRequest body
\n","urlObject":{"path":["vaults","disabled"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"e1341d7e-e4cf-49b0-b1c5-4e34b0006a0d","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"vaultId\": 358462\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/vaults/disabled"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 08 Apr 2026 06:11:32 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"134"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"WEBAPI-22432380-0d7e-41c4-bec3-26b92b54f18f\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"},{"id":"adc79c4f-e549-442c-bb24-accbbfd1597e","name":"Vault not found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"vaultId\": 987654321\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/vaults/disabled"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 08 Apr 2026 06:11:46 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"238"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"WEBAPI-7c0c55c0-aa7a-4b89-9fc5-75a1d8d185ed\",\n \"isSuccess\": false,\n \"statusCode\": 200,\n \"messages\": [\n {\n \"code\": \"VAULT_NOT_FOUND\",\n \"priority\": \"ERROR\",\n \"title\": \"Vault not found\",\n \"description\": null,\n \"field\": null\n }\n ]\n }\n}"}],"_postman_id":"f2c85845-d048-48e6-b413-ec7395340e0a"},{"name":"Create new top-up transfer","id":"6dec44cf-929e-41f3-b7dd-3e7a47736984","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"top-up-transfer-881\",\r\n \"vaultId\": 358460,\r\n \"subAccountId\": 358458,\r\n \"amount\": 0.09,\r\n \"details\": \"Consectetur officiis ipsa qui quasi voluptatibus eum cum perferendis.\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/vaults/top-up","description":"Creates a new top-up transfer.
\nThis API service is used to create a new transfer where a sub-account is debited and a vault is credited, i.e. create payment to transfer funds from sub-account to vault.
\nRequest body
\n","urlObject":{"path":["vaults","top-up"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"5edc7f7a-1efb-4b95-a2a2-40e8dfb10377","name":"Success from Main Account","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"top-up-transfer-329\",\r\n \"vaultId\": 358460,\r\n \"subAccountId\": null,\r\n \"amount\": 0.09,\r\n \"details\": \"Delectus quis omnis id numquam quo magnam eius voluptate sint.\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/vaults/top-up"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 08 Apr 2026 06:16:07 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"134"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"WEBAPI-57779d7c-3ab8-4c3f-b30a-924f212ec885\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"},{"id":"cdf3d2a6-5e7b-44a1-8cb1-1475cb6f4e4d","name":"Success from Sub Account","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"top-up-transfer-848\",\r\n \"vaultId\": 358460,\r\n \"subAccountId\": 358458,\r\n \"amount\": 0.01,\r\n \"details\": \"Nemo id reprehenderit dolores pariatur laudantium deserunt qui officiis quam.\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/vaults/top-up"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 08 Apr 2026 06:16:17 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"134"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"WEBAPI-5e107ae9-07fc-4311-933b-74c52fe97d55\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"},{"id":"b01fc6cc-1d4f-4beb-8be7-938e5b849867","name":"Vault Id missing","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"top-up-transfer-467\",\r\n \"subAccountId\": null,\r\n \"amount\": 0.09,\r\n \"details\": \"Non quia cum molestiae quos iusto.\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/vaults/top-up"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 08 Apr 2026 06:16:27 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"250"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"WEBAPI-b840e718-6db2-424f-81bc-a4cf592d7cd4\",\n \"isSuccess\": false,\n \"statusCode\": 200,\n \"messages\": [\n {\n \"code\": \"FIELD_IS_MANDATORY\",\n \"priority\": \"ERROR\",\n \"title\": \"Field is mandatory.\",\n \"description\": null,\n \"field\": \"vaultId\"\n }\n ]\n }\n}"},{"id":"fac81d9e-c239-41b6-960a-693402208e7d","name":"Insufficient Funds","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"top-up-transfer-872\",\r\n \"vaultId\": 358460,\r\n \"subAccountId\": 358458,\r\n \"amount\": 19.09,\r\n \"details\": \"Reiciendis ut ea eveniet quaerat quibusdam fugit consequatur cupiditate.\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/vaults/top-up"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 08 Apr 2026 06:16:36 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"272"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"WEBAPI-bcff4b50-68ae-4006-a398-de99e90b4e13\",\n \"isSuccess\": false,\n \"statusCode\": 200,\n \"messages\": [\n {\n \"code\": \"INSUFFICIENT_FUNDS\",\n \"priority\": \"ERROR\",\n \"title\": \"Insufficient funds to complete the transaction\",\n \"description\": null,\n \"field\": null\n }\n ]\n }\n}"}],"_postman_id":"6dec44cf-929e-41f3-b7dd-3e7a47736984"},{"name":"Create new withdraw transfer","id":"24eb9cb9-11db-4067-82bd-8ae87a9c8612","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"withdraw-transfer-981\",\r\n \"vaultId\": 358460,\r\n \"subAccountId\": 358458,\r\n \"amount\": 0.07,\r\n \"details\": \"Ut aperiam ipsam quibusdam reiciendis ullam repellat odio eius dolore.\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/vaults/withdraw","description":"Creates a new withdraw transfer.
\nThis API service is used to create a new transfer where a vault is debited and a sub-account is credited, i.e. create payment to transfer funds from vault to sub-account.
\nRequest body
\n","urlObject":{"path":["vaults","withdraw"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"484d1b43-9605-4d58-9905-123dfa770d00","name":"Success to Main Account","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"withdraw-transfer-684\",\r\n \"vaultId\": 358460,\r\n \"subAccountId\": null,\r\n \"amount\": 0.07,\r\n \"details\": \"Doloribus libero laudantium.\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/vaults/withdraw"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 08 Apr 2026 06:17:07 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"134"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"WEBAPI-e9917253-f24a-4b9f-9c51-a5509832f78d\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"},{"id":"1be84b5c-fc8f-401e-85ea-25159be21331","name":"Success to Sub Account","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"reference\": \"withdraw-transfer-799\",\r\n \"vaultId\": 358460,\r\n \"subAccountId\": 358458,\r\n \"amount\": 0.07,\r\n \"details\": \"Accusamus natus saepe sed.\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl}}/vaults/withdraw"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 08 Apr 2026 06:17:17 GMT"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-XSS-Protection","value":"0"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Length","value":"134"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"WEBAPI-9dca7990-37ff-414e-ac84-b6a3ca20afb0\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"}],"_postman_id":"24eb9cb9-11db-4067-82bd-8ae87a9c8612"},{"name":"Transactions","id":"151f1f4e-bfab-4af5-91e7-ddbb20cbbf3d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseUrl}}/vaults/transactions?vault_id=100008449896&date_from=2003-10-20&date_till=2003-11-20&page=3&page_size=10","description":"The service returns a list of in/out transactions matching the specified query parameters.
\ndata.transactionsFilters transactions by the specified vault ID
\n","type":"text/plain"},"key":"vault_id","value":"100008449896"},{"description":{"content":"The start date of the period. Transactions from this date are included.
\n","type":"text/plain"},"key":"date_from","value":"2003-10-20"},{"description":{"content":"The end date of the period. Transactions up to and including this date are included. The maximum period is 31 days (1 month)
\n","type":"text/plain"},"key":"date_till","value":"2003-11-20"},{"description":{"content":"The page number to return. Pages are numbered starting from 1.
\n","type":"text/plain"},"key":"page","value":"3"},{"description":{"content":"The maximum number of transactions to return per page.
\n","type":"text/plain"},"key":"page_size","value":"10"}],"variable":[]}},"response":[{"id":"819b8d1d-5e13-4601-824a-5dbc1cff3b72","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/vaults/transactions?vault_id=100008449896&date_from=2003-10-20&date_till=2003-11-20&page=3&page_size=10","host":["{{baseUrl}}"],"path":["vaults","transactions"],"query":[{"key":"vault_id","value":"100008449896","description":"Filters transactions by the specified vault ID"},{"key":"date_from","value":"2003-10-20","description":"The start date of the period. Transactions from this date are included."},{"key":"date_till","value":"2003-11-20","description":"The end date of the period. Transactions up to and including this date are included. The maximum period is 31 days (1 month)"},{"key":"page","value":"3","description":"The page number to return. Pages are numbered starting from 1."},{"key":"page_size","value":"10","description":"The maximum number of transactions to return per page."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"transactions\": [\r\n {\r\n \"id\": 100038189176,\r\n \"amount\": 0.98,\r\n \"currency\": \"EUR\",\r\n \"direction\": \"OUT\",\r\n \"date\": \"2003-10-20T15:50:19\",\r\n \"secondPartyName\": \"Jon Doe\",\r\n \"secondPartyAccountNumber\": \"LV59RIKO0002030060536\",\r\n \"secondPartyVaultId\": null,\r\n \"secondPartySubAccountId\": null,\r\n \"paymentDetails\": null,\r\n \"structuredDetailsCode\": \"CD001\",\r\n \"transferReference\": \"000000000-000000000-061\",\r\n \"incomingPaymentId\": null\r\n }\r\n ]\r\n },\r\n \"status\": {\r\n \"correlationId\": \"WEBAPI-64a7ae03-5451-4b0d-897e-1edc4925031e\",\r\n \"isSuccess\": true,\r\n \"statusCode\": 200,\r\n \"messages\": []\r\n }\r\n}"}],"_postman_id":"151f1f4e-bfab-4af5-91e7-ddbb20cbbf3d"}],"id":"6665e548-d933-4c92-98ad-534a97f90716","description":"Vaults are individual non IBAN numbers that are linked to the main account. Contomobile Payment Cloud Vaults allow to accumulate and store funds, but it cannot be used to make or receive external payments, i.e. vault cannot be used to initiate or receive SEPA payments, and funds can only be moved to and from the vault to sub-accounts through dedicated API services.
\n","_postman_id":"6665e548-d933-4c92-98ad-534a97f90716"},{"name":"Webhooks management","item":[{"name":"List","id":"5f54fe77-04a0-486b-bdd0-a997f148c6d6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseUrl}}/webhooks/list?date_from=2026-09-01&date_till=2026-10-01&page=1&page_size=100&state=&search_string=","description":"Lists webhook messages using date-range, pagination, state, and payload-search filters. The maximum date range is 31 days.
\nResponse body
\n","urlObject":{"path":["webhooks","list"],"host":["{{baseUrl}}"],"query":[{"description":{"content":"Date from
\n","type":"text/plain"},"key":"date_from","value":"2026-09-01"},{"description":{"content":"Date till. The maximum period is 31 days (1 month)
\n","type":"text/plain"},"key":"date_till","value":"2026-10-01"},{"description":{"content":"Page number
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Page size
\n","type":"text/plain"},"key":"page_size","value":"100"},{"description":{"content":"State of the webhook message
\n","type":"text/plain"},"key":"state","value":""},{"description":{"content":"Search webhook message payload
\n","type":"text/plain"},"key":"search_string","value":""}],"variable":[]}},"response":[{"id":"953b22f0-daac-4a24-a213-27e3db24e744","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/webhooks/list?date_from=2026-09-01&date_till=2026-10-01&page=1&page_size=100&state=&search_string=","host":["{{baseUrl}}"],"path":["webhooks","list"],"query":[{"key":"date_from","value":"2026-09-01","description":"Date from"},{"key":"date_till","value":"2026-10-01","description":"Date till. The maximum period is 31 days (1 month)"},{"key":"page","value":"1","description":"Page number"},{"key":"page_size","value":"100","description":"Page size"},{"key":"state","value":"","description":"State of the webhook message"},{"key":"search_string","value":"","description":"Search webhook message payload"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"data\": {\n \"webhooks\": [\n {\n \"id\": \"5AC24E10D65F36BEE063A40010AC4276\",\n \"state\": \"REJECTED\",\n \"attempts\": 10,\n \"createdAt\": \"2026.09.05T22:22:25.243256+03:00\",\n \"message\": \"{\\\"msgId\\\":\\\"5AC24E10D65F36BEE063A40010AC4276\\\",\\\"createdAt\\\":\\\"2026-09-05T22:22:25.180506000+03:00\\\",\\\"type\\\":\\\"beneficiary_verification_status\\\",\\\"requestId\\\":\\\"e534767b-f563-4be9-b708-1b9276e46d95\\\",\\\"status\\\":\\\"MATCHED\\\",\\\"correctName\\\":null,\\\"errorCode\\\":null,\\\"errorDescription\\\":null}\"\n }\n ]\n },\n \"status\": {\n \"correlationId\": \"WEBAPI-19104c22-889f-4e10-a4b8-903f19ecc78a\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"}],"_postman_id":"5f54fe77-04a0-486b-bdd0-a997f148c6d6"},{"name":"Resend","id":"0b411dac-ad6a-4b59-ba24-5ae05f850c61","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"{{baseUrl}}/webhooks/resend?id=5B35EF53D09B3BE2E063A40010AC4122","description":"Retries delivery of the webhook by the webhook id. You cannot resend webhook that is in DELIVERING state.
Webhook id
\n","type":"text/plain"},"key":"id","value":"5B35EF53D09B3BE2E063A40010AC4122"}],"variable":[]}},"response":[{"id":"c8ccd4e1-1fc0-4eab-ba25-a2601b2e4700","name":"Success","originalRequest":{"method":"POST","header":[],"url":{"raw":"{{baseUrl}}/webhooks/resend?id=5B35EF53D09B3BE2E063A40010AC4122","host":["{{baseUrl}}"],"path":["webhooks","resend"],"query":[{"key":"id","value":"5B35EF53D09B3BE2E063A40010AC4122","description":"Webhook id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": {\n \"correlationId\": \"WEBAPI-a3b3a751-a867-41fe-9d36-480a5a84c50b\",\n \"isSuccess\": true,\n \"statusCode\": 200,\n \"messages\": []\n }\n}"}],"_postman_id":"0b411dac-ad6a-4b59-ba24-5ae05f850c61"}],"id":"50e65330-35ae-4edd-87f7-8c8f27f0c65c","_postman_id":"50e65330-35ae-4edd-87f7-8c8f27f0c65c","description":""}],"id":"f81d1b6c-fd15-4594-a2a6-91e818645a20","description":"The consumer of this API is your system, not a WEB application or something similar. You can use this API only after obtaining the X-Client-Id and X-Client-Secret. You must store these values ββsecurely.
Notification on the processing status of the initiated payment.
\nThe value of type JSON key is payment_status.
Request body
\n","urlObject":{"host":["{{webhookUrl}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"5b175c37-0164-4fea-9e56-6c5d88305486"},{"name":"Incoming payment notification","id":"b60a1fa1-2fcd-4b0d-96c9-c2b616e6db58","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"msgId\": \"325561e8-548c-4e77-b186-cc59d4e38bb4\",\r\n \"createdAt\": \"2026-11-14T01:50:07.297Z\",\r\n \"type\": \"incoming_payment\",\r\n \"id\": \"97364e9c-40e1-446f-afe1-68a9135081e9\",\r\n \"documentNumber\": \"100003699990\",\r\n \"amount\": 64.97,\r\n \"details\": \"Totam eveniet iure voluptas ipsa.\",\r\n \"payer\": {\r\n \"name\": \"Reichert - Leannon\",\r\n \"accountNumber\": \"DO56JNYG80565707008200602044\",\r\n \"corporate\": {\r\n \"identificationType\": \"BICOrBEI\",\r\n \"identificationValue\": \"FPJUGPN1\"\r\n },\r\n \"postalAddress\": {\r\n \"countryCode\": \"GB\",\r\n \"townName\": \"South Abner\",\r\n \"street\": \"Angelo Parkway\",\r\n \"buildingNumber\": \"830\",\r\n \"postCode\": \"LT-885\",\r\n \"department\": \"Games\",\r\n \"subdepartment\": \"Toys\",\r\n \"buildingName\": \"Jaskolski - Jacobi Business Center\",\r\n \"floor\": \"894\",\r\n \"postBox\": \"PO Box 819\",\r\n \"room\": \"931\",\r\n \"townLocationName\": \"Casper Creek\",\r\n \"districtName\": \"Port Magnus district\",\r\n \"countrySubdivision\": \"Weissnatchester county\",\r\n \"line\": \"060 Rigoberto Tunnel, Peytonbury\"\r\n }\r\n },\r\n \"beneficiary\": {\r\n \"name\": \"Jacquelyn Jakubowski\",\r\n \"accountNumber\": \"IT76S06661008225NA658RX1835\",\r\n \"corporate\": {\r\n \"identificationType\": \"BICOrBEI\",\r\n \"identificationValue\": \"XGZAWFB1965\"\r\n },\r\n \"postalAddress\": {\r\n \"countryCode\": \"SB\",\r\n \"townName\": \"Ramiroberg\",\r\n \"street\": \"Doug Crossroad\",\r\n \"buildingNumber\": \"735\",\r\n \"postCode\": \"LT-295\",\r\n \"department\": \"Electronics\",\r\n \"subdepartment\": \"Toys\",\r\n \"buildingName\": \"Lueilwitz - Trantow Business Center\",\r\n \"floor\": \"215\",\r\n \"postBox\": \"PO Box 264\",\r\n \"room\": \"288\",\r\n \"townLocationName\": \"King Stravenue\",\r\n \"districtName\": \"Port Abbeyton district\",\r\n \"countrySubdivision\": \"Jadaview county\",\r\n \"line\": \"516 Marquardt Neck, Fairfield\"\r\n }\r\n },\r\n \"ultimatePayer\": {\r\n \"name\": \"Wolff - Runolfsdottir\",\r\n \"corporate\": {\r\n \"identificationType\": \"CUST\",\r\n \"identificationValue\": \"495289\"\r\n }\r\n },\r\n \"ultimateBeneficiary\": {\r\n \"name\": \"Jacobi Inc\",\r\n \"individual\": {\r\n \"identificationType\": \"NIDN\",\r\n \"identificationValue\": \"878296\"\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{webhookUrl}}","description":"Notification about a deposit received from another bank into a sub-account or a main account of a contract.
\nThe value of type JSON key is incoming_payment.
Request body
\nStructuredDetailsObject
\nPayerObject
\nBeneficiaryObject
\nUltimatePayerObject
\nUltimateBeneficiaryObject
\nIndividualObject
\nCorporateObject
\nPostalAddressObject
\nStructured address together with unstructured address line.
\n","urlObject":{"host":["{{webhookUrl}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"b60a1fa1-2fcd-4b0d-96c9-c2b616e6db58"}],"id":"4998f9cb-77ed-4063-99d5-de8852e663ec","description":"The recipient of Webhooks is your system.
\nThere is a set of events that can trigger Webhooks on Contomobile Payment Cloud platform, for example:
\nthe status of outgoing payments was changed;
\nthe status of payment cancellation requests was changed;
\nan incoming payment has arrived.
\nWe send Webhooks to your endpoint using POST HTTP method.
Your system must to respond with HTTP status code 200 identifying that you accepted the request, otherwise Contomobile Payment Cloud platform will try to resend the Webhook after several seconds once again until you will respond with HTTP status code 200 or retry limit is reached.
Webhook payload is a JSON. Each payload will have these JSON keys:
\nBelow you can find the description of all Webhooks that we can send to your system.
\n","_postman_id":"4998f9cb-77ed-4063-99d5-de8852e663ec"}],"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["pm.request.headers.add({key:'X-Client-Id',value:pm.variables.get(\"Client-Id\")})\r\r","pm.request.headers.add({key:'X-Client-Secret',value:pm.variables.get(\"Client-Secret\")})\r","// ---- Address values limited to the specification lengths ----\r","// Examples use Postman dynamic variables ({{$random...}}), which cannot be length-limited.\r","// Before sending, every address object in the JSON body is resolved and each field\r","// is cut to its maximum length. Other body values stay untouched.\r","function limitAddressLengths() {\r"," const LIMITS = {\r"," countryCode: 2, line: 140, townName: 35,\r"," department: 70, subdepartment: 70, street: 70, buildingNumber: 16, buildingName: 35,\r"," floor: 70, postBox: 16, room: 70, postCode: 16,\r"," townLocationName: 35, districtName: 35, countrySubdivision: 35\r"," };\r"," const ADDRESS_OBJECTS = ['postalAddress', 'residenceAddress', 'registrationAddress'];\r"," const body = pm.request.body;\r"," if (!body || body.mode !== 'raw' || !body.raw) return;\r"," let json;\r"," try { json = JSON.parse(body.raw); } catch (e) { return; }\r"," let changed = false;\r"," const limitAddress = (addr) => {\r"," Object.keys(addr).forEach((key) => {\r"," if (typeof addr[key] !== 'string' || !LIMITS[key]) return;\r"," addr[key] = pm.variables.replaceIn(addr[key]).substring(0, LIMITS[key]).trim();\r"," changed = true;\r"," });\r"," };\r"," const walk = (node) => {\r"," if (!node || typeof node !== 'object') return;\r"," Object.keys(node).forEach((key) => {\r"," if (ADDRESS_OBJECTS.includes(key) && node[key] && typeof node[key] === 'object') limitAddress(node[key]);\r"," else walk(node[key]);\r"," });\r"," };\r"," walk(json);\r"," if (changed) pm.request.body.update(JSON.stringify(json, null, 4));\r","}\r","limitAddressLengths();"],"id":"91ad6c1d-66bb-4fd7-ab91-6dca0efb6591"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"6b5e2c14-21fa-46d6-be0f-1153cbeaa2e5"}}],"variable":[{"key":"uid","value":"6c69bc50fb29401585c46bf9243932f6"},{"key":"lastPrivateCustRef","value":"60c3080d-3db2-4380-9a9d-36bff78535a6"},{"key":"lastCorporateCustRef","value":"7faf55a6-3305-4fec-b7a7-9bdb9063afd8"}]}