Crear intención de compra dolar CCL

Productos en los que aplica:

Descripción

Crea una intención de compra de dolar CCL.

Endpoint

POST

/walletentidad-investment/v1/api/v1.201/IntencionCompraCCL

Request

idCuenta int
REQUIRED
Identificador de la cuenta.

monto double
REQUIRED
Monto en pesos argentinos que se desea comprar.

idExterno string
OPCIONAL
Identificador externo de la entidad. No puede existir más de una intención con el mismo idExterno.

montoEsperado string
OPCIONAL
Monto en dolares que se espera obtener por esta compra.
Resulta del cálculo: (monto - cargo) / precioDolar

precioDolar string
OPCIONAL
Precio de cotización de referencia de compra del dolar.

priceHash string
OPCIONAL
Código único que representa el precio fijado y su vencimiento. Se obtiene de Consulta cotización de dolar.
Sólo aplica para organizaciones que operen con el modelo Collect.

Ejemplo de request

Copy code

curl --location 'https://gw-staging-qrbind.epays.services/walletentidad-investment/v1/api/v1.201/IntencionCompraCCL' \
--header 'Content-Type: application/json' \
--header 'Cache-Control: no-cache' \
--header 'Authorization: {{access_token}}' \
--data '{
    "idCuenta": 276058,
    "monto": 70000,
    "idExterno": null,
    "montoEsperado": 54.74,
    "precioDolar": 1278.7711,
}'

Response

intencionId int
Identificador de la intención de compra de dólar CCL creada.

intencionEntidadId string
Identificador externo de la intención de compra de dólar CCL indicado por la entidad.

monto double
Monto en pesos argentinos que se solicitó comprar.

montoNeto double
Monto en pesos argentnos que se estima que finalmente se gastará contando gastos.

montoBruto double
Monto en pesos argentnos que se estima que finalmente se invertirá.

vueltoEstimado double
Monto estimado en pesos argentinos del vuelto a devolver al saldo de la cuenta en caso de concretarse la compra.

totalGastos double
Monto estimado correspondiente a comisiones y gastos incluídos en la operación.

gastosbroker double
Monto estimado correspondiente al arancel de nuestro procesador.

cargo double
Monto correspondiente a la comisión de Bind PSP. Es un porcentaje del monto original que se solicitó comprar.

precioDolar double
Precio de compra del dolar de referencia para esta operación.

precioDolarReferencia double
Precio de compra del dolar que nos informa nuestro procesador.

montoEsperado double
Monto esperado en dolares por la organización por esta compra, según el cálculo realizado con precioDolar.

montoAObtener double
Monto estimado en dolares a obtener luego de ejecutar esta operación.

fechaHoraVencimiento datetime
Fecha y horario de expiración de la intención de compra.

fechaHoraCreacion datetime
Fecha y horario de creación de la intención de compra.

fechaHoraFinalizacionIntencion datetime
Fecha y horario de fin de la operación esperada.

operacionTipoNombre string
Denominiación del tipo de operación financiera a ejecutarse con esta intención.

cuentaId int
Identificador de la cuenta.

horarioMercado boolean
Indica si al crearse la intención se encontraba dentro del horario de mercado o no.

estado string
Estado de la intención de compra.
Valores posibles:
- PENDIENTE : La intención de compra fue creada satisfactoriamente y está en espera de ser ejecutada.

priceHash string
Código único que representa el precio fijado y su vencimiento.
Sólo aplica para organizaciones que operen con el modelo Collect.

Ejemplo de response

HTTP 200

Creación de intención exitosa

Copy code

HTTP 200

Creación de intención exitosa

Copy code

HTTP 200

Creación de intención exitosa

Copy code

HTTP 422

Cuenta inválida

Copy code

HTTP 422

Cuenta inválida

Copy code

HTTP 422

Cuenta inválida

Copy code

HTTP 422

Cuenta deshabilitada

Copy code

HTTP 422

Cuenta deshabilitada

Copy code

HTTP 422

Cuenta deshabilitada

Copy code

HTTP 422

Identificador externo no existente

Copy code

HTTP 422

Identificador externo no existente

Copy code

HTTP 422

Identificador externo no existente

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

Changelog

29/01/2025 - Se agregan campos gastosBroker, cargo y precioDolarReferencia.

06/03/2025 - Se agrega campo opcional priceHash a request y response.

DEVELOPERS

Autenticación

Cobrar con QR dinámico

DEVELOPERS

DEVELOPERS

DEVELOPERS