1.0.7 • Published 6 years ago
tb-payments-globalonepay v1.0.7
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 "
})