MÓDULOS

Puntos de Venta

8min
las siguientes apis te permitirán interactuar con tus puntos de venta y solicitar operaciones de pago el device del pos se puede obtener en la pantalla de configuración => información del sistema => referencia o tomando el serial number del dispositivo ( etiqueta en la parte posterior ) y agregando el identificador de la marca separado por dos puntos marcas ingenico ing ej "ing 123aaa1235566" urovo uro ej "uro 123aaa1235566" ejemplos del nodo installments existen 3 formas de limitar planes ocultar determinados planes de todo el conjunto de planes existentes estos planes se pueden limitar por referencia o por id de plan { "installments" \[" ahora 12", " ahora 18"] } limitar los planes a las elegidos en el array estos planes se pueden limitar por referencia o por id de plan { "installments" \["1", "3", "ahora 12"] } mostrar planes especiales basado en reglas avanzadas cancelar una operación en progreso si una operación está en progreso en el pos se puede cancelar la misma utilizando la api sólo se puede cancelar una operación a la vez webhooks { "type" "pos", "data" { "result" true, "view" { "type" "card" }, "payment" { "created" "2024 04 16t23 04 40 523z", "currency" { "code" "ars", "locale" "es ar", "symbol" "$", "text" "peso argentino" }, "description" "orden 11111111111", "id" "3z6d9yf71l0lggrr8drt3w", "operation" { "type" "payment v2" }, "reference" "1111111111", "requestedcurrency" { "code" "ars", "locale" "es ar", "symbol" "$", "text" "peso argentino" }, "requestedtotal" 145170, "riskanalysis" { "band" "n/a", "level" "n/a" }, "source" { "cardholder" { "identification" "12123123", "name" "bruce wayne" }, "expiration" { "month" "06", "year" "24" }, "installment" { "amount" 145170, "count" 1, "description" "1 cuota", "reference" "1", "tags" \[], "uid" "nzqwp58ga" }, "name" "visa banco santander", "number" "46600000 4601", "reference" "visa santanderrio", "transaction" { "authorizationcode" "004288", "batchno" "", "resultcode" "0", "retrievalreferenceno" "410723133668", "ticketno" "", "transactionid" "3z6d9yf71l0lggrr8drt3w" }, "type" "card", "variant" "credit" }, "status" { "code" "200", "data" {}, "message" "transacción aprobada", "resultcode" "0", "text" "aprobado", "view" "default" }, "total" 145170, "updated" "2024 04 16t23 04 42 146z" }, "entity" { "name" "wayne inc", "uid" "iambatman" }, "customer" { "uid" "12123123", "name" "juan perez wayne", "phone" "12123123", "identification" "110303456", "email" "soybatman\@wayneinc com" }, "user" { "name" "juan perez wayne", "email" "soybatman\@wayneinc com" }, "source" { "name" "visa banco santander", "reference" "visa santanderrio", "type" "card" }, "pos" { "name" "pos nombre", 	 "description" " ", 	 "mode" "normal", 	 "reference" "pos\ my ref", 	 "terminal" { 	 "uid" "gdq3v8l4ee6aae5l9nwck5", 	 "reference" "ing 123aaa1235566", 	 "serialnumber" "123aaa1235566" 	 } } } } modo de pruebas para probar en el pos cree una operación con la variable "test" en true para poder simular los diferentes estados debe utilizar el "total" de la operación, por ejemplo si desea que la transacción se apruebe el total debe ser 200 vea la documentación de "códigos de estado" para mayor detalle y posibilidades de prueba luego de crear la transacción con las condiciones indicadas proceda a utilizar cualquier tarjeta real, la operación no será cobrada sino que será simulada de acuerdo a lo indicado modos del punto de venta actualmente se soportan 2 modos modo normal en este modo quien opera el pos puede ingresar el monto de la operación con el teclado en pantalla modo esclavo en este modo el pos se transforma en un dispositivo que debe ser controlado 100% desde la api sin que el usuario pueda intervenir en todos los modos soportados la api aquí documentada puede ser utilizada permitiendo integrar el pos al 100% a su sistema de caja