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. |
| customer.payment_source.card.blocked | Evento relacionado a una tarjeta bloqueada | Este evento ocurre cuando detectamos que los datos de la tarjeta ingresada no son correctos, expiraron y/o no va a poder procesarse por las entidades bancarias. Para solucionar el inconveniente, se debe re-tokenizar la tarjeta y agregar un nuevo payment-source al customer. |
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, customer.payment_source.card.blocked, 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