API Banco (BaaS)
Sub-cuentas CVU
Crear sub-cuenta CVU

Crear Nueva Sub-cuenta (CVU)

Nivel de seguridad requerida para este servicio

Muy Alto  Muy Alta (accessToken + mutual TLS + HMAC + VPN)

Objetivo

Este servicio crea una nueva sub-cuenta CVU.

Los movimientos de fondos relacionados con esta sub-cuenta, podrás visualizarlos dentro de los movimientos de la cuenta recaudadora. Podrás identificar esta cuenta consultando el servicio "Listar Cuentas Bancarias". La cuenta recaudadora tendrá la propiedad parent_account = true.

Encontrarás en sus movimientos un nodo llamado thisSubAccount el cual incluye la información de la sub-cuenta relacionada.

ℹ️

Importante: Si no sos Proveedor de Servicios de Pago (PSP) registrado ante BCRA, solo podrás crear sub-cuentas (CVU) de tu misma titularidad. Te será muy útil para automatizar la imputación de tus cobros y darle más herramientas de pago a tus clientes.

Request

Method: POST
/v2/apibank/sub-account
curl -X POST "https://$env/v2/apibank/sub-account" \
    -H 'Authorization: $YOUR_ACCESS_TOKEN' \
    -H "Content-Type: application/json" \
    -d "$requestBody"

Ejemplo de Cuerpo del Mensaje

JSON Request Body
{
    "originId": 45331,
    "label": "23244825664.TP",
    "owner": {
        "personIdType": "CUI",
        "personId": "23244825664"
    },
    "currency": "032"
}

Información adicional sobre campos

  • originId: Es un ID numérico único generado por el usuario del servicio. Te permite identificar la cuenta con una referencia propia
  • personIdType:
  • currency:
  • label (opcional): Es el alias que se asignará a la cuenta. En caso de enviar NULL o si el alias solicitado no pueda ser asignado, se asignará un alias genérico automáticamente.

Ejemplo de Respuestas:

JSON Response Body
{
    "accountId": "ARG-00432-00100325985003",
    "accountType": "VIRTUAL_ACCOUNT",
    "accountLabel": "23244825664.TP",
    "accountRouting": {  
        "addressType": "CBU_CVU",
        "address": "7159872511100058430757"
    },
    "owners": [
        {
            "ownerId": "23244825664",
            "ownerIdType": "CUI",
            "ownerName": "Charleen Alvara",
            "ownerPersonType": "INDIVIDUAL"
        }
    ],
    "info": {
        "status": "ACTIVE",
        "networks": ["COELSA"],
        "currencies": ["032"]
    },
    "entityRouting": {
        "entityType": "ADMIN_PSP",
        "entityName": "PSP Americano  S.A.",
        "entityCode": "4300"
    }
}
Movimientos de cuentaActualizar sub-cuenta