Initiate Payment

Use this endpoint to initiate a new payment transaction with either BENEFIT or MASTERCARD.

🚀 Endpoint Overview

Method	URL
POST	`https://init-vpay.venlabs.link/merchant/initiate-payment`

Use this endpoint to begin a new payment session and receive a redirect link for the user.

{
    "merchant_id": 160,
    "payment_provider":"mastercard",
    "amount": 10
}

Field Name	Type	Required	Description
`payment_provider`	string	✅	The payment provider (`BENEFIT` or `MASTERCARD`)
`amount`	float	✅	Transaction amount (e.g., `100.50`)
`merchant_id`	string	✅	Merchant_id (e.g., 12003)

{
  "redirect_url": "https://benefit.example/pay?token=abc123 ",
  "track_id": "324njl-23oijid-nvniroi3-lndksd"
}

Status Code	Description
400	Invalid payment provider or missing merchant configuration
500	Internal server error

⚠️ Make sure the merchant has configured credentials for the selected payment provider in advance.

After initiating a payment, you can check its status using the /payment-status endpoint.