post
https://api.myvendy.com/business
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
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 |
| 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
}
}