API Reference

Esta es la sección de la documentación destinada a ejemplificar el webhook enviado a la URL registrada por el comerciante, variando según el tipo de notificación.

Notificación de Pago

La Notificación de Pago se envía mediante los parámetros presentados a continuación:

{
  "event": "PAYMENT.REFUNDED",
  "data": {
    "id": "020000026803231938500000065382450000000000",
    "paymentLinkId": "b566309d-a420-4ff9-be44-a32a374c07f1",
    "status": 7,
    "returnCode": "FF",
    "returnMessage": "Sucesso",
    "authorizationCode": "006734",
    "orderNumber": "623b774a48472",
    "nsu": "623b775052d0e",
    "transactionType": "credit",
    "installments": "12",
    "brand": "mastercard",
    "amount": 452200,
    "fees": 15539,
    "liquid": 0,
    "refunds": 436661,
    "acquirer": "adiq",
    "createdAt": "2022-03-23 16:38:56",
    "updatedAt": "2022-06-20 10:45:47",
    "account": {
      "id": "8284b41c0c234b0f889b087a451de9420f2664fc",
      "name": "Sueli e Breno Contábil Ltda"
    },
    "events": [
      {
        "createdAt": "2022-06-20 10:45:47",
        "type": "PAYMENT.REFUNDED"
      },
      {
        "createdAt": "2022-03-23 16:38:56",
        "type": "PAYMENT.AUTHORIZED"
      },
      {
        "createdAt": "2022-03-23 16:38:56",
        "type": "PAYMENT.CREATED"
      }
    ]
  }
}

Siendo el parámetro event destinado al tipo de evento asociado a la notificación. A continuación, puedes ver la lista de eventos asociados a la notificación:

EventoDescripción
PAYMENT.CREATEDPrimer evento de un pago, indica que el pago ha sido creado.
PAYMENT.PRE_AUTHORIZEDEse estado indica la reserva del valor del pago en la tarjeta del cliente.
PAYMENT.AUTHORIZEDSignifica que el pago fue capturado y debitado de la tarjeta del cliente.
PAYMENT_NOT_AUTHORIZEDIndica que el pago creado ha sido denegado y no puede ser aprobado.
PAYMENT.CANCELLEDSignifica que el pago fue cancelado.
PAYMENT.REFUNDEDSignifica que el pago fue reembolsado.
PAYMENT.REFUNDED_REJECTEDSignifica que la solicitud de reembolso del pago fue negada.
PAYMENT.REFUNDED_WAITINGSignifica que la solicitud de reembolso de pago aún está siendo procesada.
PAYMENT.REVERSEDSignifica que el pago fue revertido debido a un contracargo (chargeback).

Esté atento a cada evento y mapee correctamente según la descripción de su significado.

Notificación de Establecimiento

A notificación de cambio de estado del establecimiento se envía según los parámetros siguientes:

{
  "event": "COMPANY.ACTIVE",
  "data": {
    "companyId": 1,
    "mccId": 208,
    "companyName": "Bruno E Ana Consultoria Financeira Me",
    "socialReason": "Bruno E Ana Consultoria Financeira Me",
    "type": "2",
    "documentNumber": "80017668000180",
    "softDescriptor": null,
    "siteUrl": null,
    "accessToken": "7612adf805f3408786d9181474977fd607149331",
    "active": "A"
  }
}

Siendo el parámetro event destinado al tipo de evento asociado a la notificación. A continuación, puedes ver la lista de eventos asociados a la notificación de establecimiento:

EventoDescripción
COMPANY.ACTIVESignifica que el establecimiento fue activado.
COMPANY.DELETEDSignifica que el Establecimiento fue eliminado.
COMPANY.INACTIVESignifica que el Establecimiento fue desactivado.
COMPANY.WAITINGSignifica que el Establecimiento está en análisis.

Permaneça atento a cada evento y mapee correctamente según la descripción de su significado.