Integración API Págalo Card

 

PágaloCard está formado por un webservice central y webapp.

El webservice central controla todo los movimientos y transacciones con métodos seguros para
la empresa y los usuarios. La integración desde la pagina web o aplicación tiene token y API key
secreta y pública. Trabajando de la siguiente manera:

URL API

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).

Nuestra URL de webservices para API es:

https://app.pagalocard.com/api/v1/integracion

Nuestra URL de pruebas webservices para API es:

https://sandbox.pagalocard.com/api/v1/integracion

Credenciales

IdenEmpresa

Dato enviado por los administradores de págalocard, al validar su usuario. Para identificar el idenEmpresa: Letra+9 Número Ej:"c564852135".

Token Empresa

Dato enviado por los administradores de págalocard, al validar su usuario. Para identificar el Token: Letras y Número de 20 caracteres.

Key Secret y Pública

Dato enviado por los administradores de págalocard, al validar su usuario. Exiten dos tipos (Keys preubas y Keys Empresa).

Ejemplo de link para integración

https://app.pagalocard.com/api/v1/integracion/r4124ws4t1s321a4512151213s5dse112e1215

Link de Pruebas

https://sandbox.pagalocard.com/api/v1/integracion/r4124ws4t1s321a4512151213s5dse112e1215

PARÁMETRO DESCRIPCIÓN TIPO REQ
Key_secret Key secreta entregada de la empresa Texto SI
Key_public Key secreta entregada de la empresa Texto SI
IdemEmpresa Identidad de la empresa Texto SI

1.PARÁMETRO

Key_secret

2.DESCRIPCIÓN

Key secreta entregada de la empresa

3.TIPO

TEXTO

4.REQ

SI

1.PARÁMETRO

Key_public

2.DESCRIPCIÓN

Key secreta entregada de la empresa

3.TIPO

TEXTO

4.REQ

SI

1.PARÁMETRO

IdemEmpresa

2.DESCRIPCIÓN

Identidad de la empresa

3.TIPO

TEXTO

4.REQ

SI

Ejemplo

                      
      $empresa = array (
        'key_secret'=>'KEY SECRET',
        'key_public'=>'KEY PUBLIC',
        'idenEmpresa'=> 'IDENEMPRESA'
      );
                      
                      
                        
                        
                        
                        
                        
                      
                    

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

Ejemplo:

                      
      {"key_secret":"KEY SECRET","key_public":"KEY PUBLIC","idenEmpresa":"EDENEMPRESA"}
                      
                      
                        
                      
                    

Parámetros necesarios para el cliente

PARÁMETRO 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 Numerico SI
email Correo electrónico del cliente Texto SI
ipAddress IP del cliente Texto SI
phone Telefono del cliente Numerico SI
Total Total de la venta Numerico 2 decimales SI
Fecha_transaccion Fecha del momento de transacción Formato "AAAA-MMDD HH:MM:SS" SI

1.PARÁMETRO

firstName

2.DESCRIPCIÓN

Nombre del cliente

3.TIPO

TEXTO

4.REQ

SI

1.PARÁMETRO

lastName

2.DESCRIPCIÓN

Apellido del cliente

3.TIPO

TEXTO

4.REQ

SI

1.PARÁMETRO

street1

2.DESCRIPCIÓN

Dirección del envío

3.TIPO

TEXTO

4.REQ

SI

1.PARÁMETRO

country

2.DESCRIPCIÓN

Nombre del país

3.TIPO

TEXTO

4.REQ

SI

1.PARÁMETRO

city

2.DESCRIPCIÓN

Ciudad o departamento del país

3.TIPO

TEXTO

4.REQ

SI

1.PARÁMETRO

state

2.DESCRIPCIÓN

Estado o Municipio de la ciudad

3.TIPO

TEXTO

4.REQ

SI

1.PARÁMETRO

postalCode

2.DESCRIPCIÓN

Código postal

3.TIPO

Numerico

4.REQ

SI

1.PARÁMETRO

email

2.DESCRIPCIÓN

Correo electrónico del cliente

3.TIPO

Texto

4.REQ

SI

1.PARÁMETRO

ipAddress

2.DESCRIPCIÓN

IP del cliente

3.TIPO

Texto

4.REQ

SI

1.PARÁMETRO

phone

2.DESCRIPCIÓN

Telefono del cliente

3.TIPO

Numerico

4.REQ

SI

1.PARÁMETRO

Total

2.DESCRIPCIÓN

Total de la venta

3.TIPO

Numerico 2 decimales

4.REQ

SI

1.PARÁMETRO

Fecha_transaccion

2.DESCRIPCIÓN

Fecha del momento de transacción

3.TIPO

Formato "AAAA-MMDD HH:MM:SS"

4.REQ

SI

Ejemplo:

                      
      $clientes[] = array(
        'firstName' => 'Juan',
        'lastName' => 'Pérez',
        'street1' => '12 avenida Zona 15',
        'country' => 'Guatemala',
        'city' => 'Guatemala',
        'state' => 'Guatemala',
        'postalCode' => '01015',
        'email' => 'prez@gmail.com',
        'ipAddress' => '192.168.1.45',
        'Total' => '70.00'
        'fecha_transaccion' => '2017-05-31 09:05:00'
      );
                      
                      
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                      
                    

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

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 Numérico con 2 decimales SI
cantidad Cantidad del producto Numérico SI
tipo Tipo de Producto (producto, servicio, reserva) Texto SI
subtotal Precio x cantidad del producto Numérico con 2 decimales SI

1.PARÁMETRO

id_producto

2.DESCRIPCIÓN

SKU o ID único para identificar el producto

3.TIPO

Texto

4.REQ

SI

1.PARÁMETRO

nombre

2.DESCRIPCIÓN

Nombre del producto

3.TIPO

Texto

4.REQ

SI

1.PARÁMETRO

precio

2.DESCRIPCIÓN

Precio del producto

3.TIPO

Numérico con 2 decimales

4.REQ

SI

1.PARÁMETRO

cantidad

2.DESCRIPCIÓN

Cantidad del producto

3.TIPO

Numérico

4.REQ

SI

1.PARÁMETRO

tipo

2.DESCRIPCIÓN

Tipo de Producto (producto, servicio, reserva)

3.TIPO

Texto

4.REQ

SI

1.PARÁMETRO

subtotal

2.DESCRIPCIÓN

Precio x cantidad del producto

3.TIPO

Numérico con 2 decimales

4.REQ

SI

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.

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

Ejemplos:

                      
      $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 (ejemplos):

https://sandbox.pagalocard.com/api/v1/integracion/r4124ws4t1s321a45121?empresa=$empresa&cliente=$cliente&detalle=$detalle&tarjetaPagalo=$tarjetaPagalo

Respuestas

Parámetros de respuesta:

CÓDIGO DESCRIPCIÓN
codigo_respuesta Código de aprobación o rechazo
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

Códigos de aprobado y errores:

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