Create a business

Merchants have to create and register their business to use Vendy. The apikey and secret generated are used in initiating transactions either via the API or checkout widget.

Request:

Field	Type	Description
name	String	Business name
currency	String	Three letters ISO currency code e.g NGN
email	String	Valid business email
type	Enum(String)	Type of business: 'corporate' or 'individual'
phonenumber	String	A valid phone number

Example request

curl --location 'https://api.vendy.money/business' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data-raw '{
    "name":"Business Name",
    "currency":"NGN",
    "email":"[email protected]",
    "type": "individual", 
    "phonenumber":"08101851915"
}'

Response:

Field	Type	Description
status	Boolean	States if request was successfully executed or not
code	Integer	Internal code, success if 200
data	minified Business	Newly created business details

Example response

{
    "status": true,
    "code": 200,
    "msg": "Business created",
    "data": {
        "name": "Business Name",
        "currency": "ngn",
        "email": "[email protected]",
        "type": "individual",
        "phonenumber": "08101851915",
        "uid": 156,
        "businessname": "Business Name",
        "status": "pending",
        "meta": {
            "notification": {
                "transaction": {
                    "push": true,
                    "email": true
                }
            }
        },
        "clientId": "c25d262a-d004-47b5-95c5-9d449f963241",
        "id": 930
    }
}