On This Page {#jumplink-list} [Markdown](/docs/cybs/en-us/boarding/developer/all/rest/boarding/boarding-reg-intro/boarding-reg-create-transacting-api.md) Filter FILTER BY TAG Add a Transacting Organization to an Existing Organization {#boarding-reg-create-transacting-api} ================================================================================================= This section describes how to create a *transacting merchant account* in an existing merchant organization. You can also onboard a transacting organization using a solution identifier. See [REST Example: Creating a Transacting Organization with Integration Information](/docs/cybs/en-us/boarding/developer/all/rest/boarding/boarding-reg-create-transacting-integ-api-example.md ""). IMPORTANT This feature is in pilot phase. You must contact your account representative for more information about how to use this feature. Endpoint {#boarding-reg-create-transacting-api_d9e752} ------------------------------------------------------ **Production:** `POST ``https://api.cybersource.com``/boarding/v1/registrations`{#boarding-reg-create-transacting-api_d9e759} **Test:** `POST ``https://apitest.cybersource.com``/boarding/v1/registrations`{#boarding-reg-create-transacting-api_d9e769} Required Fields for Adding a Transacting Organization to an Existing Organization {#boarding-reg-create-transacting-api-req-fields} =================================================================================================================================== [organizationInformation.businessInformation.address.address1](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/org-info-aa/org-info-business-info-address-address1.md "") : [organizationInformation.businessInformation.address.country](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/org-info-aa/org-info-business-info-address-country.md "") : [organizationInformation.businessInformation.address.locality](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/org-info-aa/org-info-business-info-address-locality.md "") : [organizationInformation.businessInformation.businessContact.email](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/org-info-aa/org-info-business-info-contact-email.md "") : [organizationInformation.businessInformation.businessContact.firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/org-info-aa/org-info-business-info-business-contact-first-name.md "") : [organizationInformation.businessInformation.businessContact.lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/org-info-aa/org-info-business-info-business-contact-last-name.md "") : [organizationInformation.businessInformation.businessContact.phoneNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/org-info-aa/org-info-business-info-business-contact-phone-num.md "") : [organizationInformation.businessInformation.name](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/org-info-aa/org-info-business-info-name.md "") : [organizationInformation.configurable](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/org-info-aa/org-info-configurable.md "") : Set the value to `false`. [organizationInformation.parentOrganizationId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/org-info-aa/org-info-parent-organization-id.md "") : Set to the ID of the organization that you want to be above this one in the hierarchy. [organizationInformation.type](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/org-info-aa/org-info-type.md "") : Set the value to `TRANSACTING`. {#boarding-reg-create-transacting-api-req-fields_list} REST Example: Creating a Transacting Organization {#boarding-reg-create-transacting-api-example} ================================================================================================ Request ``` { "registrationInformation": { "boardingFlow": "ENTERPRISE" }, "organizationInformation": { "organizationId": "yourtransactingorgidhere", "status": "LIVE", "businessInformation": { "address": { "country": "US", "address1": "123 Main", "postalCode": "99999", "administrativeArea": "WA", "locality": "Seattle" }, "businessContact": { "firstName": "Jane", "lastName": "Smith", "phoneNumber": "5551234567", "email": "email@domain.com" }, "technicalContact": { "firstName": "Jane", "lastName": "Smith", "phoneNumber": "5551234567", "email": "email@domain.com" }, "emergencyContact": { "firstName": "Jane", "lastName": "Smith", "phoneNumber": "5551234567", "email": "email@domain.com" }, "name": "Test Merchant", "websiteUrl": "https://www.MerchantUrlHere.com", "phoneNumber": "5551234567", "timeZone": "America/Los_Angeles", "merchantCategoryCode": "5999" }, "parentOrganizationId": "yourmercahntorgidhere", "type": "TRANSACTING", "configurable": false }, "productInformation": { "selectedProducts": { "payments": { "customerInvoicing": { "subscriptionInformation": { "enabled": true, "selfServiceability": "NOT_SELF_SERVICEABLE" } } }, "risk": { "fraudManagementEssentials": { "subscriptionInformation": { "enabled": true, "selfServiceability": "NOT_SELF_SERVICEABLE" } } }, "commerceSolutions": { "tokenManagement": { "subscriptionInformation": { "enabled": true, "selfServiceability": "NOT_SELF_SERVICEABLE" } } }, "valueAddedServices": { "transactionSearch": { "subscriptionInformation": { "enabled": true, "selfServiceability": "NOT_SELF_SERVICEABLE" } }, "reporting": { "subscriptionInformation": { "enabled": true, "selfServiceability": "NOT_SELF_SERVICEABLE" } } } } } } ``` Request with Integration Information ``` { "registrationInformation": { "boardingFlow": "ENTERPRISE", "mode": "COMPLETE", "boardingPackageId": "16885604124" }, "organizationInformation": { "status": "LIVE", "businessInformation": { "address": { "country": "GB", "address1": "Sample Street 1234", "locality": "London", "postalCode": "98765" }, "businessContact": { "firstName": "Test", "lastName": "Test", "phoneNumber": "123456789", "email": "test@test.com" }, "technicalContact": { "firstName": "Test", "lastName": "Test", "phoneNumber": "123456789", "email": "test@test.com" }, "emergencyContact": { "firstName": "Test", "lastName": "Test", "phoneNumber": "123456789", "email": "test@test.com" }, "name": "Test 4", "websiteUrl": "", "phoneNumber": "123456789", "timeZone": "GMT", "merchantCategoryCode": "5399" }, "parentOrganizationId": "cptesting06", "type": "TRANSACTING", "configurable": false }, "integrationInformation": { "tenantConfigurations": [ { "solutionId": "wrqgaz3e" } ] }, "productInformation": { "selectedProducts": { "payments": { "cardProcessing": { "subscriptionInformation": { "enabled": true, "features": { "cardNotPresent": { "enabled": false }, "cardPresent": { "enabled": true } } }, "configurationInformation": { "configurations": { "common": { "merchantCategoryCode": "5399", "defaultAuthTypeCode": "FINAL", "processors": { "barclayshiso": { "acquirer": {acq123 }, "paymentTypes": { "MAESTRO": { "enabled": true }, "MASTERCARD": { "enabled": true }, "DISCOVER": { "enabled": true }, "JCB": { "enabled": true }, "VISA": { "enabled": true }, "VISA_ELECTRON": { "enabled": true }, "DINERS_CLUB": { "enabled": true }, "CUP": { "enabled": true } }, "batchGroup": "barclayshiso_test", "merchantId": "1234567", "terminalId": null } } }, "features": { "cardNotPresent": { "processors": { "barclayshiso": { "relaxAddressVerificationSystem": true, "relaxAddressVerificationSystemAllowExpiredCard": true, "relaxAddressVerificationSystemAllowZipWithoutCountry": true } } } } }, "templateId": "F4EEFE3C-ED8C-4937-A48A-C013B228488E" } }, "cybsReadyTerminal": { "subscriptionInformation": { "enabled": true, "selfServiceability": "NOT_SELF_SERVICEABLE" } } } } } } ``` Response to Successful Request ``` { "id": "1696604001", "submitTimeUtc": "2022-04-13T21:03:02Z", "status": "SUCCESS", "registrationInformation": { "mode": "COMPLETE", "boardingPackageId": "123456789012" }, "organizationInformation": { "organizationId": "yourtransactingorgidhere", "parentOrganizationId": "yourmercahntorgidhere" }, "message": "Request was processed successfully" } ``` RELATED TO THIS PAGE * [Customer Support](https://support.visaacceptance.com/) * [REST API Field Reference Guide](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/rest-api-fields-intro.md) * [Response Codes](https://developer.cybersource.com/api/reference/response-codes.md)