Moves EUR from the IBAN balance to your own active EUR account, at once and without a fee, when transfers are enabled for you (capabilities.transfer; otherwise 403 capability_disabled). Only this direction is possible: the IBAN balance is funded by incoming SEPA payments, not by transfers. Not enough money on the IBAN balance is banking_rejected.

Retries are safe with the same Idempotency-Key.

Parameters

NameInTypeRequiredDescription
companyId path string (uuid) yes

Your company that Payca enabled for Virtual IBAN.
Idempotency-Key header string yes

Your unique key for this operation, 1–128 characters.

Request body

application/json · object · required

FieldTypeRequiredDescription
amount VirtualIbanAmount yes
toAccountId string (uuid) yes

Your active EUR account to credit.

Responses

StatusBodyDescription
200 object

Transfer done.
400 VirtualIbanError

The request was refused; code says why (see errors).
401 —

Missing or invalid x-client-id / x-client-secret (no body).
403 VirtualIbanError

The request was refused; code says why (see errors).
404 VirtualIbanError

The request was refused; code says why (see errors).
409 VirtualIbanError

The request was refused; code says why (see errors).

Specification

This page is generated from the OpenAPI specification, which remains the authoritative machine-readable source.