Method
POST /v1/payments/bank/init
Body Parameters
Headers
string
Bearer token (workspace API key).
string
application/jsonRequest 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"
}'
const res = await fetch("https://api.voyantcloud.com/v1/payments/bank/init", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VOYANT_API_KEY}`,
"content-type": "application/json",
},
body: JSON.stringify({
wizardSessionId: "b1f7f7a0-220c-4f89-9d6d-0c0ae943a99d",
amount: 980,
currency: "EUR",
paymentId: "pm_wizard_123",
}),
})
const session = await res.json()
import os, requests
payload = {
"bookingId": "4a9a807e-5c7c-4f57-8e6d-2c6f1b1c5d10",
"amount": 1250,
"currency": "EUR",
"paymentId": "pm_20250301_001",
}
resp = requests.post(
"https://api.voyantcloud.com/v1/payments/bank/init",
headers={
"Authorization": f"Bearer {os.environ['VOYANT_API_KEY']}",
"content-type": "application/json",
},
json=payload,
)
session = resp.json()
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"
}
}
{ "error": "Provide bookingId or wizardSessionId", "requestId": "req_123" }
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.