1. V3 - Transaction
Cresium
  • Cresium - V3 Partners
    • API
      • Auth Information for V3 API Partners
      • V3 - Health
        • Health check
      • V3 - Transaction
        • Get Transaction data
          GET
        • Search transactions
          GET
        • Make a transfer
          POST
        • Confirm a transaction
          PUT
        • Reverse a deposit transaction
          POST
        • Get transaction receipt
          GET
      • V3 - BankAddress
        • Get Address
      • V3 - CompanyFeature
        • Get Company Features
        • Update Feature Enabled State
      • V3 - Rate
        • Get TNA rate
      • V3 - DepositAddress
        • Update Deposit Address
        • Create Deposit Address
      • V3 - Invoice
        • Create Invoices
        • Read Invoices
      • V3 - Partner
        • Search partner transactions
      • V3 - User Address
        • Create or get User Address
      • V3 - Auth
        • V3 - Balance
          • Get all wallets for Company
        • Generate change password ID for partner user
      • V3 - CompanyTax
        • Upsert Company Tax
      • V3 - Signature Request
        • Create Signature Request
        • Update Signature Request
      • V3 - Payment
        • Create Payments
        • Read Payments
      • Webhooks
        • Auth Information for Webhooks
        • Transactions Events Examples - DEPOSIT
  1. V3 - Transaction

Make a transfer

POST
/v3/transaction/preview
Crea una transferencia de fondos (retiro/withdrawal).

Restricciones importantes#

Solo se permiten transferencias mismo nombre (SAME NAME). El titular de la cuenta destino debe coincidir con el de la company.
El toId es el id de la Address destino, que se obtiene consultando el endpoint GET /v3/bank-address/:value con el CBU/CVU/Alias destino. El campo id de la respuesta de BankAddress es el valor a usar como toId.

Body Parameters#

CampoTipoRequeridoDescripcion
toIdnumberSiID de la Address destino (obtenido de BankAddress API)
amountstringSiMonto a transferir (usar string para precision decimal)
currencyCodeenumSiMoneda: ARS o USD
tagenumNoEtiqueta: SALARY, SUPPLIER, SERVICE, RENTAL, etc.
sendingDatestringNoFecha programada (ISO 8601). Si no se envia, se procesa inmediatamente
descriptionstringNoMotivo/concepto de la transferencia

Flujo de la transaccion#

1.
Se crea la transaccion en estado PREVIEW
2.
Debe confirmarse con PUT /v3/transaction/confirm/{id} o crear una Signature Request con POST /v3/signature-request/TRANSACTION_REQUEST para que sea aprobada por un signer
3.
Una vez confirmada, pasa a PENDING y se procesa automaticamente

Respuesta#

{
  "transaction": { ... },
  "requires2FA": false
}
El campo requires2FA indica si la transaccion requiere verificacion de dos factores.

Errores posibles#

INVALID_AMOUNT: Monto invalido o negativo
INVALID_CURRENCY: Moneda no soportada
MISSING_WALLET: No existe wallet para la moneda indicada
INSUFFICIENT_FUNDS: Fondos insuficientes
INVALID_TRANSACTION: Transferencia no es mismo nombre

Request

Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
Successful response
Body

🟠400Bad Request
🟠401Unauthorized
🔴500Internal Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.develop.cresium.app/v3/transaction/preview' \
--header 'Content-Type: application/json' \
--data-raw '{
    "toId": 0,
    "amount": "string",
    "currencyCode": "ARS",
    "tag": "RENTAL",
    "sendingDate": "2019-08-24T14:15:22.123Z",
    "description": "string"
}'
Response Response Example
200 - Example 1
{
    "data": {
        "transaction": {
            "id": 0,
            "type": "DEPOSIT",
            "status": "PREVIEW",
            "externalId": "string",
            "currencyId": 0,
            "currency": {
                "symbol": "string",
                "code": "ARS",
                "image": "string",
                "decimals": 0
            },
            "fromId": 0,
            "toId": 0,
            "from": {
                "id": 0,
                "type": "CVU",
                "value": "string",
                "bankName": "string",
                "ownerName": "string",
                "img": "string",
                "uuid": "string"
            },
            "to": {
                "id": 0,
                "type": "CVU",
                "value": "string",
                "bankName": "string",
                "ownerName": "string",
                "img": "string",
                "uuid": "string"
            },
            "companyId": 0,
            "collaboratorId": 0,
            "collaborator": {
                "id": 0,
                "firstName": "string",
                "lastName": "string",
                "image": "string",
                "email": "string",
                "role": "OWNER",
                "phone": "string",
                "birthDate": "2019-08-24T14:15:22.123Z",
                "status": "CREATED"
            },
            "walletId": 0,
            "tag": "RENTAL",
            "createdAt": "2019-08-24T14:15:22.123Z",
            "updatedAt": "2019-08-24T14:15:22.123Z",
            "processedAt": "2019-08-24T14:15:22.123Z",
            "totalAmount": 0,
            "netAmount": 0,
            "bulkTransactionId": 0,
            "amounts": [
                {
                    "id": 0,
                    "transactionId": 0,
                    "type": "FEE",
                    "amount": 0,
                    "key": "string"
                }
            ],
            "recipients": [
                {
                    "type": "EMAIL",
                    "value": "string"
                }
            ],
            "billPayment": {
                "companyName": "string",
                "debtIdentifier": "string",
                "expirationDate": "string"
            },
            "sendingDate": "2019-08-24T14:15:22.123Z",
            "depositAddress": {
                "id": 0,
                "type": "CVU",
                "value": "string",
                "externalId": "string",
                "currencyId": 0,
                "currency": {
                    "symbol": "string",
                    "code": "ARS",
                    "image": "string",
                    "decimals": 0
                },
                "bankProvider": {
                    "name": "BIND",
                    "img": "string"
                },
                "wallet": {
                    "id": 0,
                    "balance": 0,
                    "lockedBalance": 0,
                    "investedBalance": 0,
                    "availableBalance": 0,
                    "currency": {
                        "symbol": "string",
                        "code": "ARS",
                        "image": "string",
                        "decimals": 0
                    },
                    "companyId": 0
                },
                "hasEcheqs": true
            },
            "description": "string",
            "rawData": null
        },
        "requires2FA": true
    }
}
Modified at 2026-02-20 14:08:41
Previous
Search transactions
Next
Confirm a transaction
Built with