tb-payments-globalonepay

1.0.7 • Public • Published

tb-payments-globalonepay

Instalación:

Para utilizar los servicios de pago de GlobalOnePay es necesario tener instalada las librerías "tb-payments" y "tb-payments-globalonepay".

Configuración del servicio:

- Configuración desde interfaz administrativa:

NO DISPONIBLE

- Configuración manual:

La configuración manual se realiza en el archivo "config.json".

Para ello hay que añadir el objeto "paymentsOptions", si no se tenía anteriormente, y agregar un objeto cuya clave sea "globalOnePay" que contendrá la información necesaria para el servicio. Al completarlo, debería quedar de la siguiente manera:

"paymentsOptions":{
  "globalOnePay":{
    "terminalId": "99089",
    "sharedSecret": "123456789XX",
    "mcp": true,
    "url": myServiceUrl,
    "port": myServicePort
  }
}

Ejemplos de uso:

- Registrar una tarjeta:

• Código Javascript:

Parámetros:

Clave Tipo Opcional Descripción
data Object Información de la tarjeta que se va a registrar
data.merchantRef String Identificador único para la tarjeta que se va a registrar
data.cardNumber String Número de la tarjeta de crédito.
data.cardExpiry String Fecha de vencimiento de la tarjeta de crédito en formato "MMYY" (Ej:0920 -> "Septiembre de 2020").
data.cardType String Información de la tarjeta que se va a registrar.
data.cvv String Código de seguridad impreso en la tarjeta
data.cardHolderName String Información de la tarjeta que se va a registrar.

Respuesta:

Clave Tipo Opcional Descripción
register Object Objeto con la información de la tarjeta registrada
register.cardNumber String Número de tarjeta. Los números de tajerjeta se almacenan guardando los 4 ultimos digitos completando con asteriscos el resto
register.cardExpiry String Fecha de vencimiento de la tarjeta de crédito en formato "MMYY" (Ej:0920 -> "Septiembre de 2020").
register.cardHolderName String Nombre en la tarjeta de crédito.
register.regts Date Timestamp de la fecha de registro
register.regrespts Date Timestamp de le fecha de la respuesta del registro
register.reference String Referencia de la tarjeta registrada
register.active Boolean Flag que indica si la tarjeta está activa o no
register.originalResponse Object Respuesta original del registro
register.serviceProvider String Servicio de pagos utilizado para el registro
register({
  merchantRef:"1234567890123459",
  cardNumber:myCardNumber,
  cardExpiry:"1220",
  cardType:"MASTERCARD",
  cvv: "231",
  cardHolderName:"Messi"   
})
.then(resp=>{
 console.log("bien");
 console.log(resp);
})
.catch(err=>{
 console.log("Mal")
 console.error(err);
});

- Pago:

• Código Javascript:

Parámetros:

Clave Tipo Opcional Descripción
data Object Información del pago que se va a realizar.
data.orderId String Identificador de la compra
data.amount String Valor de la compra
data.currency String Divisa en la que se va a realizar el pago
data.cardNumber String Número de la tarjeta de crédito
data.cardExpiry String Fecha de vencimiento de la tarjeta de crédito en formato "MMYY" (Ej:0920 -> "Septiembre de 2020").
data.cardType String Tipo de tarjeta de crédito (EJ: MASTERCARD).
data.cardHolderName String Nombre en la tarjeta de crédito.
data.cvv String Código secreto que aparece en la tarjeta
data.customerPostcode String X Código postal del dueño de la tarjeta
data.customerCity String X Ciudad del dueño de la tarjeta
data.customerRegion String X Región del dueño de la tarjeta
data.customerCountry String X País del dueño de la tarjeta en formato ISO 3166-1-alpha-2
data.customerAddress1 String X Dirección 1 del dueño de la tarjeta
data.customerAddress2 String X Dirección 2 del dueño de la tarjeta
data.customerPhone String X Teléfono del cliente asociado a la tarjeta en formato internacional
data.description String X Descripción de la transacción
data.ipAddress String X Dirección IP desde la que se realiza la transacción
options Object X Opciones extras relacionadas con el pago.
options.terminalType String Terminal Type del servicio
options.transactionType String Tipo de transacción del servicio

Respuesta:

Clave Tipo Opcional Descripción
transaction Object Objeto con la información de la transacción
transaction.action String "pay" - Acción que se realiza en la transacción
transaction.orderId String Identificador de orden de la transacción
transaction.amount Number Cantidad de dinero de la transacción
transaction.currency tString ISO de la Moneda de la transacción
transaction.payReference String Referencia del pago que se utiliza en la transacción (Para devoluciones)
transaction.payTs Date Timestamp de la fecha en que se solicita la transacción
transaction.optional Object Información adicional relacionada con la transacción
transaction.cardNumber String Número de tarjeta o referencia de tarjeta registrada. Los números de tajerjeta se almacenan guardando los 4 ultimos digitos completando con asteriscos el resto y si es la referencia se guarda el numero completo
transaction.rPayReference String Número de referencia del pago o devolución de la transaccion realizada
transaction.rPayTs Date Timestamp de la fecha en que se realiza la transacción
transaction.rApproved Boolean Flag que indica si la transacción fue aprobada
transaction.rPaycode String Código de respuesta del estado de la transacción
transaction.respts Date Timestamp de la fecha en que se recibe la respuesta de la transacción
transaction.rApprovalCode String Código de aprovación de la transacción
transaction.rBankcode String Código de respuesta de la transacción proporcionado por el banco
transaction.rText String Texto de respuesta de la transacción
transaction.originalResponse Object Respuesta original del pago
transaction.serviceProvider String Servicio de pagos utilizado para el pago
pay({
 orderId        : "19827391827392",
 amount         : "289",
 currency       : "USD",
 cardNumber     : demoCreditCard.MasterCard,
 cardType       : "MASTERCARD",
 cardExpiry     : "1220",
 cardHolderName : "Messi" ,
 cvv            : "124" 
})
.then(resp=>{
 console.log("bieen");
 console.log(resp);
})
.catch(err=>{
 console.log("Mal")
 console.error(err);
});

- Pago con una tarjeta registrada:

• Código Javascript:

Parámetros:

Clave Tipo Opcional Descripción
data Object Información del pago que se va a realizar.
data.orderId String Identificador de la compra
data.amount String Valor de la compra
data.currency String Divisa en la que se va a realizar el pago
data.cardNumber String Identificador de la tarjeta de crédito registrada
options Object X Opciones extras relacionadas con el pago.
options.terminalType String Terminal Type del servicio
options.transactionType String Tipo de transacción del servicio

Respuesta:

Clave Tipo Opcional Descripción
transaction Object Objeto con la información de la transacción
transaction.action String "pay" - Acción que se realiza en la transacción
transaction.orderId String Identificador de orden de la transacción
transaction.amount Number Cantidad de dinero de la transacción
transaction.currency tString ISO de la Moneda de la transacción
transaction.payReference String Referencia del pago que se utiliza en la transacción (Para devoluciones)
transaction.payTs Date Timestamp de la fecha en que se solicita la transacción
transaction.optional Object Información adicional relacionada con la transacción
transaction.cardNumber String Número de tarjeta o referencia de tarjeta registrada. Los números de tajerjeta se almacenan guardando los 4 ultimos digitos completando con asteriscos el resto y si es la referencia se guarda el numero completo
transaction.rPayReference String Número de referencia del pago o devolución de la transaccion realizada
transaction.rPayTs Date Timestamp de la fecha en que se realiza la transacción
transaction.rApproved Boolean Flag que indica si la transacción fue aprobada
transaction.rPaycode String Código de respuesta del estado de la transacción
transaction.respts Date Timestamp de la fecha en que se recibe la respuesta de la transacción
transaction.rApprovalCode String Código de aprovación de la transacción
transaction.rBankcode String Código de respuesta de la transacción proporcionado por el banco
transaction.rText String Texto de respuesta de la transacción
transaction.originalResponse Object Respuesta original del pago
transaction.serviceProvider String Servicio de pagos utilizado para el pago
payRegistered({
 orderId        : "19827391827393",
 amount         : "289",
 currency       : "USD",
 cardNumber     : "2967535088608700"
})
.then(resp=>{
 console.log("bieen");
 console.log(resp);
})
.catch(err=>{
 console.log("Mal")
 console.error(err);
});

- Devolución:

• Código Javascript:

Parámetros:

Clave Tipo Opcional Descripción
data Object Información del pago que se va a realizar.
data.paymentRef String Referencia del pago del que se va a realizar la devolución
data.amount String Cantidad a devolver
options Object X Opciones extras relacionadas con la devolución.
options.operator String Nombre de quien realiza la operacion
options.reason String Razón de la devolución

Respuesta:

Clave Tipo Opcional Descripción
transaction Object Objeto con la información de la transacción
transaction.action String "refund" - Acción que se realiza en la transacción
transaction.orderId String Identificador de orden de la transacción
transaction.amount Number Cantidad de dinero de la transacción
transaction.currency tString ISO de la Moneda de la transacción
transaction.payReference String Referencia del pago que se utiliza en la transacción (Para devoluciones)
transaction.payTs Date Timestamp de la fecha en que se solicita la transacción
transaction.optional Object Información adicional relacionada con la transacción
transaction.cardNumber String Número de tarjeta o referencia de tarjeta registrada. Los números de tajerjeta se almacenan guardando los 4 ultimos digitos completando con asteriscos el resto y si es la referencia se guarda el numero completo
transaction.rPayReference String Número de referencia del pago o devolución de la transaccion realizada
transaction.rPayTs Date Timestamp de la fecha en que se realiza la transacción
transaction.rApproved Boolean Flag que indica si la transacción fue aprobada
transaction.rPaycode String Código de respuesta del estado de la transacción
transaction.respts Date Timestamp de la fecha en que se recibe la respuesta de la transacción
transaction.rText String Texto de respuesta de la transacción
transaction.originalResponse Object Respuesta original de la transacción
transaction.serviceProvider String Servicio de pagos utilizado para de la transacción
refund({
 paymentRef : "DG5Z3SB3QJ",
 amount     : "53"
},{
 operator: "Javier "
})

Dependencies (5)

Dev Dependencies (0)

    Package Sidebar

    Install

    npm i tb-payments-globalonepay

    Weekly Downloads

    1

    Version

    1.0.7

    License

    ISC

    Unpacked Size

    36 kB

    Total Files

    4

    Last publish

    Collaborators

    • a2system
    • ezefire
    • filianer
    • javierarpa
    • maganap