Criar uma transação usando o modelo de bloco da v2

Error

A valid request URL is required to generate request examples

{
  "amount": "1500",
  "assetCode": "BRL",
  "createdAt": "2021-01-01T00:00:00Z",
  "credit": [
    "@person2"
  ],
  "debit": [
    "@person1"
  ],
  "deletedAt": "2021-01-01T00:00:00Z",
  "description": "Transaction description",
  "feesSkipped": false,
  "id": "00000000-0000-0000-0000-000000000000",
  "ledgerId": "00000000-0000-0000-0000-000000000000",
  "operations": [
    {
      "accountAlias": "@person1",
      "accountId": "00000000-0000-0000-0000-000000000000",
      "amount": {
        "value": "1500"
      },
      "assetCode": "BRL",
      "balance": {
        "available": "1500",
        "onHold": "500",
        "overdraftUsed": "130",
        "version": 2
      },
      "balanceAffected": true,
      "balanceAfter": {
        "available": "1500",
        "onHold": "500",
        "overdraftUsed": "130",
        "version": 2
      },
      "balanceId": "00000000-0000-0000-0000-000000000000",
      "balanceKey": "asset-freeze",
      "createdAt": "2021-01-01T00:00:00Z",
      "deletedAt": "2021-01-01T00:00:00Z",
      "description": "Credit card operation",
      "id": "00000000-0000-0000-0000-000000000000",
      "ledgerId": "00000000-0000-0000-0000-000000000000",
      "metadata": {},
      "organizationId": "00000000-0000-0000-0000-000000000000",
      "status": {
        "code": "ACTIVE",
        "description": "Active status"
      },
      "transactionId": "00000000-0000-0000-0000-000000000000",
      "type": "DEBIT",
      "updatedAt": "2021-01-01T00:00:00Z",
      "direction": "debit",
      "routeCode": "ROUTE-001",
      "routeDescription": "Settlement route for service charges",
      "routeId": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "organizationId": "00000000-0000-0000-0000-000000000000",
  "status": {
    "code": "ACTIVE",
    "description": "Active status"
  },
  "tracerSkipped": false,
  "updatedAt": "2021-01-01T00:00:00Z",
  "metadata": {},
  "parentTransactionId": "00000000-0000-0000-0000-000000000000",
  "routeId": "00000000-0000-0000-0000-000000000000"
}

{
  "code": "ERR-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

POST

transactions

block

Error

A valid request URL is required to generate request examples

{
  "amount": "1500",
  "assetCode": "BRL",
  "createdAt": "2021-01-01T00:00:00Z",
  "credit": [
    "@person2"
  ],
  "debit": [
    "@person1"
  ],
  "deletedAt": "2021-01-01T00:00:00Z",
  "description": "Transaction description",
  "feesSkipped": false,
  "id": "00000000-0000-0000-0000-000000000000",
  "ledgerId": "00000000-0000-0000-0000-000000000000",
  "operations": [
    {
      "accountAlias": "@person1",
      "accountId": "00000000-0000-0000-0000-000000000000",
      "amount": {
        "value": "1500"
      },
      "assetCode": "BRL",
      "balance": {
        "available": "1500",
        "onHold": "500",
        "overdraftUsed": "130",
        "version": 2
      },
      "balanceAffected": true,
      "balanceAfter": {
        "available": "1500",
        "onHold": "500",
        "overdraftUsed": "130",
        "version": 2
      },
      "balanceId": "00000000-0000-0000-0000-000000000000",
      "balanceKey": "asset-freeze",
      "createdAt": "2021-01-01T00:00:00Z",
      "deletedAt": "2021-01-01T00:00:00Z",
      "description": "Credit card operation",
      "id": "00000000-0000-0000-0000-000000000000",
      "ledgerId": "00000000-0000-0000-0000-000000000000",
      "metadata": {},
      "organizationId": "00000000-0000-0000-0000-000000000000",
      "status": {
        "code": "ACTIVE",
        "description": "Active status"
      },
      "transactionId": "00000000-0000-0000-0000-000000000000",
      "type": "DEBIT",
      "updatedAt": "2021-01-01T00:00:00Z",
      "direction": "debit",
      "routeCode": "ROUTE-001",
      "routeDescription": "Settlement route for service charges",
      "routeId": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "organizationId": "00000000-0000-0000-0000-000000000000",
  "status": {
    "code": "ACTIVE",
    "description": "Active status"
  },
  "tracerSkipped": false,
  "updatedAt": "2021-01-01T00:00:00Z",
  "metadata": {},
  "parentTransactionId": "00000000-0000-0000-0000-000000000000",
  "routeId": "00000000-0000-0000-0000-000000000000"
}

{
  "code": "ERR-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Autorizações

Authorization

string

header

obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Idempotency

string

Idempotency key to safely retry the create; an identical retry returns the original transaction

X-TTL

string

Idempotency slot TTL in seconds (default 300)

Corpo

application/json

Transaction request body. debits and credits are the two required, non-empty leg arrays of the transaction; one debit paired with many credits, or the reverse, is a valid request. Every leg names the organizationId and ledgerId its account belongs to; all of them must name the SAME pair, and that pair is the organization and ledger the transaction is created in. A request whose accounts name different pairs is rejected. asset, amount, description, code, routeId, operationRouteId and metadata sit alongside the two leg arrays, and amount is the transaction total that the legs' share expressions divide. Each leg array holds at most 500 legs.

amount

string

obrigatório

asset

string

obrigatório

credits

object[]

obrigatório

Required array length: 1 - 500 elements

Show child attributes

debits

object[]

obrigatório

Required array length: 1 - 500 elements

Show child attributes

code

string

description

string

metadata

object

Show child attributes

operationRouteId

string<uuid>

Exemplo:

"00000000-0000-0000-0000-000000000000"

routeId

string<uuid>

Exemplo:

"00000000-0000-0000-0000-000000000000"

Resposta

Created

amount

string | null

obrigatório

Exemplo:

"1500"

assetCode

string

obrigatório

Required string length: 2 - 10

Exemplo:

"BRL"

createdAt

string<date-time>

obrigatório

Exemplo:

"2021-01-01T00:00:00Z"

credit

string[] | null

obrigatório

Exemplo:

["@person2"]

debit

string[] | null

obrigatório

Exemplo:

["@person1"]

deletedAt

string<date-time> | null

obrigatório

Exemplo:

"2021-01-01T00:00:00Z"

description

string

obrigatório

Maximum string length: 256

Exemplo:

"Transaction description"

feesSkipped

boolean

obrigatório

Exemplo:

false

string<uuid>

obrigatório

Exemplo:

"00000000-0000-0000-0000-000000000000"

ledgerId

string<uuid>

obrigatório

Exemplo:

"00000000-0000-0000-0000-000000000000"

operations

object[] | null

obrigatório

Show child attributes

organizationId

string<uuid>

obrigatório

Exemplo:

"00000000-0000-0000-0000-000000000000"

status

object

obrigatório

Show child attributes

tracerSkipped

boolean

obrigatório

Exemplo:

false

updatedAt

string<date-time>

obrigatório

Exemplo:

"2021-01-01T00:00:00Z"

metadata

object

Show child attributes

parentTransactionId

string<uuid>

Exemplo:

"00000000-0000-0000-0000-000000000000"

routeId

string<uuid>

Exemplo:

"00000000-0000-0000-0000-000000000000"

Primeiros passos

Atual (v2)

Compatibilidade (v1)

Tratamento de erros

Criar uma transação usando o modelo de bloco da v2

Autorizações

Cabeçalhos

Corpo

Resposta