baum-credomatic

README

Módulo de NodeJS para realizar pagos mediante la plataforma de pago de BAC Credomatic Paycom en su versión 2.0.

¿En que consiste este módulo o paquete de NodeJS?

• Permite realizar un pago por Tarjeta de Crédito/Débito.
• Muestra los errores del sistema de BAC Credomatic, AVS, CVV y los estados de las transacciones.
• Los mensajes están disponibles en los siguientes idiomas: Español, Inglés
• Desarrollador: Emilio Bogantes [e-mail]
• [Más información] (https://bitbucket.org/baumdigital/baum-credomatic/wiki/Home)

¿Cómo instalar y configurar el módulo?

• Instalación: npm install baum-credomatic --save
• Dependencias: request, md5, card-validator
• Configuración: Se necesita la URL y las credenciales de BAC Credomatic (KEY_ID, KEY, USERNAME).

#!javascript
//Incluimos el paquete
var Credomatic = require('../index.js');

//Configuramos el idioma para los mensajes
Credomatic.setLang('es');

//Las credenciales
var Auth = {
    url: 'https://url_suministrada_por_credomatic',
    username: 'foouser',
    key_id: '123456',
    key: 'ajhUAHuaAa7sakjbHH'
};

//Asignamos las credenciales
Credomatic.setAuth(Auth);

//Colocamos el modo de trabajo development o production
//Por defecto se trabaja en development o lo que indique la variable de entorno process.env.NODE_ENV
Credomatic.setMode('development');

• Ahora estamos listos para hacer uso del módulo.

Guía de uso y pruebas

• En esta versión solo esta habilitado el pago directo y para hacerlo es necesario lo siguiente:

#!javascript

//Prueba de request a Credomatic
var Data = {
    Order: "Orden 1", //Esto es el identificador de su orden es un String
    Time: Math.floor(new Date().getTime() / 1000), //esto es necesario para consultar el servicio
    CCNumber: "4111111111111111", //el número de tarjeta de crédito o débito
    CCExp: "10/17", //la fecha de vencimiento de la tarjeta
    CVV: "124", //el código de seguridad de la tarjeta
    Amount: 10.00, //el monto del pago
    Type: "sale", //el tipo de transacción de credomatic
    Address: "San Jose,CR", //la dirección del titular de la tarjeta
    Name: "Darth Vader", //el nombre del titular de la tarjeta
    IP: "127.0.0.1" //la direccion ip de donde se consulto
};

//Luego llamamos a la siguiente función para recibir la respuesta
Credomatic.paymentRequest(Data, function(response) {
    console.log(response);
});

• El Sandbox nos retornará una respuesta como la siguiente:

#!json

{
  valid: true,
  statusCode: 100,
  statusMessage: 'Success',
  transactionMessage: 'Transacción aprobada',
  transactionId: 470112,
  authCode: 1,
  avsResponse: '',
  avsText: '',
  cvvResponse: '',
  cvvText: '',
  responseCode: 1,
  responseStatus: 'Transacción aprobada',
  responseText: ''
}

• Estoy trabajando en incorporar más funciones y mejorar el paquete.

¿Desea reportar algún bug, tiene alguna duda o quiere hacer algún comentario?

• Enviar correo electrónico a [e-mail] o [e-mail]
• May the force be with you!