---
title: "Send payment"
method: POST
path: "/v3/ledger/transaction"
tags: ["Transaction"]
---

# Send payment

`POST /v3/ledger/transaction`

## Request

- Base URL: `https://api.tatum.io`
- URL: `https://api.tatum.io/v3/ledger/transaction`
- Auth: API key in header `x-api-key`

/v3/ledger/transaction

#### 4 credits per API call.

  

Sends a payment within Tatum Private Ledger. All assets are settled instantly.  
When a transaction is settled, 2 transaction records are created, 1 for each of the participants. These 2 records are connected via a transaction reference, which is the same for both of them.  
This method is only used for transferring assets between accounts within Tatum and will not send any funds to blockchain addresses.  
If there is an insufficient balance in the sender account, no transaction is recorded.  
It is possible to perform an anonymous transaction where the sender account is not visible for the recipient.  
The FIAT currency value of every transaction is calculated automatically. The FIAT value is based on the accountingCurrency of the account connected to the transaction and is available in the marketValue parameter of the transaction.

## Request body

- CreateTransaction
  - `senderAccountId` string, required: Internal sender account ID within Tatum platform
  - `recipientAccountId` string, required: Internal recipient account ID within Tatum platform
  - `amount` string, required: Amount to be sent.
  - `anonymous` boolean: Anonymous transaction does not show sender account to recipient, default is false
  - `compliant` boolean: Enable compliant checks. Transaction will not be processed, if compliant check fails.
  - `transactionCode` string: For bookkeeping to distinct transaction purpose.
  - `paymentId` string: Payment ID, External identifier of the payment, which can be used to pair transactions within Tatum accounts.
  - `recipientNote` string: Note visible to both, sender and recipient
  - `baseRate` number: Exchange rate of the base pair. Only applicable for Tatum's Virtual currencies Ledger transactions. Override default exchange rate for the Virtual Currency.
  - `senderNote` string: Note visible to sender

## Response `200`

OK

- TransactionResult
  - `reference` string: The internal reference to the transaction (a unique identifier of the transaction within the virtual account); if the transaction fails, use this reference to search through the logs

## Other responses

- `400`: Bad Request
- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403`: Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
- `500`: Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.dev/tatum/apis/virtual-accounts.md) - [All operations](https://skmtc.dev/tatum/apis/virtual-accounts/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/virtual-accounts/revisions/ba220553084b?raw)