Show menu Show search

Welcome to Bottomline Customer Support

Search frequently asked questions

Ask your question by entering it here, or choose from the list of frequently asked questions below.

Have you got examples of the V-Series API calls that could be used on our website, as part of our customer on-boarding process?

1. Gathering the correctly formatted, customer address information … use the POSTCODE lookup to capture correctly formatted CURRENT address:

a. GET api/getukaddresses API call (e.g. https://vseries.bottomline.com/api/getukaddresses?apikey=[insertlicensekeyhere]&houseNameOrNumber=&street1=&street2=&district=&town=&county=&postcode=BS67AG)

b. Using the pick list returned from V-Series, allow customer to identify correct address.

c. Alternatively, you could also allow the customer to enter their house name / number along with the postcode to help identify their address specifically.

d. Fully populate the on screen data fields with the address information provided, allowing the customer to confirm before proceeding.

e. Retain currentAddressKey provided by V-Series. This will be used later if verification is also required.

 

2. Use POSTCODE lookup to capture correctly formatted PREVIOUS ADDRESS if resident in current address for less than 3 years (this MAY NOT be required if previous address isn’t applicable to your business):

a. GET api/getukaddresses API call (e.g. https://vseries.bottomline.com/api/getukaddresses?apikey=[insertlicensekeyhere]&houseNameOrNumber=&street1=&street2=&district=&town=&county=&postcode=BS305QH)

b. Using the pick list returned from V-Series, allow customer to identify correct address.

c. Alternatively, you could also allow the customer to enter their house name / number along with the postcode to help identify their address specifically.

d. Fully populate the on screen data fields with the address information provided, allowing the customer to confirm before proceeding.

e. Retain previous AddressKey provided by V-Series. This will be used later if verification is also required.

 

3. Validate sort code and account number combination, conducting a modulus check on the pairing of the two numbers:

a. GET api/validateukbankaccount API call (e.g. https://vseries.bottomline.com/api/validateukbankaccount?apikey=[insertlicensekeyhere]&sortCode=[insertsortcode]&accountNumber=[insertaccountnumber])

b. Using validated JSON response from V-Series, fully populate web form with bank & branch information / specifics – allowing the customer to confirm that this is their bank / branch.

c. Alternatively, you may choose to present ‘just’ a VALID / INVALID message back to the consumer as opposed to presenting back all thei information associated with the bank / branch in question.

d. If applicable to your needs and / or business processes, review the bank transaction types allowed. This is valuable if wishing to check if a given bank account is VALID for direct debit instructions.

 

4. ONLY verify account ownership when you satisfactory outputs from 1 & 3 or 1, 2 & 3 above (i.e. validated bank account information and pre-validated address information):

a. GET api/verifyukaccountownership) API call (e.g. https://vseries.bottomline.com/api/verifyukaccountownershipwithaddresses?apikey=[insertlicensekeyhere]&title=&forename=&middlename=&surname=&dob=&accountNumber=&sortCode=&currentAddress={"HouseNumberOrName":”","Street1":"","Street2":"","District":"","Town":"Westbury","County":"","Postcode":"BA133BN"}&previousAddress=

b. Use previously validated sort code / account number and pre-validated currentAddressKey / previousAddressKey (if provided by the customer

c. Please review the API Guide for further detail of the verification response and status codes available.

d. Inform the customer of their verified status.

e. If unable to verify the information provided, inform them of next steps associated with their registration, application or purchase.

Did this answer your question?

Your feedback will help us to keep improving this website.

Yes: No: