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:

ParámetroTipoRequeridoDescripciónRestricciones y valores
codeStringSíCódigo de respuesta de la autorización

Longitud: 2 - 3

Ejemplo: 00

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

Longitud: 5 - 30

Ejemplo: OK

messageUserStringSíMensaje amigable para el usuario, de acuerdo al lenguaje

Longitud: 5 - 50

Ejemplo: Operación exitosa

messageUserEngStringSíMensaje amigable para el usuario en inglés

Longitud: 5 - 50

Ejemplo: Successful

+ responseObjectSíObjeto de datos de respuesta
payloadHttpStringSíMensaje original de respuesta que se utiliza para la generación de la firma.

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

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

Ejemplo: QBY3s3RRMwHqFmF93lhRTTqrjcuolsVBCUnDFXniKY8=

transactionIdStringSí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: 5 - 40

Ejemplo: 172356538519500


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"
        }
      ],
      "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