Description

Le wpforms_square_process_get_payment_args_single vous permet de modifier les arguments de la demande de paiement unique de Square avant qu'ils ne soient envoyés. Vous pouvez l'utiliser pour injecter des données dynamiques, exécuter des Smart Tags dans la note de paiement ou ajuster les métadonnées.

Utilisez ce filtre pour exécuter les Smart Tags de WPForms à l'intérieur du champ de note Square afin que le détail de votre transaction dans Square puisse inclure les valeurs du formulaire. Le filtre Square note est limité à 500 caractères, il convient donc d'adapter votre texte en conséquence.

paramètretypedescription
$argsréseauArguments de paiement unique Square. Les clés les plus courantes sont les suivantes amount_money, customer_idet note.
$processProcessusL'instance de Square Process pour la soumission en cours. Permet d'accéder à $process->form_data et $process->fields.

Source

wpforms\src\Integrations\Square\Process.php

Exemple

// Process Smart Tags in the Square payment note and trim to 500 chars.
function wpf_dev_square_single_payment_args( $args, $process ) {
    if ( isset( $args['note'] ) ) {
        $note        = apply_filters(
            'wpforms_process_smart_tags',
            $args['note'],
            $process->form_data,
            $process->fields,
            0
        );
        $args['note'] = wp_html_excerpt( $note, 500 );
    }
    return $args;
}
add_filter( 'wpforms_square_process_get_payment_args_single', 'wpf_dev_square_single_payment_args', 10, 2 );

Article de référence