5. Venta

Pasos para implementar una venta.

Ahora que has podido autorizar tu aplicaci贸n y obtener un access_token, el siguiente paso es realizar una transacci贸n de prueba.

馃憤

Recuerda que debes conectar a internet la terminal, configurar la aplicaci贸n para poder realizar una venta y configurar el servicio de respuesta como se indica en la secci贸n de Introducci贸n.

5.1 Estructura de una petici贸n.

POST http://nubeqa.netpay.com.mx:3334/integration-service/transactions/sale

Headers
Los siguientes headers deben ser enviados en la petici贸n

  • Content-Type: application/json
  • Authorization: Bearer {{access_token}}
NombreDescripci贸nTipoValorRequerido
Content-TypeIdentificador de dos partes para formatos de archivo transmitidos por Internet.stringapplication/jsontrue
AuthorizationEsquema de autenticaci贸n HTTP.stringBearer {access_token}true

馃毀

Nota

  • La terminal debe tener acceso a internet en todo momento sin restricciones al dominio y subdominios que involucren a *.netpay.com.mx para recibir y enviar solicitudes.
  • Debe estar encendida la pantalla de la terminal y estar en primer plano la pantalla principal de la aplicaci贸n.

5.2 Estructura de un JSON de venta.

Para poder generar una transacci贸n es necesario formar un JSON con la siguiente informaci贸n.

Par谩metroDescripci贸n
traceabilityObjeto JSON para enviar informaci贸n relevante para el comercio.
serialNumberN煤mero de serie. Cadena num茅rica a 10 d铆gitos ubicada en la parte posterior de la terminal (S/N).
storeIdN煤mero identificador de comercio asignado por terminal.
msiN煤mero que identifica la promoci贸n a MSI que se desea integrar Ej: 3, 6, 9, 12 o 18 msi ( esta promoci贸n no aplica para tarjetas Amex) (Este dato no es obligatorio, solo si el cliente lo requiere).
folioNumberN煤mero de folio que se mostrar谩 en el ticket.
access_tokenToken de acceso necesario para consumir el servicio.
Ver secci贸n Generar Token.
disablePrintAnimationBandera de control con valor por default false. Al enviarla en true, se omitir谩 el ticket oficial de NetPay. (Opcional.)

Body

En la petici贸n, se debe mandar un objeto JSON con los datos seg煤n se requieran. Los 5 valores m铆nimos requeridos son serialNumber, amount, storeId, traceability y folionumber.

{
    "serialNumber": "{serialNumber}",
    "amount": "{{amount}}",
    "storeId": "{storeId}",
    "folioNumber":"{folioNumber}",
    "msi":"{msi}",
    "traceability": {}
}

Ejemplo:

{
  "traceability": {  
    "idProducto": "123456",
    "idTienda": 0987
	},
  "serialNumber": "1400000000",
  "amount":0.01,
  "folioNumber":"123",
  "storeId": "9194",
  "msi":"03",
  "disablePrintAnimation": true

}

Tabla de par谩metros mandatorios y opcionales a enviar en una petici贸n de Venta.

Nombre campoDescripci贸nTipo de dato
serialNumberN煤mero de serie del dispositivo al que se requiere enviar la petici贸n.String (M谩ximo hasta 20 caracteres)Mandatorio
amountMonto total de la transacci贸n.Double(15,2)Mandatorio
storeIdIdentificador de la tienda asignada al dispositivo.String (M谩ximo hasta 38 caracteres)Mandatorio
folioNumberN煤mero identificador de transacci贸n que puede ser enviado en la solicitud de venta.String (M谩ximo hasta 250 caracteres)Recomendable
traceabilityObjeto JSON para enviar informaci贸n relevante para el comercio (puede ser alg煤n id de la transacci贸n que posteriormente les servir谩 para hacer 鈥渕atch鈥 dentro de su sistema.Object.Mandatorio
msiN煤mero que identifica la promoci贸n a MSI que se desea integrar Ej: 03, 06, 09, 12 o 18 msi (esta promoci贸n no aplica para tarjetas Amex)String (M谩ximo 2 carateres).Opcional
tipCampo que hace referencia al env铆o de propina (Predeterminadamente tiene un l铆mite del 25%)StringOpcional
disablePrintAnimationBandera de control con valor default falso, cambiarlo a true desactiva la impresi贸n del ticket oficial de NetPay. Este campo debe enviarse s贸lo si el comercio cuenta con una impresora propia.BoolOpcional

馃毀

Nota.

Si se requiere el uso de la propina y si el monto debe ser mayor al 25%, el comercio se puede comunicar con su comercial asignado correspondiente para que se coordine con el equipo de operaciones y ese l铆mite sea aumentado al porcentaje que sea necesario. Este aumento de l铆mite ya se realizar铆a en producci贸n despu茅s de terminar con la integraci贸n y de realizar la certificaci贸n exitosamente como lo indica la secci贸n de 10. Certificaci贸n y pasos a seguir de esta documentaci贸n.

5.3 Ejemplo de solicitud / respuesta.

A continuaci贸n, se muestran ejemplos en diferentes lenguajes de programaci贸n para realizar una petici贸n y solicitar una venta con los diferentes mensajes de respuesta.