Skip to main content
POST
Transfer card balance to another card

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

Trio-Version
enum<string>
required

Version of the v2 contract the client is written against. Each breaking change publishes a new version.

Available options:
2026-10-19.v2
Trio-Target-Org-Id
string<uuid>

ID of another org to act on instead of the API key's own org. The key's org must have been granted access to it, and the request is refused with 403 FORBIDDEN otherwise. When that access or the API key is read-only, only GET and HEAD requests may carry it. When the target org requires mTLS, so does the request. Leave it out to act on the key's own org.

Path Parameters

id
string<uuid>
required

ID of the card the balance leaves Unique identifier

Body

application/json

Transfer Card Balance

Moves balance from the card in the path to to_card_id

amount
V2 card amount params · object
required

Amount of money to move, in cents

Example:
entity_id
string<uuid>
required

ID of the entity that holds both cards

to_card_id
string<uuid>
required

ID of the card that receives the balance

Response

Transferred