> This page is for Enterprise. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://citi-demo.ferndocs.com/enterprise/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://citi-demo.ferndocs.com/enterprise/_mcp/server. # Activate Virtual Accounts PUT https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts Content-Type: application/json The virtual account creation is a 2-step process (using the reservation and activation services), you can use POST and PUT endpoints one after another. Use PUT verb for Activation action - The API support XML and JSON formats. - The reservation/activation functionality is identified based on the request payload (action). - You specify values for input parameters in the body of your XML/JSON document. - You encrypt the payload, place it in your request and send it with your application.\Content-Type: Supports application/xml and application/json. Authorization: The OAuth Token prefixed with Bearer and space in between. Allowed characters: A-Z, a-z, 0-9, Space Allowed punctuation marks: ' ( ) \* - , . / : ; \_ & \$ # @ \[ ] Reference: https://citi-demo.ferndocs.com/enterprise/enterprises/api-reference/account-services/receivable-services/virtual-accounts-wallet/virtual-account-activation ## Authentication - `Authorization` header (bearer token, required) — All CitiConnect APIs use the oAuth2 authentication scheme, which requires a bearer token to authenticate your API call. The Token URL includes the version of authentication used by this API. See the Citi Authentication API reference for information on requesting a token. ## Servers - `https://tts.sandbox.apib2b.citi.com/citiconnect/sb` (sandbox URL , default) - `https://b2b.tts.icgservices.citi.com/citiconnect/prod` (production gateway URL) ## Request ### Query parameters - `client_id` (string, required) — Unique reference shared during CitiConnect API onboarding (`client_id` used during OAuth token generation). ### Body (application/json) This endpoint expects a Virtual-Account-Activation-Request. - `action` (enum, required) — Action is a request type. - Choose the action value as ''ACTIVATION'', if you want to activate the virtual account which was reserved earlier. - Allowed values: `ACTIVATION` - `header_account` (Header-Account, optional) - `virtual_account` (Virtual-Account, optional) ## Response ### 202 Accepted - `request_id` (string, optional) — Auto-generated unique identification assigned for the request. - `status` (string, optional) — Status of the request. Possible statuses are SUCCESS REJECTED PENDING - `message` (string, optional) — Detailed response for the particular request. - `action` (string, optional) — Action of the given request. - ''RESERVATION'' - ''ACTIVATION''. - `branch_code` (string, optional) — Citi's bank code associated with given a header account number. - `error_details` (list of Error-Detail, optional) - `account` (list of Accounts, optional) ## Errors ### 400 Bad Request Error Bad Request - `ref_id` (string, optional) — Uniqiue reference ID for a particular request. - `error_details` (list of Error-Detail, optional) - `httpCode` (string, optional) - `httpMessage` (string, optional) - `moreInformation` (string, optional) - `status` (string, optional) - `message` (string, optional) ### 401 Unauthorized Error Unauthorized - `ref_id` (string, optional) — Uniqiue reference ID for a particular request. - `error_details` (list of Error-Detail, optional) - `httpCode` (string, optional) - `httpMessage` (string, optional) - `moreInformation` (string, optional) - `status` (string, optional) - `message` (string, optional) ### 403 Forbidden Error Forbidden - `ref_id` (string, optional) — Uniqiue reference ID for a particular request. - `error_details` (list of Error-Detail, optional) - `httpCode` (string, optional) - `httpMessage` (string, optional) - `moreInformation` (string, optional) - `status` (string, optional) - `message` (string, optional) ### 404 Not Found Error Not Found - `httpCode` (string, optional) — HTTP status code of this API. - `httpMessage` (string, optional) — Short message about the issue. - `moreInformation` (string, optional) — More information about the issue. ### 405 Method Not Allowed Error Method Not Allowed - `ref_id` (string, optional) — Uniqiue reference ID for a particular request. - `error_details` (list of Error-Detail, optional) - `httpCode` (string, optional) - `httpMessage` (string, optional) - `moreInformation` (string, optional) - `status` (string, optional) - `message` (string, optional) ### 415 Unsupported Media Type Error Unsupported Media Type - `ref_id` (string, optional) — Uniqiue reference ID for a particular request. - `error_details` (list of Error-Detail, optional) - `httpCode` (string, optional) - `httpMessage` (string, optional) - `moreInformation` (string, optional) - `status` (string, optional) - `message` (string, optional) ### 429 Too Many Requests Error Too Many Request - `status` (string, optional) — HTTP status code of this API response. - `message` (string, optional) — Short message about the issue. ### 500 Internal Server Error Internal Server Error - `ref_id` (string, optional) — Uniqiue reference ID for a particular request. - `error_details` (list of Error-Detail, optional) - `httpCode` (string, optional) - `httpMessage` (string, optional) - `moreInformation` (string, optional) - `status` (string, optional) - `message` (string, optional) ## Types ### Header-Account - `account` (string, optional) — Required parameter if the value of the `action` parameter is 'RESERVATION' (or) 'ACTIVATION' (or) 'UPDATE'. Specifies the header account number assigned during the account opening. - `branch_code` (string, optional) — Citi's bank code associated with given a header account number. ### Virtual-Account - `account` (string, optional) — Required parameter only if the value of the `action` parameter is 'ACTIVATION'.This parameter specifies the virtual account to be activated. - `purpose` (enum, optional) — Thsi parameter specifies the purpose for the creation of the virtual account. This is a required parameter for both the `action` parameters, 'RESERVATION' and 'ACTIVATION'. Allowed value is 'C'. - 'C' - Client's Customer - Allowed values: `C` - `balance_display_option` (enum, optional) — This parameter is only applicable if the value of the `action` parameter is set to 'ACTIVATION'. This parameter specifies whether to display opening or closing balances or not. Default value is 'Y'.Description of possible parameter values:\Y - Show virtual account opening and closing balances. \N - Show ZERO opening and closing balance for virtual account in statements and reports. - Allowed values: `Y`, `N` - `entity` (Entity, optional) — Required parameter only if the value of `action` is set to 'ACTIVATION'. - `beneficial_owner` (list of Beneficial-Owner, optional) — This parameter is only applicable if the value of the `action` parameter is set to 'ACTIVATION' and the relevant purpose parameter is ENUMS. Required parameter if the `entity.id` parameter is not used. - Not applicable for sole trader (`entity.type`='S') ### Error-Detail - `code` (string, optional) — Unique ID for the error code. Under GET method and callbacks, this parameter is a non-retrievable internal error code:CC00013. - `issue` (string, optional) — More details about the issue. - `action` (string, optional) — Corrective action to be taken to resolve above issue. ### Accounts - `virtual_account` (string, optional) — Required parameter only if the value of the `action` parameter is set to 'ACTIVATION'.This parameter specifies the virtual account to be activated. - `entity_id` (string, optional) — ID that was assigned specific to the entity being activated under this virtual account. ### Entity Required parameter only if the value of `action` is set to 'ACTIVATION'. - `country_of_operation` (string, required) — Enter the 'Country code' under which the entity is operated. Required parameter for both `entity.id` (or) entity details combination. - `first_name` (string, optional) — First name of entity linked to a virtual account. Required parameter if the `entity` object is used. - Required parameter when sole trader (`entity.type`='S') is present - Not applicable for company (`entity.type`='C'). * For 'US' `virtual_account.entity.first_name` and `virtual_account.entity.last_name` parameters combined total length including spaces cannot exceed 34 characters. - `last_name` (string, optional) — Last name of the entity linked to a virtual account. Required parameter if the `entity` object is used. - For sole trader (`entity.type`='S') - include the last name - For company (`entity.type`='C') - include the legal entity name. * For 'US' `virtual_account.entity.first_name` and `virtual_account.entity.last_name` parameters combined total length including spaces cannot exceed 34 characters. - `id` (string, optional) — For activation, either the `entity.id` (or) rest of the entity details under the entity object are required. - `type` (enum, optional) — Required parameter under the `entity` object if the `id` parameter is not used. Populate the entity type applicable for the entity being activated under this virtual account. C = COMPANY S = SOLE TRADER - enterprise owned and run by one person and in which there is no legal distinction between the owner and the business entity - Allowed values: `C`, `S` - `date_of_birth` (string, optional) — Required parameter under the `entity` object if the `id` parameter is not used. Populates the date of birth or incorporation date pertaining to the entity that is being activated under this virtual account. It is in a fixed 10-digit format (YYYY-MM-DD) as per ISO standard. - `website` (string, optional) — Enter the website of entity being activated under this virtual account. - `store_name` (string, optional) — Enter the store name of the entity being activated under this virtual account. Optional parameter, should not be considered as the entity name. - `business_purpose` (string, optional) — Populate the business purpose applicable for the entity being activated under this virtual account. - `acronym` (string, optional) — Populate the acronym for the entity being activated under this virtual account. - `org_prvt_identification` (Organisation-Private-Identification, optional) — Required parameter if the `entity.id` parameter is not used. - `address` (Address, optional) — \ Address object is required if the `entity` object is used. \ * For 'US', the combined total length for the entity address, including spaces, cannot exceed 100 characters. This restriction is not applicable for beneficial owner. ### Beneficial-Owner - `date_of_birth` (string, required) — Required parameter in the `Beneficial Owner` object if the object is used. Populates the date of birth date pertaining to the Beneficial owner of the entity. It is in a fixed 10-digit format (YYYY-MM-DD) as per the ISO standard. - `first_name` (string, optional) — First name of the entity's beneficial owner. Required parameter if the `virtual_account.beneficial_owner` object is not used. - `last_name` (string, optional) — Last name of the entity's beneficial owner. Required parameter if the `virtual_account.beneficial_owner` object is not used. - `address` (Address, optional) — \ Address object is required if the `entity` object is used. \ * For 'US', the combined total length for the entity address, including spaces, cannot exceed 100 characters. This restriction is not applicable for beneficial owner. ### Organisation-Private-Identification Required parameter if the `entity.id` parameter is not used. - `type` (enum, required) — Type of the identification that is provided in this object. Type maximum length can be up to 200 characters. - 'TAX_ID' Tax Identification - Allowed values: `TAX_ID` - `id` (string, required) — Identification pertaining to the entity which is used for the virtual account activation. - `country_of_issuance` (string, required) — Country code where the provided identification has been issued. ### Address \ Address object is required if the `entity` object is used. \ * For 'US', the combined total length for the entity address, including spaces, cannot exceed 100 characters. This restriction is not applicable for beneficial owner. - `street_name` (string, required) — Address details of the entity (or) the beneficial owner of the virtual account. Required parameter in the `Address` object. - `building_number` (string, required) — Address details of the entity (or) the beneficial owner of the virtual account. - If building number is not present then provide the `virtual_account.entity.building_number` as N/A. - `postal_code` (string, required) — Address details of the entity (or) the beneficial owner of virtual account. Required parameter in the `Address` object. - `town_name` (string, required) — Address details of the entity (or) the beneficial owner of the virtual account. Required parameter in the `Address` object. - `country_sub_division` (string, required) — Address details of the entity (or) the beneficial owner of the virtual account. Required parameter in the `Address` object. - `country` (string, required) — Address details of the entity (or) the beneficial owner of the virtual account. Required parameter in the `Address` object. ## Examples ### VAActivationEntityIdExample (application/json) **Request** ```json { "action": "ACTIVATION", "header_account": { "account": "0011224455", "branch_code": "930" }, "virtual_account": { "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": { "country_of_operation": "CA", "id": "EN_45678901234567890" } } } ``` **Response** ```json { "request_id": "29b9c9d7-d4d9-48ce-8823-f9b3ee276b8f", "status": "ACCEPTED", "message": "Request accepted Successfully" } ``` **SDK Code** ```python VAActivationEntityIdExample (application/json) import requests url = "https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts" payload = { "action": "ACTIVATION", "header_account": { "account": "0011224455", "branch_code": "930" }, "virtual_account": { "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": { "country_of_operation": "CA", "id": "EN_45678901234567890" } } } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.put(url, json=payload, headers=headers) print(response.json()) ``` ```javascript VAActivationEntityIdExample (application/json) const url = 'https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts'; const options = { method: 'PUT', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"action":"ACTIVATION","header_account":{"account":"0011224455","branch_code":"930"},"virtual_account":{"account":"0123456789","purpose":"C","balance_display_option":"Y","entity":{"country_of_operation":"CA","id":"EN_45678901234567890"}}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go VAActivationEntityIdExample (application/json) package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts" payload := strings.NewReader("{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"id\": \"EN_45678901234567890\"\n }\n }\n}") req, _ := http.NewRequest("PUT", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby VAActivationEntityIdExample (application/json) require 'uri' require 'net/http' url = URI("https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Put.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"id\": \"EN_45678901234567890\"\n }\n }\n}" response = http.request(request) puts response.read_body ``` ```java VAActivationEntityIdExample (application/json) import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.put("https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"id\": \"EN_45678901234567890\"\n }\n }\n}") .asString(); ``` ```php VAActivationEntityIdExample (application/json) request('PUT', 'https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts', [ 'body' => '{ "action": "ACTIVATION", "header_account": { "account": "0011224455", "branch_code": "930" }, "virtual_account": { "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": { "country_of_operation": "CA", "id": "EN_45678901234567890" } } }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp VAActivationEntityIdExample (application/json) using RestSharp; var client = new RestClient("https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts"); var request = new RestRequest(Method.PUT); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"id\": \"EN_45678901234567890\"\n }\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift VAActivationEntityIdExample (application/json) import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "action": "ACTIVATION", "header_account": [ "account": "0011224455", "branch_code": "930" ], "virtual_account": [ "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": [ "country_of_operation": "CA", "id": "EN_45678901234567890" ] ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PUT" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### VAActivationEntityDetailsExample (application/json) **Request** ```json { "action": "ACTIVATION", "header_account": { "account": "0011224455", "branch_code": "930" }, "virtual_account": { "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": { "country_of_operation": "CA", "last_name": "INC", "type": "C", "website": "www.dd.com", "store_name": "ABC", "business_purpose": "Trade", "acronym": "Buss", "org_prvt_identification": { "type": "TAX_ID", "id": "1234567890", "country_of_issuance": "US" }, "address": { "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } }, "beneficial_owner": [ { "date_of_birth": "2001-05-01", "first_name": "White", "last_name": "James", "address": { "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } }, { "date_of_birth": "2000-05-01", "first_name": "White", "last_name": "Mark", "address": { "street_name": "3210 Abcd st", "building_number": "12", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } } ] } } ``` **Response** ```json { "request_id": "29b9c9d7-d4d9-48ce-8823-f9b3ee276b8f", "status": "ACCEPTED", "message": "Request accepted Successfully" } ``` **SDK Code** ```python VAActivationEntityDetailsExample (application/json) import requests url = "https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts" payload = { "action": "ACTIVATION", "header_account": { "account": "0011224455", "branch_code": "930" }, "virtual_account": { "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": { "country_of_operation": "CA", "last_name": "INC", "type": "C", "website": "www.dd.com", "store_name": "ABC", "business_purpose": "Trade", "acronym": "Buss", "org_prvt_identification": { "type": "TAX_ID", "id": "1234567890", "country_of_issuance": "US" }, "address": { "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } }, "beneficial_owner": [ { "date_of_birth": "2001-05-01", "first_name": "White", "last_name": "James", "address": { "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } }, { "date_of_birth": "2000-05-01", "first_name": "White", "last_name": "Mark", "address": { "street_name": "3210 Abcd st", "building_number": "12", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } } ] } } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.put(url, json=payload, headers=headers) print(response.json()) ``` ```javascript VAActivationEntityDetailsExample (application/json) const url = 'https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts'; const options = { method: 'PUT', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"action":"ACTIVATION","header_account":{"account":"0011224455","branch_code":"930"},"virtual_account":{"account":"0123456789","purpose":"C","balance_display_option":"Y","entity":{"country_of_operation":"CA","last_name":"INC","type":"C","website":"www.dd.com","store_name":"ABC","business_purpose":"Trade","acronym":"Buss","org_prvt_identification":{"type":"TAX_ID","id":"1234567890","country_of_issuance":"US"},"address":{"street_name":"3210 Abcd st","building_number":"123","postal_code":"L5B 111","town_name":"North York","country_sub_division":"Ontario","country":"CA"}},"beneficial_owner":[{"date_of_birth":"2001-05-01","first_name":"White","last_name":"James","address":{"street_name":"3210 Abcd st","building_number":"123","postal_code":"L5B 111","town_name":"North York","country_sub_division":"Ontario","country":"CA"}},{"date_of_birth":"2000-05-01","first_name":"White","last_name":"Mark","address":{"street_name":"3210 Abcd st","building_number":"12","postal_code":"L5B 111","town_name":"North York","country_sub_division":"Ontario","country":"CA"}}]}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go VAActivationEntityDetailsExample (application/json) package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts" payload := strings.NewReader("{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"last_name\": \"INC\",\n \"type\": \"C\",\n \"website\": \"www.dd.com\",\n \"store_name\": \"ABC\",\n \"business_purpose\": \"Trade\",\n \"acronym\": \"Buss\",\n \"org_prvt_identification\": {\n \"type\": \"TAX_ID\",\n \"id\": \"1234567890\",\n \"country_of_issuance\": \"US\"\n },\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n \"beneficial_owner\": [\n {\n \"date_of_birth\": \"2001-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"James\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n {\n \"date_of_birth\": \"2000-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"Mark\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"12\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n }\n ]\n }\n}") req, _ := http.NewRequest("PUT", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby VAActivationEntityDetailsExample (application/json) require 'uri' require 'net/http' url = URI("https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Put.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"last_name\": \"INC\",\n \"type\": \"C\",\n \"website\": \"www.dd.com\",\n \"store_name\": \"ABC\",\n \"business_purpose\": \"Trade\",\n \"acronym\": \"Buss\",\n \"org_prvt_identification\": {\n \"type\": \"TAX_ID\",\n \"id\": \"1234567890\",\n \"country_of_issuance\": \"US\"\n },\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n \"beneficial_owner\": [\n {\n \"date_of_birth\": \"2001-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"James\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n {\n \"date_of_birth\": \"2000-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"Mark\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"12\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n }\n ]\n }\n}" response = http.request(request) puts response.read_body ``` ```java VAActivationEntityDetailsExample (application/json) import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.put("https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"last_name\": \"INC\",\n \"type\": \"C\",\n \"website\": \"www.dd.com\",\n \"store_name\": \"ABC\",\n \"business_purpose\": \"Trade\",\n \"acronym\": \"Buss\",\n \"org_prvt_identification\": {\n \"type\": \"TAX_ID\",\n \"id\": \"1234567890\",\n \"country_of_issuance\": \"US\"\n },\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n \"beneficial_owner\": [\n {\n \"date_of_birth\": \"2001-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"James\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n {\n \"date_of_birth\": \"2000-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"Mark\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"12\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n }\n ]\n }\n}") .asString(); ``` ```php VAActivationEntityDetailsExample (application/json) request('PUT', 'https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts', [ 'body' => '{ "action": "ACTIVATION", "header_account": { "account": "0011224455", "branch_code": "930" }, "virtual_account": { "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": { "country_of_operation": "CA", "last_name": "INC", "type": "C", "website": "www.dd.com", "store_name": "ABC", "business_purpose": "Trade", "acronym": "Buss", "org_prvt_identification": { "type": "TAX_ID", "id": "1234567890", "country_of_issuance": "US" }, "address": { "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } }, "beneficial_owner": [ { "date_of_birth": "2001-05-01", "first_name": "White", "last_name": "James", "address": { "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } }, { "date_of_birth": "2000-05-01", "first_name": "White", "last_name": "Mark", "address": { "street_name": "3210 Abcd st", "building_number": "12", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } } ] } }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp VAActivationEntityDetailsExample (application/json) using RestSharp; var client = new RestClient("https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts"); var request = new RestRequest(Method.PUT); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"last_name\": \"INC\",\n \"type\": \"C\",\n \"website\": \"www.dd.com\",\n \"store_name\": \"ABC\",\n \"business_purpose\": \"Trade\",\n \"acronym\": \"Buss\",\n \"org_prvt_identification\": {\n \"type\": \"TAX_ID\",\n \"id\": \"1234567890\",\n \"country_of_issuance\": \"US\"\n },\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n \"beneficial_owner\": [\n {\n \"date_of_birth\": \"2001-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"James\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n {\n \"date_of_birth\": \"2000-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"Mark\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"12\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n }\n ]\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift VAActivationEntityDetailsExample (application/json) import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "action": "ACTIVATION", "header_account": [ "account": "0011224455", "branch_code": "930" ], "virtual_account": [ "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": [ "country_of_operation": "CA", "last_name": "INC", "type": "C", "website": "www.dd.com", "store_name": "ABC", "business_purpose": "Trade", "acronym": "Buss", "org_prvt_identification": [ "type": "TAX_ID", "id": "1234567890", "country_of_issuance": "US" ], "address": [ "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" ] ], "beneficial_owner": [ [ "date_of_birth": "2001-05-01", "first_name": "White", "last_name": "James", "address": [ "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" ] ], [ "date_of_birth": "2000-05-01", "first_name": "White", "last_name": "Mark", "address": [ "street_name": "3210 Abcd st", "building_number": "12", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" ] ] ] ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PUT" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### VAActivationEntityIdExample (application/xml) **Request** ```json { "action": "ACTIVATION", "header_account": { "account": "0011224455", "branch_code": "930" }, "virtual_account": { "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": { "country_of_operation": "CA", "id": "EN_45678901234567890" } } } ``` **Response** ```json { "request_id": "29b9c9d7-d4d9-48ce-8823-f9b3ee276b8f", "status": "ACCEPTED", "message": "Request accepted Successfully" } ``` **SDK Code** ```python VAActivationEntityIdExample (application/xml) import requests url = "https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts" payload = { "action": "ACTIVATION", "header_account": { "account": "0011224455", "branch_code": "930" }, "virtual_account": { "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": { "country_of_operation": "CA", "id": "EN_45678901234567890" } } } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.put(url, json=payload, headers=headers) print(response.json()) ``` ```javascript VAActivationEntityIdExample (application/xml) const url = 'https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts'; const options = { method: 'PUT', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"action":"ACTIVATION","header_account":{"account":"0011224455","branch_code":"930"},"virtual_account":{"account":"0123456789","purpose":"C","balance_display_option":"Y","entity":{"country_of_operation":"CA","id":"EN_45678901234567890"}}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go VAActivationEntityIdExample (application/xml) package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts" payload := strings.NewReader("{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"id\": \"EN_45678901234567890\"\n }\n }\n}") req, _ := http.NewRequest("PUT", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby VAActivationEntityIdExample (application/xml) require 'uri' require 'net/http' url = URI("https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Put.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"id\": \"EN_45678901234567890\"\n }\n }\n}" response = http.request(request) puts response.read_body ``` ```java VAActivationEntityIdExample (application/xml) import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.put("https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"id\": \"EN_45678901234567890\"\n }\n }\n}") .asString(); ``` ```php VAActivationEntityIdExample (application/xml) request('PUT', 'https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts', [ 'body' => '{ "action": "ACTIVATION", "header_account": { "account": "0011224455", "branch_code": "930" }, "virtual_account": { "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": { "country_of_operation": "CA", "id": "EN_45678901234567890" } } }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp VAActivationEntityIdExample (application/xml) using RestSharp; var client = new RestClient("https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts"); var request = new RestRequest(Method.PUT); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"id\": \"EN_45678901234567890\"\n }\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift VAActivationEntityIdExample (application/xml) import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "action": "ACTIVATION", "header_account": [ "account": "0011224455", "branch_code": "930" ], "virtual_account": [ "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": [ "country_of_operation": "CA", "id": "EN_45678901234567890" ] ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PUT" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### VAActivationEntityDetailsExample (application/xml) **Request** ```json { "action": "ACTIVATION", "header_account": { "account": "0011224455", "branch_code": "930" }, "virtual_account": { "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": { "country_of_operation": "CA", "last_name": "INC", "type": "C", "website": "www.dd.com", "store_name": "ABC", "business_purpose": "Trade", "acronym": "Buss", "org_prvt_identification": { "type": "TAX_ID", "id": "1234567890", "country_of_issuance": "US" }, "address": { "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } }, "beneficial_owner": [ { "date_of_birth": "2001-05-01", "first_name": "White", "last_name": "James", "address": { "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } }, { "date_of_birth": "2000-05-01", "first_name": "White", "last_name": "Mark", "address": { "street_name": "3210 Abcd st", "building_number": "12", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } } ] } } ``` **Response** ```json { "request_id": "29b9c9d7-d4d9-48ce-8823-f9b3ee276b8f", "status": "ACCEPTED", "message": "Request accepted Successfully" } ``` **SDK Code** ```python VAActivationEntityDetailsExample (application/xml) import requests url = "https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts" payload = { "action": "ACTIVATION", "header_account": { "account": "0011224455", "branch_code": "930" }, "virtual_account": { "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": { "country_of_operation": "CA", "last_name": "INC", "type": "C", "website": "www.dd.com", "store_name": "ABC", "business_purpose": "Trade", "acronym": "Buss", "org_prvt_identification": { "type": "TAX_ID", "id": "1234567890", "country_of_issuance": "US" }, "address": { "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } }, "beneficial_owner": [ { "date_of_birth": "2001-05-01", "first_name": "White", "last_name": "James", "address": { "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } }, { "date_of_birth": "2000-05-01", "first_name": "White", "last_name": "Mark", "address": { "street_name": "3210 Abcd st", "building_number": "12", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } } ] } } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.put(url, json=payload, headers=headers) print(response.json()) ``` ```javascript VAActivationEntityDetailsExample (application/xml) const url = 'https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts'; const options = { method: 'PUT', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"action":"ACTIVATION","header_account":{"account":"0011224455","branch_code":"930"},"virtual_account":{"account":"0123456789","purpose":"C","balance_display_option":"Y","entity":{"country_of_operation":"CA","last_name":"INC","type":"C","website":"www.dd.com","store_name":"ABC","business_purpose":"Trade","acronym":"Buss","org_prvt_identification":{"type":"TAX_ID","id":"1234567890","country_of_issuance":"US"},"address":{"street_name":"3210 Abcd st","building_number":"123","postal_code":"L5B 111","town_name":"North York","country_sub_division":"Ontario","country":"CA"}},"beneficial_owner":[{"date_of_birth":"2001-05-01","first_name":"White","last_name":"James","address":{"street_name":"3210 Abcd st","building_number":"123","postal_code":"L5B 111","town_name":"North York","country_sub_division":"Ontario","country":"CA"}},{"date_of_birth":"2000-05-01","first_name":"White","last_name":"Mark","address":{"street_name":"3210 Abcd st","building_number":"12","postal_code":"L5B 111","town_name":"North York","country_sub_division":"Ontario","country":"CA"}}]}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go VAActivationEntityDetailsExample (application/xml) package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts" payload := strings.NewReader("{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"last_name\": \"INC\",\n \"type\": \"C\",\n \"website\": \"www.dd.com\",\n \"store_name\": \"ABC\",\n \"business_purpose\": \"Trade\",\n \"acronym\": \"Buss\",\n \"org_prvt_identification\": {\n \"type\": \"TAX_ID\",\n \"id\": \"1234567890\",\n \"country_of_issuance\": \"US\"\n },\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n \"beneficial_owner\": [\n {\n \"date_of_birth\": \"2001-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"James\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n {\n \"date_of_birth\": \"2000-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"Mark\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"12\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n }\n ]\n }\n}") req, _ := http.NewRequest("PUT", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby VAActivationEntityDetailsExample (application/xml) require 'uri' require 'net/http' url = URI("https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Put.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"last_name\": \"INC\",\n \"type\": \"C\",\n \"website\": \"www.dd.com\",\n \"store_name\": \"ABC\",\n \"business_purpose\": \"Trade\",\n \"acronym\": \"Buss\",\n \"org_prvt_identification\": {\n \"type\": \"TAX_ID\",\n \"id\": \"1234567890\",\n \"country_of_issuance\": \"US\"\n },\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n \"beneficial_owner\": [\n {\n \"date_of_birth\": \"2001-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"James\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n {\n \"date_of_birth\": \"2000-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"Mark\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"12\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n }\n ]\n }\n}" response = http.request(request) puts response.read_body ``` ```java VAActivationEntityDetailsExample (application/xml) import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.put("https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"last_name\": \"INC\",\n \"type\": \"C\",\n \"website\": \"www.dd.com\",\n \"store_name\": \"ABC\",\n \"business_purpose\": \"Trade\",\n \"acronym\": \"Buss\",\n \"org_prvt_identification\": {\n \"type\": \"TAX_ID\",\n \"id\": \"1234567890\",\n \"country_of_issuance\": \"US\"\n },\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n \"beneficial_owner\": [\n {\n \"date_of_birth\": \"2001-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"James\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n {\n \"date_of_birth\": \"2000-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"Mark\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"12\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n }\n ]\n }\n}") .asString(); ``` ```php VAActivationEntityDetailsExample (application/xml) request('PUT', 'https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts', [ 'body' => '{ "action": "ACTIVATION", "header_account": { "account": "0011224455", "branch_code": "930" }, "virtual_account": { "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": { "country_of_operation": "CA", "last_name": "INC", "type": "C", "website": "www.dd.com", "store_name": "ABC", "business_purpose": "Trade", "acronym": "Buss", "org_prvt_identification": { "type": "TAX_ID", "id": "1234567890", "country_of_issuance": "US" }, "address": { "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } }, "beneficial_owner": [ { "date_of_birth": "2001-05-01", "first_name": "White", "last_name": "James", "address": { "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } }, { "date_of_birth": "2000-05-01", "first_name": "White", "last_name": "Mark", "address": { "street_name": "3210 Abcd st", "building_number": "12", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" } } ] } }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp VAActivationEntityDetailsExample (application/xml) using RestSharp; var client = new RestClient("https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts"); var request = new RestRequest(Method.PUT); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"action\": \"ACTIVATION\",\n \"header_account\": {\n \"account\": \"0011224455\",\n \"branch_code\": \"930\"\n },\n \"virtual_account\": {\n \"account\": \"0123456789\",\n \"purpose\": \"C\",\n \"balance_display_option\": \"Y\",\n \"entity\": {\n \"country_of_operation\": \"CA\",\n \"last_name\": \"INC\",\n \"type\": \"C\",\n \"website\": \"www.dd.com\",\n \"store_name\": \"ABC\",\n \"business_purpose\": \"Trade\",\n \"acronym\": \"Buss\",\n \"org_prvt_identification\": {\n \"type\": \"TAX_ID\",\n \"id\": \"1234567890\",\n \"country_of_issuance\": \"US\"\n },\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n \"beneficial_owner\": [\n {\n \"date_of_birth\": \"2001-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"James\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"123\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n },\n {\n \"date_of_birth\": \"2000-05-01\",\n \"first_name\": \"White\",\n \"last_name\": \"Mark\",\n \"address\": {\n \"street_name\": \"3210 Abcd st\",\n \"building_number\": \"12\",\n \"postal_code\": \"L5B 111\",\n \"town_name\": \"North York\",\n \"country_sub_division\": \"Ontario\",\n \"country\": \"CA\"\n }\n }\n ]\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift VAActivationEntityDetailsExample (application/xml) import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "action": "ACTIVATION", "header_account": [ "account": "0011224455", "branch_code": "930" ], "virtual_account": [ "account": "0123456789", "purpose": "C", "balance_display_option": "Y", "entity": [ "country_of_operation": "CA", "last_name": "INC", "type": "C", "website": "www.dd.com", "store_name": "ABC", "business_purpose": "Trade", "acronym": "Buss", "org_prvt_identification": [ "type": "TAX_ID", "id": "1234567890", "country_of_issuance": "US" ], "address": [ "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" ] ], "beneficial_owner": [ [ "date_of_birth": "2001-05-01", "first_name": "White", "last_name": "James", "address": [ "street_name": "3210 Abcd st", "building_number": "123", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" ] ], [ "date_of_birth": "2000-05-01", "first_name": "White", "last_name": "Mark", "address": [ "street_name": "3210 Abcd st", "building_number": "12", "postal_code": "L5B 111", "town_name": "North York", "country_sub_division": "Ontario", "country": "CA" ] ] ] ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://tts.sandbox.apib2b.citi.com/citiconnect/sb/receivablesservices/v2/virtualaccounts")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PUT" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```