Generate 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