Realizar Transferencia

Productos en los que aplica:

Descripción

Realizar una transferencia saliente a un CBU, CVU o alias.

Si se crea una transferencia con un origin_id ya existente, no se crea una nueva y se devuelve la información de la original.

Si se crea una transferencia con un origin_id ya existente, no se crea una nueva y se devuelve la información de la original.

Si se crea una transferencia con un origin_id ya existente, no se crea una nueva y se devuelve la información de la original.

Endpoint

POST

/cvucollectentidad-financial/v1/v1.201/banks/322/accounts/owner/transaction-request-types/TRANSFER/transaction-requests

Request

origin_id string
REQUIRED
Identificador unívoco de la transacción definido por el usuario.. Si se envía un identificador existente devuelve la información de dicha transacción.
Máximo 15 caracteres.

to object
REQUIRED
Objeto con información del destinatario.

to.cbu string
OPTIONAL
CBU o CVU del destinatario. Requerido si no se envía alias.

to.alias string
OPTIONAL
Alias del destinatario. Requerido si no se envía cbu.

value object
REQUIRED
Objeto con información del importe de la transferencia.

to.currency string
REQUIRED
Moneda de la transacción.
Valores permitidos:
Pesos = "ARS"

to.amount double
REQUIRED
Importe de la transferencia.

description string
OPTIONAL
Descripción de la transacción (Máximo 100 caracteres). Valor por defecto: "Varios"

concepto string
REQUIRED
Concepto.
Valores permitidos:
"ALQ" (Alquiler)
"CUO" (Cuota)
"EXP" (Expensas)
"FAC" (Factura)
"PRE" (Préstamo)
"SEG" (Seguro)
"HON" (Honorarios)
"HAB" (Haberes)
"VAR" (Varios)
Valor por defecto: "VAR"

emails array
OPTIONAL
Array de strings con la lista de emails de los destnatarios a enviar un comprobante de la transferencia. Este comprobante tiene un template fijo del Banco Industrial.


Ejemplo de request

Copy code

curl --location 'https://gw-staging-qrbind.epays.services/cvucollectentidad-financial/v1/v1.201/banks/322/accounts/owner/transaction-request-types/TRANSFER/transaction-requests' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 1234567iOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6ImltaTBZMnowZFlLeEJ0dEFxS19UdDVoWUJUayJ9.eyJhdWQiOiJiNmQ1OTEyYi00ZTM0LTRmYjItOWYzMS0yNzEzZTEwYWY3NDUiLCJpc3MiOiJodHRwczovL2xvZ2luLm1pY3Jvc29mdG9ubGluZS5jb20vNjFlZjViODktOGRmMy00OTlkLThjMTMtMzhmZWQ1ZDA5YzcyL3YyLjAiLCJpYXQiOjE3NDAxNTQwMTIsIm5iZiI6MTc0MDE1NDAxMiwiZXhwIjoxNzQwMTU3OTEyLCJhaW8iOiJBU1FBMi84WkFBQUF3RXhOTno2WHNhamVYeStEclNSN3psSzJRL2U1ZmZsekdubkg0OFR3OVA0PSIsImF6cCI6ImVjZmM3NGUwLTNiZmEtNDkzYi04MmFiLTg5ZjdhZTJiYTg0ZiIsImF6cGFjciI6IjEiLCJvaWQiOiIzMDVmYzBhYi0yZWFkLTQ1YzMtYWUxMS0xYjMxM2YzN2JkYzYiLCJyaCI6IjEuQVgwQWlWdnZZZk9OblVtTUV6ai0xZENjY2l1UjFiWTBUckpQbnpFbkUtRUs5MFdhQUFCOUFBLiIsInJvbGVzIjpbIlgtRW50aWRhZC4yIiwiWC1DbGllbnROYW1lLmp1YW5AbGlyaXVtLmNvbSIsIkdyb3VwLkVudGl0aWVzIl0sInN1YiI6IjMwNWZjMGFiLTJlYWQtNDVjMy1hZTExLTFiMzEzZjM3YmRjNiIsInRpZCI6IjYxZWY1Yjg5LThkZjMtNDk5ZC04YzEzLTM4ZmVkNWQwOWM3MiIsInV0aSI6ImlpMHUxZnFOZ1V1OU02cWNBMW1uQUEiLCJ2ZXIiOiIyLjAifQ.L3_N9i5EQK6kzvSkWl69yyMNR2gqjXKFxuePiTcV9KctNiuGm2HV-DzxuOLipA2usAV2YsjwDySfZyUm_4VoCVUFOeeTKBoG7dUG6vX7L2KzDddc_uCkhTKDGv1Xnj2r6EbzROpE4dSoCf2bvfLSkvHDnUiv5Eowe0RAdR9VcOqTx7oVLwaicQqCiEr1x_XKxoQUgICvqrC9bai-HBR7iu_RcqSVy9w7rRaBPlNsstk6qc8uNRk96S4gvbgmaoGslaS3SNpFKWnvrvMJxXTo9jPlAnu5V8Vx_aO4e9Cv3kT7VatgANGQQivg6AYFbErnmlUvFfHM-jfRGKUD8yozrw' \
--data-raw '{
  "origin_id": "T0291220231",
  "to": {
    "cbu": "0000532608170000000011",
    "alias": null
  },
  "value": {
    "currency": "ARS",
    "amount": 29
  },
  "description": "primary",
  "concept": "VAR",
  "emails": [
    "email@gmail.com"
  ]
}'

Response

id string
Identificador de la transacción.

type string
Tipo de operación.
Valor por defecto: "TRANSFER"

from object
Objeto con información de la cuenta origen.

from.bank_id string
Código identificador del banco.

from.account_id string
Identificador de la cuenta en el banco.

counterparty object
Objeto con información del destinatario.

counterparty.id string
Identificador del tercero. Si no está disponible, no se envía.

counterparty.name string
Nombre del tercero. Si no está disponible, no se envía.

counterparty.type string
Tipo. Normalmente "CUIT_CUIL" Si no está disponible, se envía "UNAVAILABLE".

counterparty.bank_routing object
Objeto con información del banco de la cuenta destino.

counterparty.bank_routing.scheme string
Tipo de dato, valor default "NAME" Si no está disponible, se envía "UNAVAILABLE".

counterparty.bank_routing.address string
Nombre del banco de la cuenta destino.

counterparty.bank_routing.code string
Código del banco de la cuenta destino.

counterparty.account_routing object
Objeto con información de la cuenta destino.

counterparty.account_routing.scheme string
Tipo de dato. Valores posibles: "LABEL" y "CBU". Si no está disponible, se envía "UNAVAILABLE".

counterparty.account_routing.address string
CBU, CVU o alias de la cuenta destino.

details object
Objeto con información adicional de la transferencia.

details.origin_id string
Identificador unívoco de la transacción definido por el usuario.

transaction_ids array
Array de strings con la lista de ids de procesamiento de la transferencia. Entre ellos está el id del banco y el id de Coelsa.

status string
Estado de la transferencia.
El estado UNKNOWN se produce cuando hubo un error de comunicación con algún sistema externo, el mismo tratará de actualizarse durante el día. En el caso de una transferencia a un CVU, inicialmente quedan en estado IN_PROGRESS, este estado se intentará resolver durante el día o al final del mismo cuando se concilien todas las operaciones. El estado UNKNOWN_FOREVER indica que la operación no pudo resolver el estado, y no se va a reintentar actualizar en forma automática. Los estados COMPLETED o FAILED son estado finales que indican que la operación se completó o falló.
Valores posibles:
"COMPLETED" (Completada)
"PENDING" (Pendiente de firma)
"IN_PROGRESS" (En curso)
"UNKNOWN" (Desconocido)
"FAILED" (Con error)
"UNKNOWN_FOREVER" (Desconocido y no se va a reintentar actualizar)

start_date datetime
Fecha y hora de comienzo de transacción.

end_date datetime
Fecha y hora de finalización de transacción.

charge object
Objeto con información de los cargos de la transferencia.

charge.summary string
Resumen de la descripción de la transferencia.

charge.value object
Objeto con información del importe de la transferencia.

charge.value.currency string
Moneda de la transacción.
Valores posibles:
Pesos = "ARS"

charge.value.amount double
Importe de la transferencia.

Ejemplo de response

HTTP 200

Creación exitosa

Copy code

HTTP 200

Creación exitosa

Copy code

HTTP 200

Creación exitosa

Copy code

HTTP 422

origin_id tiene más de 15 caracteres

Copy code

HTTP 422

origin_id tiene más de 15 caracteres

Copy code

HTTP 422

origin_id tiene más de 15 caracteres

Copy code

HTTP 401

Token de autenticación inválido

Copy code

HTTP 401

Token de autenticación inválido

Copy code

HTTP 401

Token de autenticación inválido

Copy code

DEVELOPERS

Listado de API disponibles para

QR INTEROPERABLE

REC. X TRANSFERENCIA

BOTÓN SIMPLE

DISPOSITIVO POS

WALLET / PSP

ONBOARDING

LIQUIDADOR

Autenticación

Cobrar con QR dinámico

DEVELOPERS

DEVELOPERS

DEVELOPERS