menu

Create a demand deposit account

TxB allows clients to create physical accounts for deposits, payables and receivables. To learn about creating virtual accounts, check out our virtual accounts guide.

Step by step guide

Step 1 - Reserve a list of accounts

The first step in account creation is retrieving a pre-reserved set of account numbers.

GET /v2/accounts/reserved returns:

{
    "reservedAccountNumbers": [
       	 {
            "accountNumber": "800013210000",
            "iban": null,			    // only applicable for non-US accounts
            "bankIdentifier": null,			// only applicable for non-US accounts
            "externalPaymentIds": null
       	 }
    ]
}

Note: Your query can be filtered by:

  • entityId – For clients who work with multiple entities and want to disambiguate the response
  • branchCountry – For clients operating across multiple TxB branches

US clients will receive 12 digit account numbers Clients outside of the US will receive account numbers, IBANs and Bank Identifier information.


Step 2 - Create a physical account

Next, you should use an account from the reserved response to open a physical account. It’s important to specify the correct branchCountry as this will drive which local routing information will be available as well as the available rails.

POST /v2/accounts/PHYSICAL with this sample payload:

{
	"physicalAccountRequest": {
	    "requestId": "DDAOpening1",
	    "branchCountry": US
	    "isVirtualEnabled": false,
	    "administrative": {
	    	"accountName": "My First DDA ",
	        "accountNickname": "DDA 1",
		    "accountCurrency": "USD",
	        "accountPurposes": [
	            "COMMERCIAL_PAYMENTS"
	       ]
	    },
	    "accountIdentifiers": {
    		"accountNumber": "800013210000"
		},
	    "ownershipAndControl": {
			"thirdPartyIndicator": false 	// true where depositor entity differs from creation entity
        }
    }
}

Note: The Id’s to be used within the OwnershipAndControl object can be retrieved by using the associated entityId in GET/v2/entities/{entityId} (Link). If the account is being created for the requesting entity, then thirdPartyIndicator = false and no further information is required – this will be inherited systematically.


Step 3 - Monitor the status of an account request

Account creation is async, so you need to monitor the creation process.

GET /v2/accounts/requests/DDAOpening1?requestType=CREATE returns:

{
  "accountNumber": "800013210000",
  "status": "COMPLETED"
}

Step 4 - Verify that account object is now created

After your async account creation is "COMPLETED", you can now retrieve the details of the account you created.

GET /v2/accounts/800013210000 returns:

{
  "type": "PHYSICAL",
  "accountStatus": "ACTIVE",
  "accountCurrency": "USD",
  "rate": null,
  "branchCountry": "US",
  "admistrative": {
	"openDate": "2022-03-15T15:49:24.845Z",
  	"accountName": "My First DDA",
	"accountNickname": "DDA 1",
    (...)
  }
}

Step 5 – Enable payment products on the account

Once the account is created, you can now enable products and rails for usage.

To enable products then you must submit the relevant information via API.

POST /v2/products/800013210000 with this representative payload:

{
	"requestId": "DDAProducts1",
    "achInformation": {
      	"companyId": "1234567891",
      	"secCodes": [
        		 "CCD",
        		 "WEB"
		],
        "originationProfile": "Standard Originator",
        "desiredOriginationDate": "T+0",
        "incomingincomingDebitAuthorization": "Accept",
        "incomingCreditAuthorization": "Accept"
    }
}

For some products, evidence must be provided in the form of documentation. Details of this will be communicated as part of your onboarding with TxB.


Step 6 (Where Required) – Upload supporting documentation

Once the product request has been submitted, you can now upload the required documentation. To do this you will need to utilize the document APIs.

POST /v2/documents?purpose=PRODUCT_ENABLEMENT:

{
	"customerIdentifier": {
		"entityId": "8C1BFE0D82374B6DBDDA2617CAD12269"
	},
	"documentFile": "assets/documents/ClientXACHForm.jpg",
	"documentType": "ACH_FORM"
}

Once submitted you should receive a 200 okay response with the following information:

{
    "documentId": "5f3b9999-bb6d-4931-bc81-6ea855eede7b",
    "documentStatus": "ACTIVE",
    "entityId": "8C1BFE0D82374B6DBDDA2617CAD12269",
    "externalSourceId": null,
    "creationTime": "2022-11-23T10:08:37Z",
    "documentName": "Bank Test.png",
    "documentType": "ACH_FORM",
    "documentTypeOtherDescription": null,
    "uploader": "PARTNER",
    "linkUrl": {
        "linkType": "SELF",
        "linkUrl": "https://api.uat.txb.gs.com/v2/documents/eyJlb...hHgj5YWs/file",
        "method": "GET"
    },
    "relatedCases": null
}

Step 7 – Monitor Product Enablement

Once your product request has been successfully submitted, you can monitor the status.

All product requests will need to be reviewed and approved by TxB operations to ensure completeness and, where applicable, market setup.

GET /v2/products/requests/DDAProducts1 returns:

{
  "accountNumber": "80001319",
  "status": "COMPLETED"
}

Once your status is complete, you can begin to execute further API calls related to the available products.


Certain solutions and Institutional Services described herein are provided via our Marquee platform. The Marquee platform is for institutional and professional clients only. This site is for informational purposes only and does not constitute an offer to provide the Marquee platform services described, nor an offer to sell, or the solicitation of an offer to buy, any security. Some of the services and products described herein may not be available in certain jurisdictions or to certain types of clients. Please contact your Goldman Sachs sales representative with any questions. Any data or market information presented on the site is solely for illustrative purposes. There is no representation that any transaction can or could have been effected on such terms or at such prices. Please see https://www.goldmansachs.com/disclaimer/sec-div-disclaimers-for-electronic-comms.html for additional information.
Transaction Banking services are offered by Goldman Sachs Bank USA (“GS Bank”). GS Bank is a New York State chartered bank, a member of the Federal Reserve System and a Member FDIC.
GS DAP™ is owned and operated by Goldman Sachs. This site is for informational purposes only and does not constitute an offer to provide, or the solicitation of an offer to provide access to or use of GS DAP™. Any subsequent commitment by Goldman Sachs to provide access to and / or use of GS DAP™ would be subject to various conditions, including, amongst others, (i) satisfactory determination and legal review of the structure of any potential product or activity, (ii) receipt of all internal and external approvals (including potentially regulatory approvals); (iii) execution of any relevant documentation in a form satisfactory to Goldman Sachs; and (iv) completion of any relevant system / technology / platform build or adaptation required or desired to support the structure of any potential product or activity.
Mosaic is a service mark of Goldman Sachs & Co. LLC. This service is made available in the United States by Goldman Sachs & Co. LLC and outside of the United States by Goldman Sachs International, or its local affiliates in accordance with applicable law and regulations. Goldman Sachs International and Goldman Sachs & Co. LLC are the distributors of the Goldman Sachs Funds. Depending upon the jurisdiction in which you are located, transactions in non-Goldman Sachs money market funds are affected by either Goldman Sachs & Co. LLC, a member of FINRA, SIPC and NYSE, or Goldman Sachs International. For additional information contact your Goldman Sachs representative. Goldman Sachs & Co. LLC, Goldman Sachs International, Goldman Sachs Liquidity Solutions, Goldman Sachs Asset Management, L.P., and the Goldman Sachs funds available through Goldman Sachs Liquidity Solutions and other affiliated entities, are under the common control of the Goldman Sachs Group, Inc.
© 2024 Goldman Sachs. All rights reserved.