post https://api.vendy.money/webhooks/create-webhook
Log in to see full request history
Endpoint to create webhook on Vendy to which transaction updates will be sent.
Request:
| Query Parameter | Type | Description |
|---|---|---|
| businessId | string | Unique identifier for business |
| Field | Type | Description |
|---|---|---|
| url | String | Valid webhook url to which transaction webhooks are sent |
| allowedEvents | Enum(String) | Type of events that are sent to the webhook: 'all', 'transaction_failed', 'transaction_success', 'transaction_updated', 'payout_received', 'payout_cancelled', 'payout_failed', 'payout_completed' |
| retryStatus | Enum (String) | Describes if webhook should be retried/resent if failed: 'ENABLED', 'DISABLED' |
| secretHash | String | Valid Sha256 secret to be used to generate payload signature |
Example request
curl --location 'https://api.vendy.money/webhooks/create-webhook?businessId=1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
"url":"https://example.com/webhook",
"allowedEvents":"all",
"retryStatus":"ENABLED",
"secretHash":"ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad"
}'
Response:
| Field | Type | Description |
|---|---|---|
| status | Boolean | States if request was successfully executed or not |
| code | Integer | Internal code, success if 200 |
| msg | String | A description of the status of the request |
| data | Webhook | Newly created webhook details |
Example response
{
"code": "00",
"error": "success",
"data": {
"allowedEvents": "all",
"clientId": "39a1e4bf-fbc3-4b78-9555-c50f8cfa17bw",
"created": "2022-08-24T07:05:40.432Z",
"id": "39a1e4bf-fbc3-4b78-9555-c50f8cfa17bw",
"retryStatus": "ENABLED",
"secretHash": "ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad",
"updated": "2022-08-24T07:05:40.432Z",
"url": "https://example.com/webhook"
},
"status": true
}
Responses