Skip to main content
POST
/
transactions
Execute transaction
curl --request POST \
  --url https://api.example.com/transactions \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "referenceId": "PAY-123456",
  "postings": [
    {
      "source": "CUSTOMER:019bdb2a-960f-789d-8955-21720e6cdeee:019bdb2a-960f-789d-8955-21720e6cdeed:CURRENT",
      "destination": "INTERNAL:REVENUE:FEE",
      "amount": 10000,
      "currency": "EUR",
      "details": "Payment for invoice #67",
      "type": "CREDIT_TRANSFER"
    }
  ]
}
'
{
  "correlationId": "550e8400-e29b-41d4-a716-446655440000"
}

Headers

​
Idempotency-Key
string
required

Client-provided idempotency key. UUID v4 suggested, max 255 characters.

Maximum string length: 255
Pattern: \S

Body

application/json

Request to execute a transaction with one or more postings

​
referenceId
string
required

Reference identifier linking transaction to its origin. For payment-originated transactions, this contains the payment identification. Used to trace transactions back to their source system.

Pattern: \S
Example:

"PAY-123456"

​
postings
object[]
required

List of postings (debits and credits) that make up the transaction

Required array length: 1 - 100 elements

Response

Transaction execution request accepted

Response for accepted asynchronous requests

​
correlationId
string
required

Correlation identifier for tracking the request through events

Example:

"550e8400-e29b-41d4-a716-446655440000"

Last modified on February 10, 2026