Solicitud de Débito Directo

Nivel de seguridad requerida para este servicio

Alto Alto (accessToken + mutual TLS + VPN)

Objetivo

Esta API permite generar una orden de débito sobre la cuenta de un cliente. Acepta solicitudes masivas por lote.

Request

POST Type request

/v2/apibank/collects/post-request

curl -X POST "https://$env/v2/apibank/collects/post-request" \
    -H 'Authorization: $YOUR_ACCESS_TOKEN'

env: Entorno de la API, como producción o desarrollo.
YOUR_ACCESS_TOKEN: Token obtenido en el servicio de autenticación.

Ejemplo de Cuerpo del Mensaje

JSON

"collections": [
    {
        "originId": 9302233455,
        "from": {
            "addressType": "CBU_CVU",
            "address": "0000000000000000000000",
            "owner": {
                "personIdType": "CUI",
                "personId": "23244825664"
            }
        },
        "body": {
            "currencyId": "032",
            "amount": 100,
            "description": "Cobro de factura",
            "concept": "VAR",
            "executionDate": "2025-04-12T10:00:00Z"
        },
        "smartCollect": false
    },
    {
        "originId": 9302233456,
        "from": {
            "addressType": "CBU_CVU",
            "address": "0000000000000000000000",
            "owner": {
                "personIdType": "CUI",
                "personId": "23244825664"
            }
        },
        "body": {
            "currencyId": "032",
            "amount": 100,
            "description": "Cobro de factura",
            "concept": "VAR",
            "executionDate": "2024-04-12T10:00:00Z"
        },
        "smartCollect": false
    }
]

originId: Es un identificador generado por vos para poder consultar el estado de la transacción. Este ID debe ser único. No procesaremos dos transacciones con el mismo identificador del cliente.
from: Contiene la información de tu cliente. La cuenta desde donde se realizará la cobranza.
addressType: Tipo de identificador de cuenta. Utilizar unicamente "CBU_CVU".
address: Es el numero de CBU o CVU de la cuenta.
owner: Contiene información del titular de la cuenta.
personIdType: Tipo de identificador de la persona. Utilizar unicamente "CUI".
personId: Numero de CUIT o CUIL de la persona (humana o jurídica).
body: Contiene información relacionada con el debito a realizar.
currencyId: Utilizar 032 para Peso Argentino.
amount: Importe a debitar.
description: Es un mensaje o descripción que se enviara por la red y podría ser visto por el destinatario.
concept: es el código de concepto establecido por BCRA.
executionDate: Fecha y hora en que se ejecutará la cobranza.
smartCollect: Setea el valor de la pripiedad SmartColect. Por defecto "false"

¿Que es SmartCollect?

SmartCollect es un servicio que utiliza inteligencia artificial para determinar cual es el mejor horario del día para tener éxito en la ejecución de la cobranza. Esta método incrementa las posibilidades de cobros exitosos. Establecer esta propiedad en "true" activa el servicio y su costo es el doble al de una solicitud normal.

Todos los filtros son opcionales. En caso de no enviar ningún parámetro, esta consulta devolverá por defecto las últimas 100 movimientos.

Ejemplo de Respuestas:

200 OK

{
    "status": "accepted",
    "requestId": "BDC-324F2349D22F0112"
}

Información adicional sobre campos

requestId: Cuando una tarea es aceptada genera un identificador único de solicitud.

Este servicio es asincrónico. Puede consultarse el estado de cada cobro solicitado consultando "Consultar una solicitud"

Introducción Consultar una solicitud