Navigation:

Wallet API

Find out more about our Wallet API.

Authentication

The API calls below use basic auth.

Environments

The demo environment has a base URL of https://demo.vivapayments.com/ and for the live environment it’s https://www.vivapayments.com/.

API calls

Our Wallet API consists of the following API calls.

1. Balance transfer

Allows you to transfer money from any of your wallets to the wallet of another merchant. For a successful transfer to take place:

Source wallet must have sufficient funds to perform the operation
Source and target wallets must use the same currency

Before you can use this API call you need to enable transfers between accounts in the Viva Wallet banking app:

Log in to Viva Wallet, demo or live , and select the required account.
Go to Settings > API Access.
Select the Allow transfers between accounts checkbox as shown below:

You need only do this for the source wallet.

Request information

post /api/wallets/{walletId}/balancetransfer/{targetWalletId}

Parameter	Description	Type	Importance
`walletId`	Source ID of the wallet from which you wish to make the transfer. Displayed as Account ID under Accounts in the Viva Wallet banking app.	long	Required
`targetWalletId`	Destination ID of the wallet to which you wish to make the transfer. Displayed as Account ID under Accounts in the Viva Wallet banking app.	long	Required
`amount`	Transfer amount in the smallest denomination of your account currency.	long	Required
`description`	Some text to summarize the transfer reason. Appears on target account statement.	string	Optional
`saleTransactionId`	The Viva Wallet transaction ID generated during checkout (as a reference only).	GUID	Optional

Example

curl -L -X POST 'https://demo.vivapayments.com/api/wallets/91883585/balancetransfer/38995427' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Authorization: Basic OTZjYjVhMDctNDhjZS00ZDgxLTg3NmQtYTZjM2RmOGRiZDE2OkFEMmUqKA==' \
--data-raw '{
  "amount": "100",
  "description": "Optional text to show on account statement",
  "saleTransactionId": "Optional text referencing the related sales transaction"
}'

Response information

A valid balance transfer API call will result in HTTP status code 200, along with two transaction IDs.

DebitTransactionId is a unique identifier for the debit taken from the source wallet. CreditTransactionId is a unique identifier for the credit sent to the target wallet.

Example

{
  "DebitTransactionId": "eee0beff-7cd7-4b10-afae-e423712d52cb",
  "CreditTransactionId": "5f6da41c-5334-462c-877f-96d79a9b8d1e"
}

Further information

Check out the related tutorials below for examples of this API call in action:

2. Retrieve wallet info

Retrieves merchant wallet information including the available and current balances.

Request information

get /api/wallets

Example

curl -L -X GET 'https://demo.vivapayments.com/api/wallets' \
-H 'Authorization: Basic e01lcmNoYW50IElEfTp7QVBJIEtleX0='

Response information

Response is an array of wallets, with the following properties:

`parameter`	Type	Description
`walletId`	long	WalletId assigned to the wallet
`isPrimary`	bool	Indicates whether the wallet is the primary one
`amount`	decimal	Wallet balance
`available`	decimal	Available balance of wallet
`friendlyName`	string	Friendly name assigned
`currencyCode`	int	3-digit ISO formatted currency code corresponding to the wallet’s currency

Sample response

[
  {
    "walletId": 285944672607,
    "isPrimary": true,
    "amount": 249590.2,
    "available": 200100.0,
    "friendlyName": "Primary",
    "currencyCode": "978"
  },
  {
    "walletId": 839786772604,
    "isPrimary": false,
    "amount": 153700.5,
    "available": 109180.0,
    "friendlyName": "Misthodosies",
    "currencyCode": "978"
  }
]

Further information

Check out the related tutorials below for more details about OAuth 2 authentication and setting webhooks: