v1

latestOpenAPI 3.1.0MIT2026-07-22252442.9 KB

Transactions

Create Transaction Request (Cash Out)

Create a new transaction request from one of your accounts. This does not perform an on-chain/bank transfer. You may provide a webhookUrl to receive status updates.

📝 Required Fields

accountId: Your account ID to debit from
toCBU or toCVU: Recipient bank CBU/CVU (22 digits)
amount: Positive decimal number
Optional webhookUrl: URL to receive status updates

🔍 Validation Rules

Account must belong to the authenticated user
CBU must be a valid 22-digit number
Optional externalID must be unique per account if provided

post/transactions

Request body

accountIdstring uuid required

ID of the user's account to send funds from

fromNamestring

Name of the transaction sender

toNamestring

Name of the transaction recipient

fromCBUnumber

CBU (bank account number) of the sender

toCBUstring

Recipient CBU (22 digits). Provide either toCBU or toCVU.

toCVUstring

Recipient CVU (22 digits). Provide either toCBU or toCVU.

amountnumber required

Transaction amount (must be positive)

fromCUITnumber

CUIT/CUIL of the sender

toCUITnumber

CUIT/CUIL of the recipient

conceptstring

Transaction concept or description

externalDatestring date-time

Transaction date in your system (ISO 8601 format)

coelsaCodestring

Coelsa transaction code

dataobject

Additional JSON data for the transaction

webhookUrlstring uri

Optional webhook URL to receive status updates for this request

Example request

{
  "accountId": "550e8400-e29b-41d4-a716-446655440123",
  "fromName": "Juan Pérez",
  "toName": "María García",
  "fromCBU": 170001540000000020000,
  "toCBU": "1100015400000000000021",
  "toCVU": "0000003100012345678901",
  "amount": 15000.5,
  "fromCUIT": 20123456789,
  "toCUIT": 27987654321,
  "concept": "Payment for services",
  "externalDate": "2024-06-19T10:30:00Z",
  "coelsaCode": "COELSA123456",
  "data": {
    "reference": "REF-001",
    "category": "services",
    "metadata": {
      "source": "mobile_app",
      "version": "1.2.3"
    }
  },
  "webhookUrl": "https://client.example.com/webhooks/transaction-request"
}

Response

Transaction request created successfully

idstring uuid

Internal transaction request ID

externalIDstring

createdAtstring date-time

Example response

{
  "id": "789e0123-e89b-12d3-a456-426614174999",
  "externalID": "REQ-2024-001234",
  "createdAt": "2024-06-19T10:30:00Z",
  "status": "PENDING"
}