Skip to main content
POST
/
embedded-banking
/
v1
/
money-movements
/
book
Creates a book transfer (internal-to-internal) between bank accounts.
curl --request POST \
  --url https://api.sandbox.tesouro.com/embedded-banking/v1/money-movements/book \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 123,
  "fromBankAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "toBankAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "idempotencyKey": "<string>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": 123,
  "date": "2023-12-25",
  "fromBankAccount": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "nickname": "<string>"
  },
  "network": "BOOK",
  "status": "PENDING",
  "toBankAccount": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "nickname": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

Request model for initiating a book transfer between internal accounts.

​
amount
required

Amount to transfer. Must be greater than 0.

​
fromBankAccountId
string<uuid>
required

Source internal bank account identifier.

​
toBankAccountId
string<uuid>
required

Destination internal bank account identifier.

​
idempotencyKey
null | string

Optional idempotency key for preventing duplicate transfers. Maximum length: 256 characters.

Response

Transfer created successfully.

Response model for a money movement operation.

​
id
string<uuid>
required

Unique money movement identifier.

​
amount
required

Money movement amount.

​
date
string<date>
required

Money movement date.

​
fromBankAccount
object
required

Source bank account information.

​
network
enum<string>
required

Payment network: BOOK, ACH, RTP, or FED_NOW.

Available options:
BOOK,
ACH,
RTP,
FED_NOW
​
status
enum<string>
required

Money movement status.

Available options:
PENDING,
COMPLETED,
FAILED
​
toBankAccount
object
required

Destination bank account information.