Eventos

Eventos son la manera en que te podemos comunicar cualquier cosa que ha pasado en tu cuenta. Para poderte notificar, creamos un objeto de evento, el cual contiene toda la información que necesitas saber sobre el evento. Un ejemplo de eventos es cuando el pago de un cargo es exitoso creamos el evento charge.paid.

Por medio de nuestro API podrás realizar llamadas para poder obtener información sobre un evento en específico.

Otra manera de poder recibir estos eventos es por medio de webhooks, donde mandaremos cada uno de los eventos directamente a tu servidor. Para saber un poco más sobre webhooks, puedes ver la sección de webhooks.

NOTA: Si tu servidor cuenta con alguna restricción mediante Firewall debes añadir la IP de nuestro servidor de eventos 52.200.151.182. Además, puedes seleccionar un puerto específico para tus webhooks. Los puertos que soportamos son el 80, 443 y el rango del 1025 al 10001.

Objeto Evento

Atributos

[{
  "livemode": false,
  "id":"523e04f2aef878a53c000001",
  "object":"event",
  "type":"charge.paid",
  "created_at": 1600094116,
  "data": {
    "object": {
      "id":"523e04d4aef8781eaa000001",
      "livemode": false,
      "created_at": 1600094116,
      "status":"paid",
      "currency":"MXN",
      "description":"Stogies",
      "failure_code": null,
      "failure_message": null,
      "object":"charge",
      "amount": 20000,
      "payment_method": {
        "service_name":"Conekta",
        "service_number":"127589",
        "object":"bank_transfer_payment",
        "type":"spei",
        "reference":"0011587"
      },
    },
    "previous_attributes": {
      "status":"pending_payment"
    }
  },
}]

Tipo

Descripción

id

string

Identificador único del cargo asignado al azar.

object

string

Clase del objeto. En este caso, "event"

livemode

boolean

false: Modo de prueba. true: Modo de producción.

created_at

integer (32-bit unix timestamp)

Fecha de creación del cargo.

type

string

Tipo de evento. Ejemplo: charge.paid, charge. refunded, etc.

data

hash

Hash que contiene toda la información asociada al evento.

Tipo de eventos

Tipo

Descripción

charge.created

Evento relacionado a un cargo

Este evento ocurre cuando un cargo ha sido creado pero todavía no ha sido pagado.

charge.paid

Evento relacionado a un cargo

Este evento ocurre cuando un cargo ha sido pagado.

charge.refunded

Evento relacionado a un cargo

Este evento ocurre cuando un cargo ha sido reembolsado en su totalidad al comprador.

charge.chargeback.created

Evento relacionado a un contracargo

Este evento ocurre cuando el tarjetahabiente no reconoce el cargo y contacta a su banco para generar un contracargo. Para más información sobre contracargos, visita la sección de chargebacks.

charge.chargeback.updated

Evento relacionado a un contracargo

Este evento ocurre cuando alguien dentro de tu cuenta actualiza el contracargo con evidencia que apoya el caso de contracargo. Para más información sobre contracargos, visita la sección de chargebacks.

charge.chargeback.under_review

Evento relacionado a un contracargo

Este evento ocurre cuando el contracargo ha sido bloqueado y la evidencia que has proporcionado ha sido enviada al banco adquiriente para revisar el caso. Para más información sobre contracargos, visita la sección de chargebacks.

charge.chargeback.won

Evento relacionado a un contracargo

Este evento ocurre cuando el contracargo ha sido resuelto a tu favor. En este momento, el monto del contracargo que había sido retenido será devuelto a tu saldo y será disponible para el siguiente depósito a tu cuenta. Para más información sobre contracargos, visita la sección de chargebacks.

charge.chargeback.lost

Evento relacionado a un contracargo

Este evento ocurre cuando el contracargo ha sido resuelto a favor del tarjetahabiente. El monto del contracargo que había sido retenido será enviado al tarjetahabiente. Para más información sobre contracargos, visita la sección de chargebacks.

subscription.created

Evento relacionado a una suscripción

Este evento ocurre cuando una nueva suscripción ha sido creada.

subscription.paused

Evento relacionado a una suscripción

Este evento ocurre cuando una suscripción ha sido pausada.

subscription.resumed

Evento relacionado a una suscripción

Este evento ocurre cuando una suscripción pausada ha sido reanudada.

subscription.canceled

Evento relacionado a una suscripción

Este evento ocurre cuando una suscripción ha sido cancelada. Aparte de que tú o el cliente haya cancelado la suscripción, también se cancelará después de varios intentos de realizar el cobro al cliente.

subscription.updated

Evento relacionado a una suscripción

Este evento ocurre cuando una suscripción ha sido actualizada ya sea con un nuevo plan o tarjeta.

subscription.paid

Evento relacionado a una suscripción

Este evento ocurre cuando una suscripción ha sido pagada.

subscription.payment_failed

Evento relacionado a una suscripción

Este evento ocurre cuando el pago de una suscripción no ha podido ser procesado. En caso de que la suscripción no pueda ser procesada después de 3 intentos consecutivos, la suscripción será cancelada.

Lista de events disponibles para suscripción (Webhooks)

charge.score_updated, charge.created, charge.declined, charge.expired, charge.preauthorized, charge.paid, charge.under_fraud_review, charge.fraudulent, charge.partially_refunded, charge.refunded, charge.voided, charge.reversed, charge.pending_confirmation, charge.canceled, charge.payment_attempt.failed, customer.created, customer.updated, customer.deleted, webhook.created, webhook.updated, webhook.deleted, card.created, card.updated, card.deleted, offline_recurrent_reference.created, offline_recurrent_reference.created, offline_recurrent_reference.created, offline_spei_recurrent_reference.created, offline_spei_recurrent_reference.created, offline_spei_recurrent_reference.created, inbound_payment.lookup, inbound_payment.payment_attempt, inbound_payment.reverse, shipping_contact.created, shipping_contact.updated, shipping_contact.deleted, fiscal_entities.created, fiscal_entities.updated, fiscal_entities.deleted, plan.created, plan.updated, plan.deleted, receipt.created, subscription.created, subscription.paused, subscription.resumed, subscription.canceled, subscription.expired, subscription.updated, subscription.paid, subscription.payment_failed, charge.chargeback.created, charge.chargeback.updated, charge.chargeback.under_review, charge.chargeback.lost, charge.chargeback.won, payout.failed, payout.retrying, payout.in_transit, payout.paid_out, payout.created, payee.created, payee.updated, payee.deleted, payee.payout_method.created, payee.payout_method.updated, payee.payout_method.deleted, order.canceled, order.charged_back, order.created, order.expired, order.fraudulent, order.under_fraud_review, order.paid, order.partially_refunded, order.pending_payment, order.pre_authorized, order.refunded, order.updated, order.voided, order.declined, line_item.created, line_item.updated, line_item.deleted, tax_line.created, tax_line.updated, tax_line.deleted, shipping_line.created, shipping_line.updated, shipping_line.deleted, discount_line.created, discount_line.updated, discount_line.deleted, webhook_ping