Enviar transferencia

Nivel de seguridad requerida para este servicio

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

Objetivo

Este servicio permite crear una solicitud de envío de dinero desde una de las cuentas. Las empresas que revistan condición de PSPCP, podrán enviar adicionalmente transferencias desde las sub-cuentas CVU propiedad de sus clientes.

Esta transacción es una solicitud asincrónica. Al crearse devuelve un estado actual. Si este no es un estado final, deberá consultarse nuevamente hasta obtener un estado definitivo.

La transferencia se solicita enviando un originId. Este es un dato interno que provee el usuario que consume la API y que le permiritá obtener el estado actual en caso de que el estado devuelto en su creación no haya sido un estado final.

Estados de la solicitud:

• CREATED
• IN_PROGRESS
• DELAYED
• COMPLETED*
• FAILED*

(*) Estados finales

En caso de no haber obtenido un estado final en la creación de la solicitud, deberá consultarse nuevamente siguiendo la siguiente metodología:

Si el estado obtenido es CREATED o IN_PROGRESS, deverá consultarse nuevamente en intervalos de 5 segundos hasta obtener un nuevo estado.

Si el estado obtenido es DELAYED, deberá consultarse nuevamente en intervalos mayores a 10 minutos.

Si el estado obtenido es FAILED, deberá realizarse la registración correspondiente para anular la operación. El estado FAILED indica que la solicitud no pudo ser completada y no será procesada en el futuro.

El servicio que deberás consumir para actualizar el estado de esta solicitud se denomina Obtener Movimiento.

Request

curl -X POST "https://$env/v2/apibank/movements/transfer-request" \
    -H 'Authorization: $YOUR_ACCESS_TOKEN' \
    -H "Content-Type: application/json" \
    -d "$requestBody"

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

Request Body (Ejemplo - $requestBody)

{
    "originId": 45331,
    "from": {
        "addressType": "CBU_CVU",
        "address": "0000000000000000000000",
        "owner": {
            "personIdType": "CUI",
            "personId": "23244825664"
        }
    },
    "to": {
        "addressType": "CBU_CVU",
        "address": "0000000000000000000000",
        "owner": {
            "personIdType": "CUI",
            "personId": "23244825664"
        }
    },
    "body": {
        "currencyId": "032",
        "amount": 100,
        "description": "Envío de dinero",
        "concept": "VAR",
    }
}

• 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 del titular de la cuenta que envia el dinero.

• 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.

• to: Contiene la información del titular de la cuenta a la que se envía el dinero.

• personIdType: Tipo de identificador de la persona. Utilizar unicamente "CUI".

• personId: Numero de CUIT o CUIL de la persona (humana o jurídica).

• 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.

Ejemplo de Respuestas:

{
    "id": "001343432423424234332",
    "status": "IN_PROGRESS",
    "counterparty": {
        "personId": "20036675544",
        "personIdType": "CUI",
        "personName": "Juan García",
        "accountRouting": {
            "addressType": "CBU_CVU",
            "address": "00000740000000000002"
        }
    },
    "details": {
        "type": "DEBIT_TRANSFER_SENT_CVU",
        "typeDescription": "Transferencia Enviada CVU",
        "originId": 243552,
        "network": "COELSA",
        "networkId": "Z63EMDN2E7JQWFVW5E7RA3",
        "postingDatetime": "2024-04-12T10:00:00Z",
        "completedDatetime": "2024-04-12T10:15:30Z",
        "amountCurrency": "032",
        "amount": 2500.5,
        "motiveCode": "ALQ",
        "message": "Alquiler del mes"
    },
    "thisSubAccount": {
        "owners": {
            "personId": "27025667757",
            "personIdType": "CUI",
            "personName": "Marta Martínez",
            "personType": "INDIVIDUAL"
        },
        "accountRouting": {
            "addressType": "CVU",
            "address": "0009401811100042119204"
        }
    }
}