Set Notification (Webhook) URL

POST

/api/v1/virtual-accounts/set-notification-url

Register the HTTPS URL VantPay POSTs collection notifications to. Optional authToken is echoed as 'Authorization: Bearer ' on each notification so you can verify the source. See the CollectionNotification schema for the payload VantPay will send. Deduplicate on transactionRef.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Webhook URL saved.

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://merchantapi-dev.vantpay.io/api/v1/virtual-accounts/set-notification-url' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "notificationUrl": "https://your-domain.example/webhooks/vantpay",
    "authToken": "string",
    "prefix": "string"
}'

Response Example

{
    "isSuccessful": true,
    "code": "00",
    "message": "Operation successful",
    "data": null
}

Modified at 2026-09-10 13:32:03

Get Wallet Balance

Collection Notification (received by YOU, not called by you)