Skip to main content
POST
/
embedded-banking
/
v1
/
money-movements
/
ach
Creates an ACH money movement.
curl --request POST \
  --url https://api.sandbox.tesouro.com/embedded-banking/v1/money-movements/ach \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 123,
  "fromBankAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "secCode": "<string>",
  "toBankAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "type": "INTERNAL_TO_EXTERNAL",
  "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 an ACH money movement.

​
amount
required

Amount to transfer. Must be greater than 0.

​
fromBankAccountId
string<uuid>
required

Source bank account identifier.

​
secCode
string
required

SEC code for the ACH transaction. Valid values: PPD (consumer), CCD (business), WEB (internet), CTX (corporate trade exchange), IAT (international).

​
toBankAccountId
string<uuid>
required

Destination bank account identifier.

​
type
enum<string>
required

Type of ACH money movement.

Available options:
INTERNAL_TO_EXTERNAL,
EXTERNAL_TO_INTERNAL,
INTERNAL_TO_INTERNAL
​
idempotencyKey
null | string

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

Response

Money movement 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.