It is not required that the API method 1.5 Get Account Information is used to check whether an account already exists, if for example you track within your solution whether an end user already has an account.
Create Account
Last changes: 11-01-2022
Before creating a new account for an end user, check whether an account already exists by attempting to retrieve account information.
In the next step, you call the API method 1.1 Create Account, where you can specify a variety of customer information.
Please note that inline with requirements introduced by Strong Customer Authentication, Technical Account integrations require that real customer address information be provided, which makes the following address parameters mandatory:
- lastName (Dummy data acceptable.)
- firstName (Dummy data acceptable.)
- addr1
- houseNumber (If not included in addr1.)
- city
- postCode
- countryCode
- emailAddress
Please contact customer support where providing accurate data may not be possible in production, as this may result in transactions being rejected.
If the value of "countryCode" is "US" (United States of America) or "CA" (Canada) the "state" parameter is required. The value of "state" must be a valid State Code. (ex. "countryCode": "US", "state": "NY",)
When creating a new account, it is necessary to specify an email-address, since it acts as an account identifier. Optionally, you can provide an external account reference matching an account number within your own system.
The example below creates an Account for the end user with the External Account Reference KDNR0001.
Create Account Request
-
Path:
-
PUT {baseURL}/account
-
Header:
-
Content-Type: application/json
Accept-Language: en-US
X-Auth-Token: eyJhbGciOiJSUzI1NiI{abbreviated}RW5kVG9rZW4=
{
"partnerReference": "DEV-SVR001-DE_CUSTID-BJ93W32QB4_CARTID-B7GVYP74KD_WHDYKMHYQC",
"externalAccountReference": "KDNR0001",
"programCode": "COMPANYDE",
"currCode": "EUR",
"validFrom": "2018-10-20",
"validUntil": "2025-12-31",
"lastName": "Smith",
"firstName": "Jacob",
"addr1":"Anystreet 321",
"city":"Anycity",
"countryCode":"DE",
"postCode":"12345",
"dob": "1990-01-01",
"emailAddress": "user@example.com",
"useDifferentCorrespondenceAddress": false,
"nationality": "DE",
"localDate": "2018-10-20",
"localTime": "111446",
"custom1": "WVWZZZ3BZWE689725"
}
Create Account Response
-
Status Code:
-
200 (OK)
-
Header:
-
Content-Type: application/json
Accept-Language: en-US
{
"productCode": "EWLTDBT",
"accTypeCode": "TECHNICAL",
"custCode": "78034",
"externalAccountReference": "KDNR0001",
"accno": "1777888148",
"statusCode": "ACTIVE",
"validFrom": "2018-10-20",
"validUntil": "9999-12-31",
"accFlowStatusCode": "APPROVEDSV",
"programCode": "COMPANYDE",
"partnerReference": "DEV-SVR001-DE_CUSTID-BJ93W32QB4_CARTID-B7GVYP74KD_WHDYKMHYQC",
"localDate": "2018-10-20",
"localTime": "111446",
"sysDate": "2018-10-20",
"sysTime": "101446",
"responseCode": "0000",
"responseDescription": "Successful execution",
"additionalInformation": {
"requestId": "aff2728481a181dc36daedc14055b516"
}
}
We recommend the persistence of the internal account number, which is included in the response under the return parameter "accno".
Most API methods allow you to set the internal account number or the external account reference for the parameter "accno" (also see Account Number Type).