post https://prod.api.getborderless.com/external-contacts//wallets
Introduction
With this endpoint you can add Paypal and/or Venmo wallet as a receive method for an existing external contact. borderless will automatically switch new wallet as preferred receive method. Your external contact will receive all future payments to the new wallet.
Data Requirements
Provide the following data requirements when sending a POST request to the Add Wallet endpoint.
Additional Header parameter:
| Parameter | Required? | Description | Type |
|---|---|---|---|
| Client-Id | No | Unique identifier of Child Account (required only for Partner). See Authentication Page to learn more. | String |
The url of this request should contain the following path parameter:
| Parameter | Required? | Description | Type |
|---|---|---|---|
| handle | Yes | This is the @handle associated with a contact's account. For an external contact the format is ^{XXXXX} where X represents randomly generated alphanumeric strings. An example would be ^be39D. Note: Please use url encoding when providing contact's handle in the URL. | String |
The body of the request should contain the following properties:
| Parameter | Required? | Description | Type |
|---|---|---|---|
| walletType | Yes | The type of the wallet you wish to add. Possible values are PAYPAL | VENMO. | String |
| walletEmail | No | Paypal email. This field is _required_ if walletType is PAYPAL. | String |
| walletUsername | No | Venmo username. This field is required if walletType is VENMO. | String |