Get account id - Bulk signup

When creating an escrow transaction with our API, you are either creating the escrow transaction as a broker that is a Multi-party transaction or a single party transaction (only involves a seller and a buyer).

Whilst creating a transaction as a broker, the transaction parties payload should contain both the buyer and seller object payload.

Before the escrow transaction is created, each parties need to have their account_id added to the each party's object. To generate or retrieve an account_id for a user, you need to carryout a bulk signup for all parties involved.

Get user account Id - Bulk Signup

To get all users account_id, call the bulk signup API below. Both users with an existing account or not, it will either fetch their existing account_id or create an account and return the account_id.

Retrieving user account_id

POST https://api.vesicash.com/v2/bulk-signup

Headers

NameTypeDescription

Accept*

string

application/json

V-PRIVATE-KEY*

string

vesicash private key

V-PUBLIC-KEY*

String

vesicash public key

Request Body

NameTypeDescription

account_type*

String

email_address*

String

country*

String

phone_number

String

{
    "status": "success",
    "code": 201,
    "message": "users signup successful",
    "data": [
        {
            "id": 3174,
            "account_id": 3315810948,
            "account_type": "business",
            "firstname": "",
            "lastname": "",
            "email_address": "user@vesicash.com",
            "phone_number": "2349210099911",
            .....
        }
    ]
}

For example, you can make a post request to the endpoint above and pass in the raw json data below to get users account_id

{
    "bulk": [
        {
            "account_type": "business",
            "email_address": "user1@vesicash.com",
            "country": "nigeria",
            "phone_number": "2349200000010"
        },
         {
            "account_type": "business",
            "email_address": "user2@vesicash.com",
            "country": "nigeria",
            "phone_number": "2349200000011"
        }
    ]
}

Last updated