Skip to main content
Un webhook está vinculado a una cuenta o a una app y se suscribe a los eventos que elijas. Usa la API de Webhooks para crear y actualizar endpoints, enviar un evento de prueba, inspeccionar el registro de entregas y reenviar las entregas que tu servidor no recibió. Consulta Webhooks y eventos para verificar firmas y gestionar reintentos.

Endpoints

Atributos

string
requerido
ID del webhook, con el prefijo hook_.
string
requerido
La versión de la API usada para dar formato a los payloads enviados a este endpoint de webhook.Opciones disponibles: v1, v2, v5
string | null
requerido
La versión fechada de la API (Api-Version-Date) a la que están fijados los payloads v1 de este endpoint: los eventos se serializan exactamente como una lectura REST en esta versión (con el serializador nativo cuando el recurso tiene uno). Null cuando no está fijada: webhooks legacy (v2/v5) y webhooks v1 con la forma de payload legacy.
boolean
requerido
Si se envían eventos de recursos secundarios. Por ejemplo, si el webhook está en una cuenta, habilitar esto envía eventos solo de sus subcuentas.
integer
requerido
Número de entregas consecutivas cuyo primer intento a este endpoint falló desde la última vez que aceptó una. Los reintentos posteriores de la misma entrega no lo incrementan. Se restablece a 0 cuando una entrega tiene éxito o se vuelve a habilitar el webhook.
string
requerido
Cuándo se creó el webhook, como marca de tiempo ISO 8601.
string | null
requerido
Cuándo deshabilitó Whop automáticamente este webhook, como marca de tiempo ISO 8601. null a menos que Whop haya deshabilitado el webhook; un webhook que deshabilitaste tú mismo tiene enabled: false y un disabled_at null.
string | null
requerido
Por qué Whop deshabilitó este webhook. delivery_failures significa que todas las entregas fallaron durante 3 días seguidos. null cuando disabled_at es null.Opciones disponibles: delivery_failures
boolean
requerido
Si este endpoint de webhook está activo actualmente y recibe eventos.
string[]
requerido
Tipos de eventos a los que está suscrito este webhook, en formato con puntos (por ejemplo, payment.succeeded).Opciones disponibles: account.updated, account.financing_approved, account.financing_denied, account.financing_disabled, invoice.created, invoice.marked_uncollectible, invoice.paid, invoice.past_due, invoice.voided, membership.activated, membership.deactivated, membership.trial_ending_soon, membership.updated, entry.created, entry.approved, entry.denied, entry.deleted, export.completed, export.failed, setup_intent.requires_action, setup_intent.succeeded, setup_intent.canceled, ledger_account.funds_available, swap.completed, deposit.succeeded, financial_activity.funds_available, transfer.created, transfer.completed, transfer.failed, withdrawal.created, withdrawal.updated, withdrawal.reversed, payout.created, payout.updated, payout.reversed, card_transaction.created, card_transaction.updated, card_transaction.completed, card_transaction.declined, card_transaction.reversed, card.created, card.updated, card.frozen, card.canceled, card_application.created, card_application.updated, card_application.approved, card_application.denied, course_lesson_interaction.completed, domain.created, domain.updated, domain.deleted, capital.created, capital.updated, payout_method.created, verification.succeeded, identity_profile.approved, identity_profile.rejected, identity_profile.needs_action, identity_profile.updated, payout_account.status_updated, payment.authorized, payment.canceled, resolution_center_case.created, resolution_center_case.updated, resolution_center_case.decided, product.created, product.updated, product.deleted, product.published, product.unpublished, plan.created, plan.updated, plan.deleted, shipment.created, shipment.updated, member.created, member.updated, ad_campaign.created, ad_campaign.payment_failed, ad_campaign.updated, ad_campaign.events, ad_campaign.deleted, ad_group.created, ad_group.updated, ad_group.deleted, ad.created, ad.updated, ad.deleted, app_installation.created, app_installation.deleted, events.created, chat.message.created, chat.reaction.created, payment.created, payment.succeeded, payment.failed, payment.pending, payment.requires_action, dispute.created, dispute.updated, refund.created, refund.updated, dispute_alert.created, membership.cancel_at_period_end_changed, membership.went_valid, membership.went_invalid, membership.metadata_updated, resolution.created, resolution.updated, resolution.decided, payment.affiliate_reward_created, membership.experience_claimed, app_membership.went_valid, app_membership.went_invalid, app_payment.created, app_payment.succeeded, app_payment.failed, app_payment.pending, app_payment.requires_action, app_membership.cancel_at_period_end_changed, shipping_address.changed
string | null
requerido
Cuándo comenzó la racha de fallos actual, como marca de tiempo ISO 8601. A diferencia de last_failure_at, se establece en el primer intento fallido de la racha, por lo que muestra un endpoint que está fallando en este momento. null cuando el endpoint funciona correctamente.
string | null
requerido
Cuándo falló por última vez una entrega a este endpoint tras agotar los reintentos, como marca de tiempo ISO 8601. null si nunca ha fallado ninguna entrega.
string
requerido
ID del recurso (cuenta o app) al que está vinculado este webhook.
string[]
requerido
El subconjunto de tipos de eventos suscritos que admiten el envío de payloads de prueba, en formato con puntos.Opciones disponibles: account.updated, account.financing_approved, account.financing_denied, account.financing_disabled, invoice.created, invoice.marked_uncollectible, invoice.paid, invoice.past_due, invoice.voided, membership.activated, membership.deactivated, membership.trial_ending_soon, membership.updated, entry.created, entry.approved, entry.denied, entry.deleted, export.completed, export.failed, setup_intent.requires_action, setup_intent.succeeded, setup_intent.canceled, ledger_account.funds_available, swap.completed, deposit.succeeded, financial_activity.funds_available, transfer.created, transfer.completed, transfer.failed, withdrawal.created, withdrawal.updated, withdrawal.reversed, payout.created, payout.updated, payout.reversed, card_transaction.created, card_transaction.updated, card_transaction.completed, card_transaction.declined, card_transaction.reversed, card.created, card.updated, card.frozen, card.canceled, card_application.created, card_application.updated, card_application.approved, card_application.denied, course_lesson_interaction.completed, domain.created, domain.updated, domain.deleted, capital.created, capital.updated, payout_method.created, verification.succeeded, identity_profile.approved, identity_profile.rejected, identity_profile.needs_action, identity_profile.updated, payout_account.status_updated, payment.authorized, payment.canceled, resolution_center_case.created, resolution_center_case.updated, resolution_center_case.decided, product.created, product.updated, product.deleted, product.published, product.unpublished, plan.created, plan.updated, plan.deleted, shipment.created, shipment.updated, member.created, member.updated, ad_campaign.created, ad_campaign.payment_failed, ad_campaign.updated, ad_campaign.events, ad_campaign.deleted, ad_group.created, ad_group.updated, ad_group.deleted, ad.created, ad.updated, ad.deleted, app_installation.created, app_installation.deleted, events.created, chat.message.created, chat.reaction.created, payment.created, payment.succeeded, payment.failed, payment.pending, payment.requires_action, dispute.created, dispute.updated, refund.created, refund.updated, dispute_alert.created, membership.cancel_at_period_end_changed, membership.went_valid, membership.went_invalid, membership.metadata_updated, resolution.created, resolution.updated, resolution.decided, payment.affiliate_reward_created, membership.experience_claimed, app_membership.went_valid, app_membership.went_invalid, app_payment.created, app_payment.succeeded, app_payment.failed, app_payment.pending, app_payment.requires_action, app_membership.cancel_at_period_end_changed, shipping_address.changed
string | null
requerido
Una etiqueta para este endpoint de webhook, como Production, que se muestra en el panel. null si no se ha establecido ningún título.
string
requerido
URL de destino donde se entregan los payloads del webhook mediante HTTP POST.
string | null
requerido
Clave secreta usada para firmar los payloads del webhook. Úsala para verificar la firma HMAC de cada entrega. Se devuelve en la respuesta de creación. null en lecturas posteriores mediante API keys y apps OAuth.
Webhook