1.0.7 • Published 7 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 "
})