Le plugin premium de Redsys que vous pouvez trouver sur WooCommerce.com, intègre une API propre que vous pouvez utiliser depuis n’importe quel autre plugin ou thème pour WordPress. Cela facilite la vie des développeurs et leur donne des outils pour exprimer leurs idées en se basant sur le plugin premium et Redsys.
La fonction magique créée est WCRed() et à travers elle, vous pouvez obtenir beaucoup d’informations, qui vont augmenter dans les nouvelles versions.
WCRed()->get_order( $order_id );Elle est utilisée pour obtenir $order
WCRed()->get_ds_error();Retourne un Array() avec toutes les erreurs DS et ce qu’elles sont.
WCRed()->get_ds_response();Retourne un Array() avec tous les codes de réponse DS et ce qu’ils signifient.
WCRed()->get_msg_error();Retourne un Array() avec toutes les erreurs msg et ce qu’elles signifient.
WCRed()->is_ds_error( $error_code = null );Vous devez passer l’erreur, et cela retourne true ou false selon si c’est une erreur DS ou non.
WCRed()->is_ds_response( $error_code = null );Vous devez passer le message, et cela retourne true ou false selon si c’est une réponse DS ou non.
WCRed()->is_msg_error( $error_code = null );Vous devez passer le msg, et cela retourne true ou false selon si c’est une erreur msg ou non.
WCRed()->get_msg_error_by_code( $error_code = null );Vous devez passer le message, et cela retourne ce que cela signifie si c’est une erreur msg. Si ce n’est pas le cas, cela retourne false.
WCRed()->get_error_by_code( $error_code = null );Vous devez passer l’erreur DS, et cela retourne ce que cela signifie si c’est une erreur DS. Si ce n’est pas le cas, cela retourne false.
WCRed()->get_response_by_code( $error_code = null );Vous devez passer la réponse DS, et cela retourne ce que cela signifie si c’est un message DS. Si ce n’est pas le cas, cela retourne false.
WCRed()->is_redsys_error( $error_code = null );Vous passez l’erreur ou la réponse, et cela retourne true ou false selon si c’est une erreur de Redsys ou non.
WCRed()->get_error( $error_code = null );Vous passez l’erreur DS, l’erreur msg ou la réponse DS, et cela retourne ce que cela signifie. Il n’est pas nécessaire de spécifier ce que c’est. Si ce n’est rien de tout cela, cela retourne false.
WCRed()->get_error_type( $error_code = null );Vous passez l’erreur, et cela retourne le type :
- ds_error
- ds_response
- msg_error
WCRed()->get_currencies();Retourne un Array() avec toutes les monnaies de Redsys et leurs codes.
WCRed()->allowed_currencies();Retourne un Array() avec les monnaies autorisées dans Redsys. Qu’elles soient autorisées ne signifie pas qu’elles soient actives sur le terminal.
WCRed()->get_redsys_languages();Retourne un tableau avec les langues et leur code. Les langues ne sont pas des codes, c’est-à-dire, par exemple dans le Array() il y a Espagnol, English – Anglais, Català, Français – Français, et chacun lié à son code dans Redsys.
WCRed()->get_redsys_wp_languages();Retourne un Array() avec tous les codes de langues de WordPress, liés au code dans Redsys.
WCRed()->get_orders_type();Retourne un Array() avec les différentes méthodes de paiement de Redsys possibles via le plugin.
WCRed()->get_lang_code( $lang = 'en' );Vous passez le code de langue, et cela retourne le code de celui-ci dans Redsys. Vous pouvez passer à la fois un code standardisé (es, fr, en, etc.), ainsi qu’un code de WordPress (es_ES, ca, en_US, en, en_GB).
Si la langue n’existe pas dans Redsys, cela retournera toujours «2», qui est le code pour l’anglais.
WCRed()->order_exist( $order_id );Vous passez l’ID de la commande, et cela vous dit si la commande existe, cela retourne true ou false.
WCRed()->post_exist( $post_id );Vous passez l’ID du $POST, et cela vous dit s’il existe. Attention, cela peut être n’importe quel Post, Type de Post ou Type de Post Personnalisé, cela vous dit juste s’il existe.
WCRed()->is_redsys_order( $order_id, $type = null );Vous pouvez passer un paramètre, ou deux. Si vous passez seulement le premier paramètre (l’ID de la commande), cela vous dira si la commande a été réalisée via Redsys dans l’une des méthodes de paiement ajoutées par le plugin, retournant true ou false. Si vous le passez avec le deuxième paramètre, cela répondra true ou false, selon si le paiement a été effectué via ce type de paiement spécifique.
Les valeurs possibles pour $type sont :
- redsys
- masterpass
- redsysbank
- bizumredsys
- iupay
- insite
- redsyspreauthorizations
WCRed()->get_gateway( $order_id );Vous passez l’ID de la commande, et cela retourne l’ID de la passerelle avec laquelle le paiement a été effectué. Si l’ID de la commande n’existe pas, cela retourne false.
WCRed()->get_order_date( $order_id );Vous passez l’ID de la commande, et cela retourne la date de paiement dans Redsys. S’il n’y a pas de date, ou si ce n’est pas un paiement de Redsys, cela retourne false.
WCRed()->get_order_hour( $order_id );Vous passez l’ID de la commande, et cela retourne l’heure de paiement dans Redsys. S’il n’y a pas d’heure, ou si ce n’est pas un paiement de Redsys, cela retourne false.
WCRed()->get_order_auth( $order_id );Vous passez l’ID de la commande, et cela retourne le code d’authentification du paiement dans Redsys. S’il n’y a pas de code, ou si ce n’est pas un paiement de Redsys, cela retourne false.
WCRed()->get_status_pending();Retourne un Array() avec les états possibles de paiement en attente que le plugin Redsys et WooCommerce ajoute.
apply_filters( 'redsys_status_pending', $status );Ce filtre qui se trouve dans WCRed()->get_status_pending() permet d’ajouter facilement plus d’états si nécessaire et que la fonction WCRed()->get_status_pending() retourne les états en attente corrects.
WCRed()->is_paid( $order_id );Vous passez l’ID de la commande, et cela vous dit si elle est payée ou non.
WCRed()->get_redsys_option( $option, $gateway );Vous devez passer l’option que vous souhaitez connaître, et l’ID de la passerelle (celle que ce soit). Cela retourne la valeur de l’option.
WCRed()->is_gateway_enabled( $gateway );Vous passez l’ID de la passerelle, et cela retourne true ou false selon si elle existe et est activée ou non.
WCRed()->check_if_token_is_valid( $token_id );Vérifie si un token avec l’ID $token_id est valide (vérifie la date d’expiration de la carte). Si c’est valide, cela retourne «true», si ce n’est pas valide (date expirée), cela le supprime et retourne false.
WCRed()->get_redsys_users_token();Retourne le token de Redsys de l’utilisateur identifié sur le site.
WCRed()->get_users_token_bulk( $user_id );Retourne le token d’un utilisateur par ID. Vous devez passer la valeur $user_id.
WCRed()->prepare_order_number( $order_id );Prépare le numéro de commande pour être envoyé à Redsys.
WCRed()->clean_order_number( $ordernumber );Convertit le numéro de commande envoyé à Redsys au numéro de WooCommerce.
WCRed()->redsys_amount_format( $total );Convertit le total à payer au format de Redsys.
WCRed()->set_txnid( $token_num, $redsys_txnid );Enregistre le code TXNID. Vous devez passer le token auquel nous voulons le relier et le TXNID.
WCRed()->get_txnid( $token_num );Récupère le code TXNID, vous devez passer le token dont nous voulons le récupérer.