Returns the account's deposit address on Polygon, issuing it on the first call; every later call returns the same address, which stays the account's for good. Send only the account's coin to it (USDC to the USDC account, USDT to the USDT account): another token is not credited.

What arrives is credited to the account less the deposit fee, in full cents, usually within minutes: the virtual_iban.crypto_deposit.credited webhook and GET …/crypto-accounts/history show the amount credited. Transfers smaller than minimum wait on the address and are credited together once they add up to it.

Offered when the account says deposit.enabled: true; otherwise 403 capability_disabled (Payca enables it for you on request). If the address cannot be issued right now the answer is 403 withdrawal_unavailable with a detail; repeat the call shortly.

Parameters

NameInTypeRequiredDescription
companyId path string (uuid) yes

Your company that Payca enabled for Virtual IBAN.
accountId path string (uuid) yes

The id of one of your crypto accounts, from GET …/crypto-accounts.

Responses

StatusBodyDescription
200 object

The address.
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).

Specification

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