Saltar al contenido principal

Especificación de Notificación de Resultado de Operación

En caso el comercio desee recibir una notificación del estado final de la operación el comercio deberá exponer un servicio web que cumpla las siguientes definiciones:

Método HTTP
POST

Protocolo
REST

Formato
JSON

URL
string

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

1. Datos de envío​

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

Cabecera de entrada Headers​

El servicio expuesto por el cliente deberá aceptar el siguiente header HTTP:

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.

Ejemplo:Longitud: 5 - 40

Parámetros de entrada Body​

Importante

Solo en el caso de enviar pay_token_external en la propiedad action, se devolverá tales campos en el response:

  • response.token.network

  • response.token.cryptogram

  • response.token.requestorId

  • response.token.assuranceMethod

  • response.token.mitTransactionId

  • response.token.cardNumberSuffix

  • response.token.brand

  • response.token.cardType

El servicio expuesto por el cliente deberá aceptar los siguientes campos:

Aviso: Los campos marcados con * son de carácter obligatorio.

N°ParámetroTipoRestricciones y valoresDescripción
1 code*String

Longitud: 2 - 3

Ejemplo: 00

Código de respuesta de la autorización
2 message*String

Longitud: 5 - 30

Ejemplo: OK

Mensaje de respuesta de la autorización, de acuerdo al lenguaje
3 messageUser*String

Longitud: 5 - 50

Ejemplo: Operación exitosa

Mensaje amigable para el usuario, de acuerdo al lenguaje
4 messageUserEng*String

Longitud: 5 - 50

Ejemplo: Successful

Mensaje amigable para el usuario en inglés
5+ response*ObjectObjeto de datos de respuesta
6 payloadHttp*String

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

Mensaje original de respuesta que se utiliza para la generación de la firma.
7 signature*String

Ejemplo: QBY3s3RRMwHqFmF93lhRTTqrjcuolsVBCUnDFXniKY8=

Es el hash del payload del request expresando en una cadena de un valor en base64.
8 transactionId*String

Longitud: 5 - 40

Ejemplo: 172356538519500

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.

Aquí se muestra un ejemplo de respuesta

{
  "headers": [
    {"Accept": "application/json"},
    {"Content-Type": "application/json; charset=utf-8"},
    {"Host": "sandbox-api-pw.izipay.pe"},
    {"Transfer-Encoding": "chunked"},
    {"transactionId": "17370678303660"},
    {"Signature": "8RjPs9ykC7ukUMcCiCvSaBdEUwraNQiauWWGlEouAqg="},
    {"traceparent": "00-4ed7ff545f524695ca2cbe180adf78d0-6af61a35aab751b8-00"}
  ],
  "body": {
    "code": "00",
    "message": "Operación exitosa",
    "messageUser": "Operación exitosa",
    "messageUserEng": "Successful",
    "response": {
      "payMethod": "CARD",
      "order": [
        {
          "payMethodAuthorization": "CARD",
          "codeAuth": "831000",
          "currency": "PEN",
          "amount": "149.00",
          "installment": "",
          "deferred": "",
          "orderNumber": "1737067830",
          "stateMessage": "Autorizado",
          "dateTransaction": "20250116",
          "timeTransaction": "174953",
          "uniqueId": "1429386",
          "referenceNumber": "6330605",
          "paymentLinkId": "1450558deaf948f2a46a37ddfcd85ea1"
        }
      ],
      "card": {
        "brand": "MC",
        "pan": "511842******6017",
        "save": "false"
      },
      "billing": {
        "firstName": "Lucho",
        "lastName": "Torres",
        "email": "luchotorres@gmail.com",
        "phoneNumber": "989897960",
        "street": "Av. Jorge Chávez 275",
        "city": "Lima",
        "state": "Lima",
        "country": "PE",
        "postalCode": "15000",
        "documentType": "DNI",
        "document": "12345678",
        "companyName": ""
      },
      "merchant": {
        "merchantCode": "4001061",
        "facilitatorCode": ""
      },
      "token": {
        "merchantBuyerId": "MC20250101",
        "cardToken": "",
        "alias": ""
      },
      "authentication": {
        "result": ""
      },
      "customFields": [
        {
          "name": "field1",
          "value": ""
        },
        {
          "name": "field2",
          "value": ""
        },
        {
          "name": "field3",
          "value": ""
        },
        {
          "name": "field4",
          "value": ""
        },
        {
          "name": "field5",
          "value": ""
        },
        {
          "name": "field6",
          "value": ""
        },
        {
          "name": "field7",
          "value": ""
        },
        {
          "name": "field8",
          "value": ""
        },
        {
          "name": "field9",
          "value": ""
        },
        {
          "name": "field10",
          "value": ""
        }
      ]
    },
    "transactionId": "17370678303660",
    "payloadHttp": "{\"code\":\"00\",\"message\":\"Operación exitosa\",\"messageUser\":\"Operación exitosa\",\"messageUserEng\":\"Successful\",\"response\":{\"payMethod\":\"CARD\",\"order\":[{\"payMethodAuthorization\":\"CARD\",\"codeAuth\":\"831000\",\"currency\":\"PEN\",\"amount\":\"149.00\",\"installment\":\"\",\"deferred\":\"\",\"orderNumber\":\"1737067830\",\"stateMessage\":\"Autorizado\",\"dateTransaction\":\"20250116\",\"timeTransaction\":\"174953\",\"uniqueId\":\"1429386\",\"referenceNumber\":\"6330605\"}],\"card\":{\"brand\":\"MC\",\"pan\":\"511842******6017\",\"save\":\"false\"},\"billing\":{\"firstName\":\"Lucho\",\"lastName\":\"Torres\",\"email\":\"luchotorres@gmail.com\",\"phoneNumber\":\"989897960\",\"street\":\"Av. Jorge Chávez 275\",\"city\":\"Lima\",\"state\":\"Lima\",\"country\":\"PE\",\"postalCode\":\"15000\",\"documentType\":\"DNI\",\"document\":\"12345678\",\"companyName\":\"\"},\"merchant\":{\"merchantCode\":\"4001061\",\"facilitatorCode\":\"\"},\"token\":{\"merchantBuyerId\":\"MC20250101\",\"cardToken\":\"\",\"alias\":\"\"},\"authentication\":{\"result\":\"\"},\"customFields\":[{\"name\":\"field1\",\"value\":\"\"},{\"name\":\"field2\",\"value\":\"\"},{\"name\":\"field3\",\"value\":\"\"},{\"name\":\"field4\",\"value\":\"\"},{\"name\":\"field5\",\"value\":\"\"},{\"name\":\"field6\",\"value\":\"\"},{\"name\":\"field7\",\"value\":\"\"},{\"name\":\"field8\",\"value\":\"\"},{\"name\":\"field9\",\"value\":\"\"},{\"name\":\"field10\",\"value\":\"\"}]},\"transactionId\":\"17370678303660\"}",
    "signature": "8RjPs9ykC7ukUMcCiCvSaBdEUwraNQiauWWGlEouAqg="
  }
}
Información

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

Última actualización en