Servicio de notificaciones

Si el comercio desea recibir una notificación del estado final de la operación, es necesario que implemente un servicio web que cumpla con las definiciones siguientes:

Método HTTP

POST

Protocolo

REST

Formato

JSON

URL

string

Será tomado del campo urlIPN indicado en la sección de Definición de parámetros

Datos de envío

El servicio expuesto deberá aceptar los siguientes datos pues serán los valores que enviará Izipay:

• Cabecera de entrada (HTTP Headers)

transactionId

String

required

Id único por cada transacción generada por el comercio.

Longitud (min - max): 5 - 40

Ejemplo:16881500822750

• Parámetros de entrada (HTTP Body)

code

String

required

Código de respuesta de la autorización

Longitud (min - max): 2 - 3

Ejemplo:00

message

String

required

Mensaje de respuesta de la autorización, de acuerdo al lenguaje

Longitud (min - max): 5 - 30

Ejemplo:Ok

messageUser

String

required

Mensaje amigable para el usuario, de acuerdo al lenguaje

Longitud (min - max): 5 - 50

Ejemplo:Ok

messageUserEng

String

required

Mensaje amigable para el usuario en inglés

Longitud (min - max): 5 - 50

Ejemplo:Ok

response

Object

required

Objeto de datos de respuesta

payMethod

String

required

Indicador del método de pago de la compra

Valores permitidos:CARDYAPE_CODE

Ejemplo:CARD

order

Array[{Object}]

required

Array de Objetos Order

payMethodAuthorization

String

required

Indicador del método de pago de la orden:

Valores permitidos:CARDYAPE_CODE

Ejemplo:CARD

codeAuth

String

Código de Autorizacion de la compra generada por el emisor de la tarjeta

Longitud (min - max): 0 - 10

currency

String

required

Moneda de la transacción.

Valores permitidos:PENUSD

Ejemplo:PEN

amount

String

required

Monto de la Txn. Enteros con 2 decimales, considerar separador decimal sin delimitador de miles

Longitud (min - max): 4 - 13

Ejemplo:10.00

installments

String

Número de Cuotas que afectarán a la compra.

Longitud (min - max): 2 - 2

Ejemplo:10

deferred

String

Número Diferido que afectará a la compras.

Longitud (min - max): 1 - 1

orderNumber

String

required

Número de Pedido de la transacción de compra, enviada en el api security (Token Session).

Longitud (min - max): 5 - 15

Ejemplo:1687996765

stateMessage

String

required

Mensaje del estado de la transacción (Autorizado/Denegado).

dateTransaction

String

required

Fecha de la transacción (fechatxn guardada en tabla transacciones) Formato yyyymmdd.

Longitud (min - max): 8 - 8

Ejemplo:20221212

timeTransaction

String

required

Hora de la transacción (fechatxn guardada en tabla transacciones) Formato hhmmss.

Longitud (min - max): 6 - 6

Ejemplo:185330

uniqueId

String

Indentificador de la transacción realizado por Izipay o Cybersource.

Longitud (min - max): 0 - 20

Ejemplo:1011173920740022

referenceNumber

String

Número de referencia generada por el adquiriente. Este dato es importante para la solicitud del refund(devoluciones)

Longitud (min - max): 0 - 7

Ejemplo:1315646

card

Object

required

Objeto con los datos de la tarjeta

brand

String

required

Tipo de marca de la tarjeta

Valores permitidos

• MC: MasterCard
• VS: Visa
• AE: Amex
• DN: Diners

Ejemplo:VS

pan

String

required

Número de tarjeta enmascarado utilizado en la transacción

Longitud (min - max): 12 - 19

Ejemplo:411111******1111

save

Boolean

Identificador si se registró la tarjeta en la operación

Ejemplo:true

billing

Object

required

Objeto de la Facturación (tarjetahabiente)

firstName

String

required

Nombres del tarjetahabiente

Longitud (min - max): 2 - 50

Ejemplo:Lucho

lastName

String

required

Apellidos del tarjetahabiente

Longitud (min - max): 2 - 50

Ejemplo:Torres

email

String

required

Correo electrónico del tarjetahabiente

Longitud (min - max): 5 - 50

Ejemplo:luchotorres@gmail.com

phoneNumber

String

required

Teléfono del tarjetahabiente

Longitud (min - max): 7 - 15

Ejemplo:989897960

street

String

required

Dirección de facturación del tarjetahabiente

Longitud (min - max): 5 - 40

Ejemplo:Av. Jorge Chávez 275

city

String

required

Ciudad de la dirección de facturación del tarjetahabiente

Longitud (min - max): 3 - 25

Ejemplo:Lima

state

String

required

Nombre del departamento o estado de facturación del tarjetahabiente

Longitud (min - max): 3 - 25

Ejemplo:Lima

country

String

required

País de la dirección de facturación del tarjetahabiente - Codigo ISO.

Longitud (min - max): 2 - 2

Ejemplo:PE

postalCode

String

required

Código Postal (CP) de la dirección de facturación del tarjetahabiente.

Longitud (min - max): 5 - 10

Ejemplo:15000

documentType

String

required

Tipo de documento de identidad del tarjetahabiente

Valores permitidos:DNICEPASAPORTERUCOTROS

Ejemplo:DNI

document

String

required

Número de documento de identidad del tarjetahabiente.

Longitud (min - max):DNI:= 8 caracteres
CE:>=9 caracteres <=12 caracteres
PASAPORTE:>=8 caracteres <=12 caracteres
RUC := 11 caracteres
OTROS:>=8 caracteres <=12 caracteres

Ejemplo:12345678

companyName

String

Razón social o nombre de la compañía.

Longitud (min - max): 2 - 25

merchant

Object

required

Objeto de datos del comercio

merchantCode

String

required

Codigo del comercio ó submerchant(codigo hijo del merchantFacilitator), generado por Izipay durante la afiliación.

Longitud (min - max): 7 - 15

facilitatorCode

String

Código de comercio facilitador, generado por Izipay durante la afilación.

Longitud (min - max): 7 - 15

token

Object

Objeto de Tokenizacion, Privada y Marca.

merchantBuyerId

String

Identificador único del comprador en el sistema del comercio.

Longitud (min - max): 6 - 100

cardToken

String

Valor token que identifica la tarjeta del tarjetahabiente.

Longitud (min - max): 0 - 64

alias

String

Alias de tarjeta.

Longitud (min - max): 0 - 20

authentication

Object

Objeto de autenticación.

result

String

Resultado de la autenticación.

customFields

Array<Object>

Array de objetos personalizados que permite agregar información extra al proceso de pago, para satisfacer las necesidades específicas de cada comercio. Máximo 10 objetos personalizados.

name

String

Nombre del objeto personalizado, no se debe repetir.

Longitud (min - max): 6 - 15

Valores permitidos:field1field2field3field4field5field6field7field8field9field10

Ejemplo:field1

value

String

Valor del objeto personalizado.

Longitud (min - max): 1 - 100

Ejemplo:""

Formato permitido:Solo permite valores que contengan letras (incluyendo mayúsculas, minúsculas, vocales con acentos como á, é, í, ó, ú, la ñ y la ü), números, espacios y los siguientes caracteres especiales: puntos (.), comas (,), guiones (-), diagonales (/) y el símbolo "&". También admite letras acentuadas de otros idiomas europeos como à, è u ö.

Regex:/^[a-zA-ZñÑáéíóúÁÉÍÓÚ\s&.,\/\-\u00C0-\u017FüÜ0-9]+$/u

payloadHttp

String

required

Mensaje original de respuesta que se utiliza para la generación de la firma.

Ejemplo:{"code":"00","message":"OK"…..}

signature

String

required

Es el hash del payload del request expresando en una cadena de un valor en base64.

Ejemplo:b166214e976c7e76390889

transactionId

String

required

Id único por cada transacción generada por el comercio, enviada en el api security (Token Session) equivalente al Id de Correlación para el flujo de la transacción.

Longitud (min - max): 5 - 40

Ejemplo:16881500822750

Información

Para una información más detallada visita la sección Notificaciones