In This Section

In this section you will find step-by-step recipes for integrating the External Contacts API into your product. Below you will find recipes to:

Add an External Contact
Retrieve Contact Information
Update Contact Information

Add External Contacts Recipe

Step

Corresponding Code (JavaScript)

Determine Required Information For the Contact -

Use the /externalContact/requiredInformation and /zonecodes endpoint to determine required information for the external contact based on their country and accountType.

const options = {
 method: 'GET',
 headers: {
  Accept: 'application/json',
  Authorization: 'Bearer USER'
 }
};

fetch('https://prod.api.getborderless.com/externalContact/requiredInformation', options)
 .then(response => response.json())
 .then(response => console.log(response))
 .catch(err => console.error(err));

fetch('https://prod.api.getborderless.com/zoneCodes', options)
 .then(response => response.json())
 .then(response => console.log(response))
 .catch(err => console.error(err));

Create the Request Body and utilize the /externalContacts endpoint -

Create the Request Body and utilize the /externalContacts endpoint.

const options = {
 method: 'POST',
 headers: {
  Accept: 'application/json',
  'Content-Type': 'application/json',
  Authorization: 'Bearer USER'
 }
};

fetch('https://prod.api.getborderless.com/externalContact', options)
 .then(response => response.json())
 .then(response => console.log(response))
 .catch(err => console.error(err));

Retrieve Contact Information Recipe

Step

Corresponding Code (JavaScript)

Check for status updates-

If the /externalContacts endpoint returns a "PENDING" status, use the /externalContact/status endpoint to check for when the status becomes approved.

const options = {
 method: 'GET',
 headers: {
  Accept: 'application/json',
  Authorization: 'Bearer USER'
 }
};

fetch('https://prod.api.getborderless.com/externalContact/status', options)
 .then(response => response.json())
 .then(response => console.log(response))
 .catch(err => console.error(err))

Get Contact Information-

Use the /contacts/contactInformation endpoint to receive information for the contact. Here you can see if a contact is External or Internal, and if it is a Personal or Business account.

const options = {
 method: 'GET',
 headers: {
  Accept: 'application/json',
  Authorization: 'Bearer USER'
 }
};

fetch('https://prod.api.getborderless.com/contacts/contactInformation', options)
 .then(response => response.json())
 .then(response => console.log(response))
 .catch(err => console.error(err));

Update Contacts Recipe

Step

Corresponding Code (JavaScript)

Update Contact's Banking Information -

If you need to make changes to your external Contact's banking information you can use the /externalContacts/updateBankingInformation endpoint.

const options = {
 method: 'POST',
 headers: {
  Accept: 'application/json',
  'Content-Type': 'application/json',
  Authorization: 'Bearer USER'
 }
};

fetch('https://prod.api.getborderless.com/externalContact', options)
 .then(response => response.json())
 .then(response => console.log(response))
 .catch(err => console.error(err));

Update Contact Information -

Update Contact Information with the /contacts/updateContactInformation endpoint. The information you can update varies on account type which you can retrieve from the /contactInformation endpoint. Please refer to the page

here

const options = {
 method: 'POST',
 headers: {
  Accept: 'application/json',
  'Content-Type': 'application/json',
  Authorization: 'Bearer USER'
 }
};

fetch('https://prod.api.getborderless.com/externalContact', options)
 .then(response => response.json())
 .then(response => console.log(response))
 .catch(err => console.error(err));