Crear orden de venta

Productos en los que aplica:

QR ESTÁTICO

Descripción

Crea una orden de venta asociada a la caja indicada. Una orden de venta indica información específica que la billetera que lee el QR deberá considerar para poder instruir el pago.

El aplicativo trabaja con un QR estático por cada Comercio+Sucursal+Caja. El mismo puede ser de monto abierto o monto cerrado:

QR de monto abierto: Cuando una Billetera lo lee, debe ingresar el monto a pagar.
QR de monto cerrado: Cuando una Billetera lo lee, visualiza información de una compra con un cierto monto a pagar determinado previamente por el Comercio. Para cobrar con un QR de monto cerrado, el Comercio debe crear una orden de venta asociada a dicho QR. Esta orden de venta tendrá información general del cobro y el monto a cobrar.

Endpoint

POST

/bindentidad-transaction-v2/v2/api/v1.201/orden-venta-pendiente

Request

CodigoCaja string
— REQUIRED
Es el código de la caja en la cual se quiere crear la orden de venta.

fechaNegocio datetime
— REQUIRED
Es la fecha y hora en que se crea la orden de venta (UTC-3)

montoTotal decimal
— REQUIRED
Es el importe total a cobrar en el QR con la orden de venta.

moneda string
— REQUIRED
Es la moneda de la orden de venta.
Valores permitidos:
"ARS" : Pesos argentinos

tiempoExpiracion int
— OPTIONAL
Es el tiempo de expiración de la orden de venta en segundos. Una vez cumplido el tiempo de expiración, la orden de venta pasará a vencida y no podrá ser pagada.
Valores permitidos:
0 = mínimo
10000000 = máximo
Valor por defecto:
600

productos[] object
— OPTIONAL
Objeto con información sobre los ítems que incluye la orden de venta. Este dato es sólo informativo.

descripcion decimal
— OPTIONAL
Es el nombre o denominación de un ítem de la orden de venta. Este dato es sólo informativo.

monto decimal
— OPTIONAL
Es el importe de un ítem de la orden de venta. Este dato es sólo informativo y no se valida la sumatoria para el monto total.

Ejemplo de request

Copy code

curl -v -X POST "https://gw-staging-qrbind.epays.services/bindentidad-transaction-v2/v2/api/v1.201/orden-venta-pendiente" -H "Content-Type: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6IlQxU3QtZExUdnlXUmd4Ql82NzZ1OGtyWFMtSSJ9.eyJhdWQiOiJiNmQ1OTEyYi00ZTM0LTRmYjItOWYzMS0yNzEzZTEwYWY3NDUiLCJpc3MiOiJodHRwczovL2xvZ2luLm1pY3Jvc29mdG9ubGluZS5jb20vNjFlZjViODktOGRmMy00OTlkLThjMTMtMzhmZWQ1ZDA5YzcyL3YyLjAiLCJpYXQiOjE3MDA2MDY0MzYsIm5iZiI6MTcwMDYwNjQzNiwiZXhwIjoxNzAwNjEwMzM2LCJhaW8iOiJFMlZnWUtnSW1ac1l5SjdxbTVyejZILzZVekcxdzkxTC9NMStIUHdRZGVDVHZLUzZFVHNBIiwiYXpwIjoiMWVlZDNmMWQtZjY1Ny00NmI0LTg3MzYtYTcyYjFiNWUxYjc1IiwiYXpwYWNyIjoiMSIsIm9pZCI6IjEyMGJkMTQzLTY2YmYtNDU5Mi1hM2NlLWI3ZDA1MmUzYTlkNiIsInJoIjoiMC5BWDBBaVZ2dllmT05uVW1NRXpqLTFkQ2NjaXVSMWJZMFRySlBuekVuRS1FSzkwV2FBQUEuIiwicm9sZXMiOlsiR3JvdXAuRW50aXRpZXMiLCJYLUNsaWVudE5hbWUuUUEtMDUiLCJYLUVudGlkYWQuWiJdLCJzdWIiOiIxMjBiZDE0My02NmJmLTQ1OTItYTNjZS1iN2QwNTJlM2E5ZDYiLCJ0aWQiOiI2MWVmNWI4OS04ZGYzLTQ5OWQtOGMxMy0zOGZlZDVkMDljNzIiLCJ1dGkiOiIxbzJsbG5XcTEwLUt0UVF0N24wekFRIiwidmVyIjoiMi4wIn0.BZUFzGQG3MWXWhyTKpAuIEn1lzniYp3c5FXU4oNFntcwBPjG092QyOmZvxFDj6zLLf0oAClnFbiUfBhGL0RwajXnTnYoKgSPDdKZCvtLpWWfOZSSDKJz12sWvCFTtVLEltdkzJSBYts9YGCRj7xsbCpF6u8yjBafs-YUEFwvh8Uh1CqmTnwlVnT7sf75FaNFJTf22eBSUunUhFTnqTBAH65RSk4wZjJHL79_Mw_Z-DWU6_9_GuanEG6wlU1GMJDXUrcw8w_va8isHA7LEVPGAmkhen-BxxHeLL0km0Oi44YRBQlLeYcKsbN63V0a-hSYeYwg_APUqvkiu4SdVskpXQ" --data-raw "{
    \"codigoCaja\": \"B00000455196\",
    \"fechaNegocio\": \"2023-11-21\",
    \"montoTotal\": 100.79,
    \"moneda\": \"ARS\",
    \"tiempoExpiracion\": 120,
    \"productos\": [
{
\"descripcion\": \"BEBIDA\",
\"monto\": 80.00
},
{
\"descripcion\": \"ALIMENTO\",
\"monto\": 20.79
}
]
}
"

Response

idOrdenVenta int
Id de la orden de venta creada.

fechaExpiracion datetime
Fecha y hora en que se expirará la orden de venta. Es decir que a partir de ella, la orden de venta estará vencida y no podrá pagarse.

Ejemplo de response

HTTP 201

Creación exitosa

Copy code

HTTP 201

Creación exitosa

Copy code

HTTP 201

Creación exitosa

Copy code

HTTP 500

Caja inválida

Copy code

HTTP 500

Caja inválida

Copy code

HTTP 500

Caja inválida

Copy code

HTTP 400

Falta algún campo requerido

Copy code

HTTP 400

Falta algún campo requerido

Copy code

HTTP 400

Falta algún campo requerido

Copy code

HTTP 400

Monto inválido

Copy code

HTTP 400

Monto inválido

Copy code

HTTP 400

Monto inválido

Copy code

Descripción

Endpoint

Request

Ejemplo de request

Response

Ejemplo de response

API REFERENCE

Filtrar por producto:

QR ESTÁTICO

QR DINÁMICO

REC. X TRANSFERENCIA

BOTÓN SIMPLE

DISPOSITIVO POS

WALLET / PSP

Autenticación

Cobrar con QR estático

Cobrar con QR dinámico

Cobrar con botón de pagos

Cobrar con transferencia

Comercio

Comprobantes

Operaciones

Webhooks

Archivos batch

API REFERENCE