Introduction
The Link Widget provides a secure method of collecting personal and payment information to either add an external contact or update an external contact within your application. In order to leverage the capabilities of the borderless™ Link Widget, authentication is required through a dedicated endpoint. This process ensures the secure retrieval of a unique widget identifier. The obtained widgetId, serving as this unique identifier, will subsequently be utilized in constructing the widget URL, as exemplified in the borderless™ Link™ Recipes.
Please note that the widgetId holds validity for a duration of 15 minutes. Following expiration, a regeneration of the widgetId is necessary for uninterrupted Link widget access. To utilize the Update Contact Link Widget, the external contact @handle field will need to be submitted in the Link Widget authentication. For further details and implementation guidelines, refer to the provided examples in the borderless™ Link™ Recipes.
We appreciate your commitment to secure and streamlined interactions with the borderless™ widget. If you encounter any queries during the authentication process, our support team is available to assist you.
Data Requirements
Provide the following data requirements when sending a POST request to the Widget Authentication endpoint.
The body of the request should contain a JSON object with the the following information:
| Parameter | Required? | Description | Type |
|---|---|---|---|
| issuer | Yes | The 25 character alphanumeric string that is unique to your borderless™ Account and can be revealed in the Issuer ID column on the "Tokens" tab of your Developer Dashboard. An example would look like this: al2gyjp2bqqkm1598ekv9etfd | String |
| secretKey | Yes | The 36 character string that is unique to your borderless™ Account and is generated from the "Tokens" tab of your Developer Dashboard. An example would look like this: 42f1828e-c705-11ec-9d64-0242ac120002. | String |
| handle | No | This is the @handle associated with an external contact's account. An external contact the format is ^{XXXXX} where X represents randomly generated alphanumeric strings. An example would be ^be39D. Provide this value ONLY when seeking authentication for update contact via widget flow (/widgets/update-external-contact). | String |