Crear transferencia MEP

Inicia una transferencia en USD de fondos MEP desde una cuenta de cliente hacia una cuenta bancaria externa.

POST/v1/operations/usd-mep/transfers

Request

Headers

Campo	Tipo	Requerido	Descripción
Authorization	string	Sí	Token de acceso en formato Bearer ACCESS_TOKEN
Content-Type	string	Sí	Debe ser application/json

No aplica: Path Parameters, Query Parameters.

Body

Campo	Tipo	Requerido	Descripción
id	string	Sí	ID de idempotencia generado por el cliente para la transferencia.
account_id	string	Sí	Número de cuenta de cliente desde la que se transfieren los fondos.
amount	number	Sí	Monto a transferir, en USD.
cbu	string	Sí	CBU (Clave Bancaria Uniforme) de destino.
cuit	string	Sí	CUIT del titular de la cuenta de destino.
reference	string	Sí	Referencia/descripción libre para la transferencia.
bank_account_type_id	integer	Sí	Tipo de cuenta bancaria de destino. Valores posibles: 1 (Caja de Ahorro), 2 (Cuenta Corriente).

Response

2XX Éxito

Campo	Tipo	Descripción
id	string	ID de idempotencia generado por el cliente de la transferencia iniciada.
status	string	Estado actual de la transferencia. Valores posibles: SUCCESS, FAILED, PENDING_VERIFICATION, ERROR, WAITING_FOR_BALANCE, READY_TO_TRANSFER.
message	string	Mensaje legible que describe el resultado de la iniciación.

Códigos de error

Status	Descripción
400	Bad Request — parámetros inválidos o faltantes
401	Unauthorized — token de acceso inválido o faltante
403	Forbidden — el token no tiene permiso para acceder a este recurso
500	Internal Server Error

Estructura del error:

{
  "code": "BAD_REQUEST",
  "description": "Invalid request parameters"
}

Ejemplo de código

cURL

curl -X POST https://b2b.allaria.dev/v1/operations/usd-mep/transfers \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
    "account_id": "12345",
    "amount": 1000.00,
    "cbu": "0000003100000000000001",
    "cuit": "20345678901",
    "reference": "Retiro dolar MEP",
    "bank_account_type_id": 1
  }'

JavaScript

const response = await fetch('https://b2b.allaria.dev/v1/operations/usd-mep/transfers', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    id: '7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d',
    account_id: '12345',
    amount: 1000.00,
    cbu: '0000003100000000000001',
    cuit: '20345678901',
    reference: 'Retiro dolar MEP',
    bank_account_type_id: 1
  })
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.post(
  'https://b2b.allaria.dev/v1/operations/usd-mep/transfers',
  headers={
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  json={
    'id': '7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d',
    'account_id': '12345',
    'amount': 1000.00,
    'cbu': '0000003100000000000001',
    'cuit': '20345678901',
    'reference': 'Retiro dolar MEP',
    'bank_account_type_id': 1
  }
)
data = response.json()
print(data)

Node.js

const axios = require('axios');

const response = await axios.post(
  'https://b2b.allaria.dev/v1/operations/usd-mep/transfers',
  {
    id: '7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d',
    account_id: '12345',
    amount: 1000.00,
    cbu: '0000003100000000000001',
    cuit: '20345678901',
    reference: 'Retiro dolar MEP',
    bank_account_type_id: 1
  },
  {
    headers: {
      Authorization: 'Bearer ACCESS_TOKEN',
      'Content-Type': 'application/json'
    }
  }
);
console.log(response.data);

2XX Éxito

{
  "id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
  "status": "READY_TO_TRANSFER",
  "message": "Transfer initiated successfully"
}