Hooks billetterie et paiements

Ces hooks suivent la partie payante de HappenBoard Pro : types de billets, commandes Stripe et WooCommerce, remboursements. Ils couvrent aussi les lignes payées restées sans place, la limite des paiements par visiteur et l’empreinte bancaire des demandes de rendez-vous. Ils servent à reporter ventes et remboursements dans votre comptabilité, votre CRM ou d’autres outils.

Le côté administrateur est décrit dans Configurer Stripe et Rembourser une commande. La vente via WooCommerce est présentée dans Vendre vos billets via WooCommerce. Si vous n’avez jamais utilisé les hooks de HappenBoard, commencez par Étendre HappenBoard avec les hooks.

Tous les hooks de cette page sont déclenchés par HappenBoard Pro. Voir Ce que Pro ajoute.

Comment une commande est enregistrée

Quand un paiement est confirmé, Pro écrit une ligne de participant par ligne de billet, avec une ligne de vente à côté. La ligne de vente garde le montant payé, ce qui en a été remboursé et l’indication que ses places comptent ou non dans la capacité du billet. Le tableau de bord Commandes lit ces montants : changer un prix plus tard ne modifie pas les commandes passées.

Les montants sont en unités mineures de la devise : centimes pour EUR, yens pour JPY. Un paiement se fait dans une seule devise. Un panier qui mélange des devises est refusé avant tout appel à Stripe, et aucun hook de cette page ne se déclenche.

Un panier de billets gratuits du bloc Ticket Picker ne passe jamais par Stripe. Ses billets sont émis tout de suite et seul happenboard_rsvp_submitted se déclenche, avec source à free_ticket. Voir Hooks participants et inscriptions.

Quel hook se déclenche, et quand

Un remboursement Stripe peut venir de l’écran Orders ou du tableau de bord Stripe : les deux sont enregistrés de la même façon, et une seule fois. Chaque participant annulé au passage déclenche aussi happenboard_rsvp_cancelled.

Paiements des rendez-vous

Pro encaisse les rendez-vous en répondant aux filtres de paiement de l’extension gratuite, décrits dans Hooks prise de rendez-vous. Son seul hook propre pour eux est happenboard_pro_booking_hold_hours, en fin de page. Les paiements de rendez-vous ne déclenchent jamais les hooks Stripe ci-dessus.

do_action( 'happenboard_pro_ticket_saved', int $ticket_id )

add_action(
    'happenboard_pro_ticket_saved',
    function ( $ticket_id ) {
        $tickets = new \HappenBoard\Pro\Service\Tickets\Repository();
        $ticket  = $tickets->find( (int) $ticket_id );
        if ( null === $ticket ) {
            return;
        }
        // $ticket['eventId'], $ticket['priceCents'], $ticket['currency']...
        my_crm_sync_ticket( $ticket );
    }
);

do_action( 'happenboard_pro_ticket_deleted', int $ticket_id, array<string,mixed>|null $snapshot )

add_action(
    'happenboard_pro_ticket_deleted',
    function ( $ticket_id, $snapshot ) {
        if ( ! is_array( $snapshot ) ) {
            return;
        }
        // La ligne telle qu'elle était juste avant la suppression.
        error_log( sprintf(
            'Ticket %d (%s) removed from event %d, %d sold.',
            $ticket_id,
            $snapshot['name'],
            $snapshot['eventId'],
            $snapshot['sold']
        ) );
    },
    10,
    2
);

apply_filters( 'happenboard_pro_checkout_limits', array $limits, string $ip )

add_filter(
    'happenboard_pro_checkout_limits',
    function ( $limits, $ip ) {
        // Le poste de la billetterie vend beaucoup de billets par heure.
        if ( '203.0.113.10' === $ip ) {
            $limits['checkouts_per_hour'] = 200;
            $limits['seats_per_hour']     = 1000;
        }

        return $limits;
    },
    10,
    2
);

do_action( 'happenboard_stripe_checkout_completed', int $event_id, array<int,int> $created_attendee_ids, array<string,mixed> $session )

add_action(
    'happenboard_stripe_checkout_completed',
    function ( $event_id, $attendee_ids, $session ) {
        $session_id = (string) ( $session['id'] ?? '' );
        if ( '' === $session_id || get_option( 'my_sale_' . $session_id ) ) {
            return; // Déjà enregistrée lors d'une livraison précédente.
        }
        my_accounting_record_sale(
            (int) $event_id,
            $attendee_ids,
            (int) ( $session['amount_total'] ?? 0 ),
            strtoupper( (string) ( $session['currency'] ?? '' ) )
        );
        update_option( 'my_sale_' . $session_id, 1, false );
    },
    10,
    3
);

do_action( 'happenboard_pro_ticket_unseated', int $attendee_id, array<string,mixed> $context )

add_action(
    'happenboard_pro_ticket_unseated',
    function ( $attendee_id, $context ) {
        if ( 'refunded' === $context['outcome'] ) {
            return; // Stripe a déjà rendu l'argent.
        }
        wp_mail(
            get_option( 'admin_email' ),
            'Paid ticket without a seat',
            sprintf(
                'Attendee #%d (%s) paid for %d seat(s) of ticket %d and got none. Outcome: %s.',
                $attendee_id,
                $context['email'],
                $context['quantity'],
                $context['ticket_id'],
                $context['outcome']
            )
        );
    },
    10,
    2
);

do_action( 'happenboard_pro_stripe_refund_recorded', string $payment_intent, array<int,int> $gained, string $currency )

add_action(
    'happenboard_pro_stripe_refund_recorded',
    function ( $payment_intent, $gained, $currency ) {
        // Une ligne comptable par participant concerné par le remboursement.
        foreach ( $gained as $attendee_id => $minor_units ) {
            my_accounting_record_refund(
                $payment_intent,
                (int) $attendee_id,
                (int) $minor_units,
                $currency
            );
        }
    },
    10,
    3
);

do_action( 'happenboard_stripe_refunded', string $payment_intent, array<int,int> $cancelled, array<string,mixed> $source )

add_action(
    'happenboard_stripe_refunded',
    function ( $payment_intent, $cancelled, $source ) {
        // Le paiement est remboursé en entier : on clôt la vente.
        my_accounting_close_sale(
            $payment_intent,
            (int) ( $source['amount_refunded'] ?? 0 ),
            strtoupper( (string) ( $source['currency'] ?? '' ) ),
            $cancelled
        );
    },
    10,
    3
);

apply_filters( 'happenboard_pro_wc_pay_later_methods', array<int,string> $methods, WC_Order $order )

add_filter(
    'happenboard_pro_wc_pay_later_methods',
    function ( $methods, $order ) {
        // Cette passerelle met les commandes en « processing » avant tout encaissement.
        $methods[] = 'my_pay_on_site';

        return $methods;
    },
    10,
    2
);

do_action( 'happenboard_pro_wc_order_fulfilled', int $order_id, array<int,int> $created, WC_Order $order )

add_action(
    'happenboard_pro_wc_order_fulfilled',
    function ( $order_id, $created, $order ) {
        if ( array() === $created ) {
            return; // Aucune ligne de billet dans cette commande.
        }
        $order->add_order_note( sprintf(
            '%d HappenBoard attendee row(s) created.',
            count( $created )
        ) );
        $order->save();
    },
    10,
    3
);

do_action( 'happenboard_pro_wc_order_refunded', int $order_id, array<int,int> $gained, string $currency )

add_action(
    'happenboard_pro_wc_order_refunded',
    function ( $order_id, $gained, $currency ) {
        // Seulement le montant nouveau depuis le dernier appel.
        foreach ( $gained as $attendee_id => $minor_units ) {
            my_accounting_record_refund(
                'wc_' . (int) $order_id,
                (int) $attendee_id,
                (int) $minor_units,
                $currency
            );
        }
    },
    10,
    3
);

do_action( 'happenboard_pro_wc_order_reversed', int $order_id, array<int,int> $cancelled, WC_Order $order )

add_action(
    'happenboard_pro_wc_order_reversed',
    function ( $order_id, $cancelled, $order ) {
        // Annuler ce que vous aviez fait au traitement de la commande.
        foreach ( $cancelled as $attendee_id ) {
            my_crm_mark_cancelled( (int) $attendee_id, (int) $order_id );
        }
    },
    10,
    3
);

apply_filters( 'happenboard_pro_booking_hold_hours', int $hours )

add_filter(
    'happenboard_pro_booking_hold_hours',
    function ( $hours ) {
        // Refuser les demandes sans réponse après quatre jours au lieu de six.
        return 96;
    }
);

Pour aller plus loin

• Rembourser une commande : faire un remboursement complet ou partiel depuis l’écran Orders.
• Hooks participants et inscriptions : les hooks d’inscription et d’annulation que ces paiements déclenchent.
• Hooks prise de rendez-vous : prix et paiements des rendez-vous.