Using the Business Center to Add
an Additional Transacting Organization to an Existing Merchant Organization

To add an additional transacting organization to an existing merchant account:
  1. Click
    + Add Merchant
    .
  2. Select
    Add to an existing account
    and then click
    Next
    .
  3. If you have more than one boarding package, the Boarding Presets section is displayed. Enter the name of the merchant organization to add the new transacting organization to. Then choose a boarding package from the drop-down menu, or enter text in the search field to find one. Then click
    Next
    . If you have only one boarding package, the Boarding Presets section does not display.
  4. Optional: add additional organizations by clicking
    Start
    in the Hierarchy Details section. Or skip this step by clicking
    Skip
    .
  5. Enable and configure products. See Configuring the Transacting Organization and Products.

Configuring the Transacting Organization and Products

To modify the transacting organization details, or to enable and configure products for the transacting organization:
  1. Click
    Start
    in the Transacting Organization and Products section. The Transacting Organization and Products page is displayed.
  2. Optional: modify the name and ID of the organization by using the text fields in the Transacting Organization Details section. By default, the name is the merchant name with 001 added to the end of the name. If you accept this default, additional transacting organizations will have default names that iterate the numbers at the end of their names, beginning with 002.
  3. Optional: to edit the organization information, Click
    Edit
    in the Transacting Organization Information section. After editing, click
    Apply
    .
  4. To enable a product in the Product Enablement section, click the Enablement drop-down menu and select
    Enabled
    .
  5. To modify the configuration, click the
    Edit
    or
    configure
    button (depending on the product). Some products are not configurable.
  6. To confirm the configuration, click
    Apply
    .
  7. To save all product configurations, click
    Save
    . You are returned to the Add Merchant page.
  8. To continue working with this organization, click
    Continue working with this merchant
    . To finish and return to Merchant Management, click
    Return to merchant management
    .

Using the API to Add a Transacting Organization to an Existing Organization

Use these instructions to create a transacting account using the API.

Required Fields for Adding a Transacting Organization to an Existing Organization

organizationInformation.parentOrganizationId
Set to the ID of the organization that you want to be above this one in the hierarchy.
organizationInformation.type
Set the value to
TRANSACTING
.
organizationInformation.configurable
Set the value to
false
.
organizationInformation.businessInformation.name
organizationInformation.businessInformation.address.country
organizationInformation.businessInformation.address.address1
organizationInformation.businessInformation.address.locality
organizationInformation.businessInformation.country
organizationInformation.businessInformation.businessContact.firstName
organizationInformation.businessInformation.businessContact.lastName
organizationInformation.businessInformation.businessContact.phoneNumber
organizationInformation.businessInformation.businessContact.email

Adding a Transacting Organization to an Existing Organization Using the API

To create a transacting organization:
  1. Send a POST request to:

    ADDITIONAL INFORMATION

    Production:
    https://api.smartpayfuse.barclaycard
    /boarding/v1/registrations
    Test:
    https://api.smartpayfuse-test.barclaycard
    /boarding/v1/registrations
  2. Check the response message to make sure that the request was successful. A 200-level HTTP response code indicates success. For information about response codes, see Transaction Response Codes.

Example: Creating a Transacting Organization Using the API

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" } } } } } }
Response
{ "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" }