CyberSource - Amazon Simple Storage Service (S3) › pagalocard › Manuales › Manual+de...P á g i n a 4 | 15 La información brindada en este documento es proporcionada con el

P á g i n a 1 | 15

La información brindada en este documento es proporcionada con el único objetivo de brindar una guía práctica para el proceso de implementación hacia PagaloCard.

CONTENIDO 1. Objetivo ................................................................................................................................. 2

2. Requerimientos del sistema .................................................................................................. 2

3. Integración API PagaloCard .................................................................................................. 3

3.1 CREDENCIALES PARA INTEGRACION ........................................................................ 3

3.2 LINKS .............................................................................................................................. 4

3.2.1 Link para integración: ................................................................................................ 4

3.2.2 Link de Pruebas: ....................................................................................................... 4

3.3 PARÁMETROS NECESARIOS PARA LA EMPRESA ..................................................... 5

3.4 PARÁMETROS NECESARIOS PARA EL CLIENTE ....................................................... 6

3.5 deviceFingerprintID ......................................................................................................... 6

3.5.1 merchantID: .............................................................................................................. 6

3.5.2 Environment: ............................................................................................................. 6

3.6 PARÁMETROS NECESARIOS DEL PRODUCTO Y/O ITEMS ....................................... 8

3.6.1 EJEMPLOS DE UNIÓN DE ARRAY PARA PRODUCTOS Y/O ITEMS:.................... 8

3.7 PARÁMETROS NECESARIOS DE LAS TARJETAS ....................................................... 9

4. Ejemplos ............................................................................................................................. 10

4.1 EJEMPLO - TRANSACCION - CYBERSOURCE .......................................................... 10

4.2 EJEMPLO - TRANSACCIÓN – PAYMENT GATEWAY ................................................. 11

5. Parametros de Respuesta ................................................................................................... 12

5.1 Cyber Source ................................................................................................................ 12

5.2 Payment GateWay ........................................................................................................ 15

P á g i n a 2 | 15


1. Objetivo

Brindar información detallada y concreta para que el comercio afiliado pueda conectarse e

interactuar con todas las funciones del sistema de pagalocard.

2. Requerimientos del sistema

1- Registrarse con datos reales de la empresa a implementar tanto en la plataforma central

(https://app.pagalocard) como en el ambiente de pruebas(https://sandbox.pagalocard.com).

2- Verificar que los dominios de págalocard no estén bloqueados (proxi, firewall, etc.).

3- Tener claro el concepto para la modalidad de trabajo de la empresa, CyberSource o

PaymenGateway:

CyberSource: Sistema de seguridad antifraude para pasarelas de pagos.

Payment Gateway: Pasarela de pagos básica.

[email protected]

Horarios de atención:

Lunes-viernes 8:00am-5:00pm

Tel.: 2226-0894/2226-0895

https://sandbox.pagalocard.com/

mailto:[email protected]

P á g i n a 3 | 15


3. Integración API PagaloCard

PagaloCard está formado por un webservice central y web App. El webservice central controla

todo los movimientos y transacciones con métodos seguros para la empresa y los usuarios. La

integración desde la página web o aplicación tiene token y API key secreta y pública. Trabajando

de la siguiente manera:

Web y/o aplicación API

WebServices Key Clientes

La integración es realizada por JSON, utilizando un token único del cliente más parámetros

necesarios para datos (APIS KEY SECRETAS Y PÚBLICAS).

3.1 CREDENCIALES PARA INTEGRACION

IdenEmpresa:

Dato enviado por los administradores de págalocard, al validar su usuario. Para identificar el

idenEmpresa: Letra+9 Números Ej.: “c564852135”.

Token Empresa:

Dato enviado por los administradores de págalocard, al validar su usuario. Para identificar el

Token: Letras y Números de 20 caracteres.

Key Secret y Publica:

Dato enviado por los administradores de págalocard, al validar su usuario. Existen dos tipos (Keys

pruebas y Keys Empresa).

Nota: Toma en cuenta que las credenciales que utilices sean las del entorno correcto (live, test).

Nota: No se brindaran credenciales reales sin antes tener pruebas satisfactorias en el ambiente

test (sandBox)

P á g i n a 4 | 15


Live:

Test:

3.2 LINKS

3.2.1 Link para integración: Cyber Source https://app.pagalocard.com/api/v1/integracion/{TOKEN_EMPRESA}

Payment Gateway https://app.pagalocard.com/api/v1/integracionpg/{TOKEN_EMPRESA}

3.2.2 Link de Pruebas:

Cyber Source https://sandbox.pagalocard.com /api/v1/integracion/{TOKEN_EMPRESA}

Payment Gateway https://sandbox.pagalocard.com /api/v1/integracionpg/{TOKEN_EMPRESA}

https://app.pagalocard.com/api/v1/integracionpg/%7bTOKEN_EMPRESA%7d

P á g i n a 5 | 15


3.3 PARÁMETROS NECESARIOS PARA LA EMPRESA

PARÁMETRO DESCRIPCIÓN TIPO REQ Key_secret Key secreta entrega de la empresa Texto SI

Key_public Key secreta entregada de la empresa Texto SI

IdenEmpresa Identidad de la empresa Texto SI

Ejemplo:

{

"idenEmpresa": "B44823229",

"key_public": "TYy46vvpH002w7s0TewK5ltdYkq1pz0zLOjQur",

"key_secret": "0HuZXIteXuUtc00rba2IUTUSiSI6wC4FoEXfQv",

}

Enviar el array convertido a JSON, en algunos lenguajes se utiliza json encode.

Ejemplo:

{

"empresa":"{\"key_secret\":\"E0qDeQBuCmdMYmI0hBSni74RMpebzeJDD0Jm\",

\"key_public\":\"23l1oHOgEhLRSclyeN1fAD5UBxSNl NIR4iDuqMbs\",

\"idenEmpresa\":\"P111321201\"}",

}

P á g i n a 6 | 15


3.4 PARÁMETROS NECESARIOS PARA EL CLIENTE

PARÁMERO DESCRIPCIÓN TIPO REQ firstName Nombre del cliente Texto SI

lastName Apellido del cliente Texto SI

street1 Dirección del envío Texto SI

country Nombre del país Texto SI

city Ciudad o departamento del país Texto SI

state Estado o Municipio de la ciudad Texto SI

postalCode Código postal Numérico SI

email Correo electrónico del cliente Texto SI

ipAddress IP del cliente Texto SI

phone Teléfono del cliente Numérico SI

total Total de la venta Numérico 2 decimales SI

fecha_transaccion Fecha del momento de transacción Formato “AAAA-MMDD HH:MM:SS”

SI

deviceFingerprintID Huella digital Texto SI

3.5 deviceFingerprintID

Es la huella digital del dispositivo que realiza la transacción. Es un dato muy importante que se

tiene en cuenta en el proceso de validación cuando se utiliza Cybersource. Si el comercio utiliza

nada mas Paymen GateWay no es indispensable para realizar las transacciones.

Para obtenerlo hay que incluir en el formulario de pago el segmento de código que se

proporcionan a continuación.

<script>

document.write('<input type="hidden" name="deviceFingerprintID" value="'+ cybs_dfprofiler("merchantID","environment") + '">');

</script>

Preste especial atencion a los dos parametros:

3.5.1 merchantID:

Utiliza “visanetgt_jupiter” cuando se está utilizando la llave de pagalo, en caso contrario utilizar

el merchantID de la llave propia.

3.5.2 Environment:

“test”/”live” Adicionalmente incluir el cybs_devicefingerprint.js al formulario de pago.

Puede descargar el archivo por esta vìa:

https://s3.amazonaws.com/documentacionpagalo/archivos/cybs_devicefingerprint.js

https://s3.amazonaws.com/documentacionpagalo/archivos/cybs_devicefingerprint.js

P á g i n a 7 | 15


Nota: Recuerde que el DeviceFingerPrint es obligatorio únicamente si utiliza CyberSource, en el caso de utilizar

Payment Gate Way no necesario lo agregue al arreglo.

Adicional si trabaja bajo una llave propia de CyberSource contacte a PagaloCard para que puedan brindarle su

merchanID , ya este se basa en su afiliación propia.

Ejemplo:

$cliente[ ] = array( 'firstName'=> ’Juan’,

'lastName'=> ‘Pérez’,

'street1'=> ’12 Avenida Zona 15 ’,

'country'=> ‘Guatemala’,

'city'=> ’Guatemala ’,

'state'=> ’Guatemala ’,

'postalCode'=> ’01015 ’,

'email'=> ’[email protected] ’,

'ipAddress'=> ’192.168.1.45 ’,

'Total'=> ’70.00 ’,

'fecha_transaccion'=> ’2017-08-31 09:05:00 ’,

'deviceFingerprintID' => ’ASDF32RDSF23DSFA32’,

);

Enviar el array convertido a JSON, en algunos lenguajes se utiliza json encode, realizarlo como el

ejemplo de EMPRESA.

P á g i n a 8 | 15


3.6 PARÁMETROS NECESARIOS DEL PRODUCTO Y/O ITEMS

PARÁMETRO DESCRIPCIÓN TIPO REQ id_producto SKU o ID único para identificar el

producto Texto SI

nombre Nombre del producto Texto SI

precio Precio del producto Texto SI

cantidad Cantidad del producto

tipo Tipo de Producto (producto, servicio, reserva)

Texto SI

subtotal Precio x cantidad del producto Numérico con 2 decimales

SI

3.6.1 EJEMPLOS DE UNIÓN DE ARRAY PARA PRODUCTOS Y/O ITEMS:

$detalle = [];

foreach($productos as $producto) {

$detalle[] = array(

'id_producto' => 'P01',

'cantidad' => '2',

'tipo' => 'producto',

'nombre' => 'Hamburguesa',

'precio' => '35.00',

'Subtotal' => '70.00'

);

}

Enviar el array convertido a JSON, en algunos lenguajes se utiliza json encode, realizarlo como el

ejemplo de EMPRESA.

P á g i n a 9 | 15


3.7 PARÁMETROS NECESARIOS DE LAS TARJETAS

PARÁMETRO DESCRIPCIÓN TIPO REQ nameCard Nombre de la tarjeta Texto SI

accountNumber Número de la tarjeta Numérico SI

expirationMonth Mes de fecha de vencimiento Numérico (2 dígitos) SI

expirationYear Año de fecha de vencimiento Numérico (4 dígitos) SI

CVVcard CVV de Seguridad Numérico(3 o 4 dígitos) SI

$tarjetaPagalo[] = array (

'nameCard' => 'Juan Pérez',

'accountNumber' => '1452411212111111',

'expirationMonth' => '09',

'expirationYear' => '2020',

'CVVCard' => '010'

);

Enviar el array convertido a JSON, en algunos lengujes se utiliza json encode, realizarlo como el ejemplo de

EMPRESA.Envio con link y parámetros

P á g i n a 10 | 15


4. Ejemplos

4.1 EJEMPLO - TRANSACCION - CYBERSOURCE

{ "empresa":"{\"key_secret\":\"E0qDeQBuCmdMYgULzmI0hBSni74RMpebzeJDD0Jm\", \"key_public\":\"23l1oHOgEhLRSclyeN1fAD5UBxSNlNIR4iDuqMbs\", \"idenEmpresa\":\"P111321201\"}",

"cliente":"{\"codigo\":\"0001\", \"firstName\":\"Oliver\", \"lastName\":\"Ramos\", \"street1\":\"2da. calle 7-61 zona 9\", \"country\":\"GT\", \"city\":\"Guatemala\", \"state\":\"GT\", \"email\":\"[email protected]\", \"ipAddress\":\"172.16.10.30\", \"Total\":2, \"currency\":\"GTQ\", \"fecha_transaccion\":null, \"postalCode\":\"01009\", \"phone\":\"2300\", \"deviceFingerprintID\":\"1536014945757\"}",

"tarjetaPagalo": "{\"nameCard\":\"Oliver Ramos\", \"accountNumber\":\"454881204940004\", \"expirationMonth\":\"12\", \"expirationYear\":\"2020\", \"CVVCard\":502}",

"detalle":"[{\"id_producto\":\"P1\", \"cantidad\":\"1\", \"tipo\":\"producto\", \"nombre\":\"Pedido en el app\", \"precio\":2, \"Subtotal\":2}]"

}

Modalidad LINK VIA Método

Live https://app.pagalocard.com/api/v1/integracion/{tokenempre} CyberSource POST

Test https://sandbox.pagalocard.com/api/v1/integracion/{tokenempre} CyberSource POST

P á g i n a 11 | 15


4.2 EJEMPLO - TRANSACCIÓN – PAYMENT GATEWAY

{"empresa":"{\"key_secret\":\"AP0Z5sEEuR0fB7oKLiyMkonufkrUNCJBf7VnF6lR\",

\"key_public\":\"mNjoQARVmFLOnYWoSQyFCAqI1QuVkdc1bzu6C1A5\", \"idenEmpresa\":\"N937524731\"}",

"cliente":"{\"firstName\":\"jose\", \"lastName\":\"Apellido\",

\"street1\":\"Avenida petapa 25-51 zona 12\",

\"phone\":47736060,

\"country\":\"Guatemala\", \"city\":\"Guatemala\",

\"state\":\"Guatemala\",

\"postalCode\":\"01001\", \"email\":\"[email protected]\",

\"ipAddress\":\"192.168.10.1\", \"Total\":500,

\"fecha_transaccion\":{\"date\":\"2018-07-24 17:24:50.703559\", \"timezone_type\":3,

\"timezone\":\"America\\\/Guatemala\"}, \"currency\":\"GTQ\"\"}",

"detalle":"[{\"id_producto\":\"01\", \"cantidad\":\"1\",

\"tipo\":\"producto\",

\"nombre\":\"mi producto\", \"precio\":500,

\"Subtotal\":500}]", "tarjetaPagalo":"{\"nameCard\":\"nombre\",

\"accountNumber\":\"4000000000000416\", \"expirationMonth\":\"01\",

\"expirationYear\":\"2019\", \"CVVCard\":\"4567\"}"

}

Modalidad LINK VIA Método

Live https://app.pagalocard.com/api/v1/integracionpg/{tokenempre} PaymentGateway POST

Test https://sandbox.pagalocard.com/api/v1/integracionpg/{tokenempre} PaymentGateway POST

P á g i n a 12 | 15


5. Parametros de Respuesta

Código Descripción Descripción Descripción de la tarjeta

reasonCode Código de error cuando la tarjeta es rechazada

requestID Id de la transacción

codigo_respuesta Código de aprobación o REJECT

respuesta Descripción de la respuesta

id_transacción Código de validación de la transacción

Sku_products Arrays de los ids de productos que recibieron el pago

time_transaccion Horario de la transacción enviada del servidor Págalo

Estado Estado de la transacción

5.1 Cyber Source

Código de razón Descripción 100 Transacción exitosa, ACCEPT

101 REJECT: falta la solicitud en uno o más campos

102 REJECT: uno o más campos en la solicitud contienen datos no válidos.

104 REJECT: el merchantID enviado con esta solicitud de autorización coincide con el merchantID de otra solicitud de autorización que envió en los últimos 15 minutos.

110 Cantidad parcial aprobada.

150 Error: falla general del sistema.

151 Error: se recibió la solicitud pero hubo un tiempo de espera del servidor. Este error no incluye los tiempos de espera entre el cliente y el servidor.

152 Error: se recibió la solicitud, pero un servicio no terminó de ejecutarse a tiempo.

200 REJECT: la solicitud de autorización fue aprobada por el banco emisor, pero rechazada por CyberSource porque no pasó el control del Servicio de verificación de direcciones (AVS).

201 REJECT: el banco emisor tiene preguntas sobre la solicitud.No recibe un código de autorización mediante programación, pero puede recibir uno verbalmente llamando al procesador.

202 REJECT: tarjeta vencida. También podría recibir esto si la fecha de vencimiento que proporcionó no coincide con la fecha en que el banco emisor tiene el archivo. Nota: ccCreditService no verifica la fecha de vencimiento; en cambio, pasa la solicitud al procesador de pagos. Si el procesador de pagos permite la emisión de créditos a tarjetas vencidas, CyberSource no limita esta funcionalidad.

P á g i n a 13 | 15


203 DO NOT HONOR REJECT: REJECT general de la tarjeta. No hay otra información provista por el banco emisor, intente con un nuevo método de pago o hable con su banco emisor para mayor información. Este error es un código que regresa el emisor, media vez la tarjeta no esté permitida para hacer transacciones en línea o esté bloqueada en parámetros por alguna razón del banco. Cuando este caso se de, es necesario que el tarjeta habiente contacte al banco para validar que su tarjeta puede hacer transacciones en línea.

204 REJECT: fondos insuficientes en la cuenta.

205 REJECT: tarjeta robada o perdida.

207 REJECT: el banco emisor no está disponible.

208 REJECT: la tarjeta o tarjeta inactiva no está autorizada para transacciones que no están presentes en la tarjeta.

209 REJECT: el número de verificación de la tarjeta (CVN) no coincidió.

210 REJECT: la tarjeta ha alcanzado el límite de crédito.

211 REJECT: número de verificación de tarjeta no válida (CVN).

220 REJECT general.

221 REJECT: el cliente hizo coincidir una entrada en el archivo de lista negra del procesador.

222 REJECT: la cuenta del cliente está congelada.

230 REJECT Suave: la solicitud de autorización fue aprobada por el banco emisor, pero rechazada por CyberSource porque no pasó el cheque del número de verificación de la tarjeta (CVN).

231 REJECT: número de cuenta no válido

232 REJECT: el procesador de pagos no acepta el tipo de tarjeta.

233 REJECT: disminución general por parte del procesador.

234 REJECT: existe un problema con la configuración de comerciante de CyberSource.

235 REJECT: el monto solicitado excede el monto originalmente autorizado. Se produce, por ejemplo, si intenta capturar una cantidad mayor que la cantidad de autorización original.

236 REJECT: falla del procesador.

237 REJECT: la autorización ya se ha revertido.

238 REJECT: la transacción ya se ha resuelto.

239 REJECT: el monto de la transacción solicitada debe coincidir con el monto de la transacción anterior.

240 REJECT: el tipo de tarjeta enviado no es válido o no se correlaciona con el número de la tarjeta de crédito.

241 REJECT: el ID de solicitud referenciado no es válido para todas las transacciones de seguimiento.

242 REJECT: el ID de solicitud no es válido. Solicitó una captura, pero no hay un registro de autorización no utilizado correspondiente. Se produce si no hubo una solicitud de autorización previamente satisfactoria o si la autorización previamente exitosa ya se ha utilizado en otra solicitud de captura.

243 REJECT: la transacción ya ha sido resuelta o revertida.

P á g i n a 14 | 15


246 REJECT: la captura o el crédito no son anulables porque la información de captura o crédito ya se ha enviado a su procesador. O bien, solicitó un vacío para un tipo de transacción que no se puede anular.

247 REJECT: solicitó un crédito por una captura que se anuló previamente.

248 echazo: su procesador rechazó la solicitud de boleto.

250 Error: se recibió la solicitud, pero hubo un tiempo de espera en el procesador de pagos, intente nuevamente.

251 REJECT: se ha superado la frecuencia de uso de la tarjeta de débito sin PIN o la cantidad máxima por uso.

254 REJECT: la cuenta tiene prohibido procesar reembolsos independientes.

400 REJECT suave: el puntaje de fraude supera el umbral.

450 Número de apartamento faltante o no encontrado.

451 Insuficiente información de la dirección.

452 Número de casa / caja que no se encuentra en la calle.

453 Se encontraron coincidencias de direcciones múltiples.

454 Identificador de casilla de correo no encontrado o fuera del rango.

455 Identificador de servicio de ruta no encontrado o fuera del rango.

456 El nombre de la calle no se encuentra en el código postal.

457 Código postal no encontrado en la base de datos.

458 No se puede verificar o corregir la dirección.

459 Se encontraron múltiples coincidencias de direcciones (internacionales)

460 Coincidencia de dirección no encontrada (no se da ninguna razón)

461 Juego de caracteres no compatible

475 El titular de la tarjeta está inscrito en la autenticación de Payer. Por favor, autentifique al titular de la tarjeta antes de continuar con la transacción.

476 Encontró un problema de autenticación de Payer. Payer no se pudo autenticar.

480 La transacción fue autorizada, está marcado para revisión por el Administrador de decisiones.

481 REJECT parcial: Se hizo una preautorización y El pedido ha sido rechazado por Decision Manager.

520 REJECT suave: la solicitud de autorización fue aprobada por el banco emisor pero rechazada por CyberSource en función de su configuración de autorización inteligente.

700 El cliente hizo coincidir la Lista de partes denegadas.

701 Exportar bill_country / ship_country match

702 Exportar email_country match

703 Exportar hostname_country / ip_country matc

P á g i n a 15 | 15


5.2 Payment GateWay

CÓDIGO DESCRIPCIÓN 200 Aprobado exitosamente

404 No se encuentra conexión con el servidor actualmente

300 No se VALIDO EL NÚMERO DE LA TARJETA

301 La fecha de vencimiento de la tarjeta no es correcta

00 Aprobada

01 Refiérase al emisor


03 Comercio invalido


05 TRANSACCIÓN NO ACEPTADA.Este error es un código que regresa el

emisor, media vez la tarjeta no esté permitida para hacer transacciones en

línea o esté bloqueada en parámetros por alguna razón del banco. Cuando

este caso se de, es necesario que el tarjeta habiente contacte al banco para

validar que su tarjeta puede hacer transacciones en línea. (Puede ocurrir

con Visacuotas o de contado)

07 Retener tarjeta

12 Transaccion invalida

13 Fondos insuficientes

14 Tarjeta invalida

15 Emisor invalido (merchant invalid)

19 Trate de nuevo

25 Registro inexistente

30 Error de formato

31 Tarjeta no soportada por switch

41 Tarjeta perdida

43 Tarjeta robada

51 Falta disponible

54 Tarjeta vencida

57 Transacción no permitida


61 Monto excedido

62 Tarjeta restringida

65 Monto excedido.

78 Cuenta invalida


89 Terminal inválida

91 Emisor no disponible - time out

96 Mal funcionamiento del sistema

Documents

CyberSource - Amazon Simple Storage Service (S3) › pagalocard › Manuales › Manual+de...P á g i n a 4 | 15 La información brindada en este documento es proporcionada con el