post https://api.vendy.money/transactions/payment-url
Endpoint to initiate transactions on Vendy.
Request:
Field | Type | Description |
---|---|---|
businessId | Integer | Merchant registered business Id. |
amount | Double | The amount being debited. |
msisdn | String | A valid identification phone number that is linked to a specific network. |
Example request
curl --location 'https://api.vendy.money/transactions/initiate' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqd3RpZCI6Ijc1NWU5Njg4LTk1NzgtNGYyZi05NTM3LTQ3NDFhYzIzYjEyZSIsImlhdCI6MTY4NTM2MTE0NCwiZXhwIjoxNjg2NTcwNzQ0LCJpc3MiOiJodHRwczovL3ZlbmR5Lm1vbmV5LmNvbS8iLCJqdGkiOiI3NTVlOTY4OC05NTc4LTRmMmYtOTUzNy00NzQxYWMyM2IxMmUifQ.sOp2MGo9HLeytMmSpS3XAOQlJ84jPxZcPnp9OipClwOcxHoTNcYR-Vnmw1tEJdw5X62gF3B0z8ZN_dr4uCKPTRZnPE22NiL45y0467A0Dkxrnag3LgUic8jp0sdpKakYxnFvC7uKJQSP52BEYTpC8EPG8bYogH0V6jHWtpCJcPU' \
--data '{
"businessId":1,
"amount":100,
"msisdn":"+2348101851915"
}'
Response:
Field | Type | Description |
---|---|---|
status | Boolean | States if the request was successfully executed or not |
code | Integer | Internal code, success if 200 |
msg | String | A description of the status of the request |
data | Object | Newly generated URL and related data |
Example response
{
"status": true,
"code": 200,
"data": {
"ref": "7d4-98dc",
"url": "https://checkout.vendy.money/test_7d4-98dc",
"businessID": 6
}
}
Possible errors;
Error code | Description |
---|---|
326 | Business not found |