CreateTransferReceivers

Inputs (Array[]) inherits from EntityBase

NameTypeDescriptionMandatoryAvailable from version
Namestring Name of this transfer receiver True 2.13
Commentstring A comment or description False
BatchOrdersbool True if orders on this account should be batch processed  True
PersonGuid The ID of the person who owns this account True
TransferReceiverExtraInfoComplex

 Determines the account type. Also contains a type specific payload (spec below). One of the following:

  • TransferReceiverExtraInfoAutoGiro
  • TransferReceiverExtraInfoBankGiro
  • TransferReceiverExtraInfoDirectBankDomestic
  • TransferReceiverExtraInfoDirectBankForeign
  • TransferReceiverExtraInfoSecurities
  • TransferReceiverExtraInfoSecuritiesAccount
  • TransferReceiverExtraInfoPlusGiro
 True

TransferReceiverExtraInfoAutoGiro

Name

TypeDescriptionMandatoryAvailable from versionComment
BankNamestringName of the bank that holds the external accountFalse

CounterPartyClearingNostringAccounts clearing number True
Max five digits (a hyphen is not allowed)
CounterPartyAccountNostringAccounts account numberTrue

TransferReceiverExtraInfoBankGiro

Name

TypeDescriptionMandatoryAvailable from versionComment
Account NostringExternal account numberFalse
Deprecated as of 2.37 and replaced by BankGiroNumber
BankGiroNumberstringThe BankGiro number.True2.37

TransferReceiverExtraInfoDirectBankDomestic

Name

TypeDescriptionMandatoryAvailable from version
CounterPartyClearingNostringAccounts clearing numberTrue
CounterPartyAccountNostringAccounts account numberTrue

TransferReceiverExtraInfoDirectBankForeign

Name

TypeDescriptionMandatoryAvailable from version
BICstringInternational BIC codeFalse
IBANstringInternational IBAN codeFalse
AddressstringThe banks address False

TransferReceiverExtraInfoSecurities

Name

TypeDescriptionMandatoryAvailable from version
CounterPartystringBricknode ID of the counterpartyTrue
AccountNostringAccount number at the counterpartyFalse

TransferReceiverExtraInfoSecuritiesAccount

Name

TypeDescriptionMandatoryAvailable from version
CounterPartystringBricknode ID of the counterpartyTrue
AccountNostringAccount number at the counterpartyFalse

TransferReceiverExtraInfoPlusGiro

Name

TypeDescriptionMandatoryAvailable from version
AccountNostringThe plusgiro account numberFalse

Response rows

NameTypeDescriptionAvailable from version
EntitiesArrayAll TransferReceivers in the request is returned. And array of Errors per TransferReceiver

Code examples

C# - Create an AutoGiro TransferReceiver
var request = new bfsapi.CreateTransferReceiversRequest()
{
	Credentials = new bfsapi.Credentials
    {
		UserName = "APIUSer",
		Password = "thesecret"
    },
    identify = "theIdentity",
};

request.Entities = new bfsapi.TransferReceiver[]
{
	new bfsapi.TransferReceiver()
	{
		Name = "TheAG account",
        Comment = "A very interesting comment",
        BatchOrders = false,
        Person = new Guid("d9ed44e3-b001-4e39-9a64-0421e0f310ed"),
		TransferReceiverExtraInfo = new TransferReceiverExtraInfoAutoGiro()
        {
        	BankName = "SEB",
        	CounterPartyClearingNo = "1234",
        	CounterPartyAccountNo = "1234",
        }
	}
};

var response = bfsapiClient.CreateTransferReceivers(request);