Create Destination Account

/createDestinationAccount

Use the Create Destination Account endpoint to create an account at an external bank to receive wires. In some cases, it is necessary to also configure an intermediary bank.

Input parameters

Name	Req	Data type	Description	Pattern	Example
`apiLogin`	X	string	Web service username, as provided by Galileo.	Max 50 characters	`"AbC123-9999"`
`apiTransKey`	X	string	Web service password, as provided by Galileo.	Max 15 characters	`"4sb62fh6w4h7w34g"`
`providerId`	X	int32	Galileo-issued provider identifier.	Max 10 digits	`9999`
`transactionId`	X	string	A unique provider-generated ID to identify this API call. A UUID is preferred. This value is used for idempotency	Max 60 characters	`"123e4567-e89b-12d3-a456-426614174000"`
`accountNo`	X	string	The PRN of the sending account.	PRN	`"999101789123"`
`destinationName`	X	string	Display name for the remote account.	Max 34 alphanumeric, punctuation	`"Celia College Fund"`
`destinationBankName`	X	string	Name of the bank where the remote account is housed.	Max 34 alphanumeric, punctuation	`"BANCO DO BRASIL S.A."`
`destinationBankStandardRouting`		string	Standard routing number for `destinationBankName`. Galileo validates the check digit.	9 digits	`"074000078"`
`destinationBankWireRouting`		string	Wire routing number for `destinationBankName`. Galileo validates the check digit.	9 digits	`"011103093"`
`destinationBankAddress`		string	Address of `destinationBankName`	Max 105 alphanumeric, punctuation	`"SETOR DE AUTARQUIAS NORTE , 5, EDIF.BANCO DO BRASIL - FLOOR 10, LOTE B - SAUN QUADRA Brazil"`
`intermediaryBankName`		string	Name of the intermediary bank.	Max 34 alphanumeric, punctuation	`"BANCO NACIONAL DE MEXICO S.A."`
`intermediaryBankWireRouting`		string	Wire routing number for `intermediaryBankName`. Galileo validates the check digit.	9 digits	`"211274450"`
`intermediaryBankAddress`		string	Address of `intermediaryBankName`.	Max 105 alphanumeric, punctuation	`"ACTUARIO ROBERTO MEDELLIN, 800, COL. SANTA FE Mexico"`
`destinationAccountNumber`	X	string	Account number at `destinationBankName`, either U.S. or IBAN.	Max 34 alphanumeric characters	`"999123456789`"
`destinationAccountName`	X	string	Name on the account in `destinationAccountNumber`.	Max 105 alphanumeric, punctuation	`"Celia Andrade"`
`destinationAccountAddress`	X	string	Address of the person or entity in `destinationAccountName`.	Max 105 alphanumeric, punctuation	`"335 W Cerulean St., Blueville, UT 84030"`
`destinationAccountType`		string	Type of the external bank account: `C` — Checking `S` — Savings `M` — Money market	1 character	`"C"`

Example request

curl --location --request POST 'https://[URL]/intserv/4.0/createDestinationAccount' \
--header 'response-content-type: json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'apiLogin=[redacted]' \
--data-urlencode 'apiTransKey=[redacted]' \
--data-urlencode 'providerId=99' \
--data-urlencode 'transactionId=beb0ee13-b50f-40c3-9de9-47a48f6419ee' \
--data-urlencode 'accountNo=999101789123'\
--data-urlencode 'destinationName=Celia College Fund' \
--data-urlencode 'destinationBankName=BANCO DO BRASIL S.A.' \
--data-urlencode 'destinationBankStandardRouting=999999999' \
--data-urlencode 'destinationBankWireRouting=888888888' \
--data-urlencode 'destinationBankAddress=SETOR DE AUTARQUIAS NORTE , 5, EDIF.BANCO DO BRASIL - FLOOR 10, LOTE B - SAUN QUADRA Brazil' \
--data-urlencode 'intermediaryBankName=BANCO NACIONAL DE MEXICO S.A.' \
--data-urlencode 'intermediaryBankWireRouting=777777777' \
--data-urlencode 'intermediaryBankAddress=ACTUARIO ROBERTO MEDELLIN, 800, COL. SANTA FE Mexico' \
--data-urlencode 'destinationAccountNumber=999123456789' \
--data-urlencode 'destinationAccountName=Celia Andrade' \
--data-urlencode 'destinationAccountAddress=335 W Cerulean St., Blueville, UT 84030' \
--data-urlencode 'destinationAccountType=C'

Response fields

Name	Req	Data type	Description
`destination_account_id`	X	string	UUID that identifies the destination account in the Galileo system.

Example response

{
  "status_code": 0,
  "status": "Success",
  "processing_time": 0.298,
  "transaction_id": "UUID",
  "response_data": {
    "destination_account_id": "123e4567-e89b-12d3-a456-426614174000",
  },
  "echo": {
    "provider_transaction_id": "",
    "provider_timestamp": null,
    "transaction_id": "629d890a-d773-4615-9bc4-bbe12effcf94"
  },
  "rtoken": "8cc16de0-5eda-4e2a-968e-3b08fce6f778",
  "system_timestamp": "2022-08-13 10:36:54"
}

Status codes

See Global Response Statuses for status codes that are common across endpoints.