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:

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:Operación exitosa
messageUserEng
String
required

Mensaje amigable para el usuario en inglés

Longitud (min - max): 5 - 50
Ejemplo:Successful
response
Object
required

Objeto de datos de respuesta

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:QBY3s3RRMwHqFmF93lhRTTqrjcuolsVBCUnDFXniKY8=
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: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",
          "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