Skip to main content

​
Method

POST /v1/payments/bank/init

​
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/bank/init \
  -H "Authorization: Bearer $VOYANT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "bookingId": "4a9a807e-5c7c-4f57-8e6d-2c6f1b1c5d10",
    "amount": 1250,
    "currency": "EUR",
    "paymentId": "pm_20250301_001"
  }'

​
Response

{
  "ok": true,
  "paymentSessionId": "psn_01J0NRC94RFPR0A8BXQJ2Q3V9S",
  "dueAt": "2025-03-06T10:25:14.000Z",
  "instructions": {
    "iban": "RO49AAAA1B31007593840000",
    "beneficiary": "Voyant Travel SRL",
    "reference": "BOOK-4a9a807e-5c7c-4f57-8e6d-2c6f1b1c5d10",
    "note": "Please include reference in transfer details"
  }
}
The endpoint is idempotent per paymentId. Repeated calls update the existing session, refresh the due date (default +5 days), and push the latest pricing metadata.