Skip to main content

​
Method

POST /v1/payments/start

​
Body Parameters

​
Headers

​
Authorization
string
Bearer token (workspace API key).
​
content-type
string
application/json

​
Request Example

curl -X POST https://api.voyantcloud.com/v1/payments/start \
  -H "Authorization: Bearer $VOYANT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "bookingId": "4a9a807e-5c7c-4f57-8e6d-2c6f1b1c5d10",
    "amount": 8450,
    "currency": "RON",
    "billing": {
      "email": "[email protected]",
      "firstName": "Ana",
      "lastName": "Ionescu"
    },
    "products": [
      { "name": "Summer Cruise", "price": 8450, "qty": 1 }
    ]
  }'

​
Response

{
  "url": "https://secure.mobilpay.ro/pay?orderId=ORDER-20250301-0001",
  "orderId": "ORDER-20250301-0001",
  "provider": "netopia"
}
The API uses the encrypted payment account matching the workspace + provider. For Netopia it also injects the notify URL (/v1/integrations/netopia/notify) and returns the hosted payment URL you must redirect the customer to.