Das Premium-Plugin von Redsys, das ihr auf WooCommerce.com finden könnt, beinhaltet eine eigene API, die ihr von jedem anderen Plugin oder Theme für WordPress nutzen könnt. Dies erleichtert das Leben der Entwickler und gibt ihnen Werkzeuge, um ihre Ideen basierend auf dem Premium-Plugin und Redsys umzusetzen.
Die magische Funktion, die erstellt wurde, ist WCRed() und durch sie kann man viele Informationen erhalten, die in den neuen Versionen zunehmen werden.
WCRed()->get_order( $order_id );Wird verwendet, um $order zu erhalten
WCRed()->get_ds_error();Gibt ein Array() mit allen DS-Fehlern und deren Bedeutung zurück.
WCRed()->get_ds_response();Gibt ein Array() mit allen DS-Antwortcodes und deren Bedeutung zurück.
WCRed()->get_msg_error();Gibt ein Array() mit allen msg-Fehlern und deren Bedeutung zurück.
WCRed()->is_ds_error( $error_code = null );Der Fehler muss übergeben werden, und es gibt true oder false zurück, je nachdem, ob es ein DS-Fehler ist oder nicht.
WCRed()->is_ds_response( $error_code = null );Die Nachricht muss übergeben werden, und es gibt true oder false zurück, je nachdem, ob es eine DS-Antwort ist oder nicht.
WCRed()->is_msg_error( $error_code = null );Der msg muss übergeben werden, und es gibt true oder false zurück, je nachdem, ob es ein msg-Fehler ist oder nicht.
WCRed()->get_msg_error_by_code( $error_code = null );Die Nachricht muss übergeben werden, und es gibt zurück, was es bedeutet, wenn es ein msg-Fehler ist. Wenn nicht, gibt es false zurück.
WCRed()->get_error_by_code( $error_code = null );Der DS-Fehler muss übergeben werden, und es gibt zurück, was es bedeutet, wenn es ein DS-Fehler ist. Wenn nicht, gibt es false zurück.
WCRed()->get_response_by_code( $error_code = null );Die DS-Antwort muss übergeben werden, und es gibt zurück, was es bedeutet, wenn es eine DS-Nachricht ist. Wenn nicht, gibt es false zurück.
WCRed()->is_redsys_error( $error_code = null );Der Fehler oder die Antwort wird übergeben, und es gibt true oder false zurück, je nachdem, ob es ein Redsys-Fehler ist oder nicht.
WCRed()->get_error( $error_code = null );Der DS-Fehler, der msg-Fehler oder die DS-Antwort wird übergeben, und es gibt zurück, was es bedeutet. Es ist nicht notwendig, anzugeben, was es ist. Wenn es nichts von alledem ist, gibt es false zurück.
WCRed()->get_error_type( $error_code = null );Der Fehler wird übergeben, und es gibt den Typ zurück:
- ds_error
- ds_response
- msg_error
WCRed()->get_currencies();Gibt ein Array() mit allen Währungen von Redsys und deren Codes zurück.
WCRed()->allowed_currencies();Gibt ein Array() mit den in Redsys erlaubten Währungen zurück. Dass sie erlaubt sind, bedeutet nicht, dass sie am Terminal aktiv sind.
WCRed()->get_redsys_languages();Gibt ein Array mit den Sprachen und deren Codes zurück. Die Sprachen sind keine Codes, das heißt, im Array sind Spanisch, Englisch – Englisch, Katalanisch, Französisch – Französisch, und jede mit ihrem Code in Redsys verbunden.
WCRed()->get_redsys_wp_languages();Gibt ein Array() mit allen WordPress-Sprachcodes zurück, die mit dem Code in Redsys verbunden sind.
WCRed()->get_orders_type();Gibt ein Array() mit den verschiedenen Zahlungsmethoden von Redsys zurück, die über das Plugin möglich sind.
WCRed()->get_lang_code( $lang = 'en' );Der Sprachcode wird übergeben, und es gibt den Code in Redsys zurück. Es kann sowohl ein standardisierter Code (es, fr, en usw.) als auch ein WordPress-Code (es_ES, ca, en_US, en, en_GB) übergeben werden.
Wenn die Sprache in Redsys nicht existiert, wird immer „2“ zurückgegeben, was der Code für Englisch ist.
WCRed()->order_exist( $order_id );Der Bestell-ID wird übergeben, und es wird gesagt, ob die Bestellung existiert, es gibt true oder false zurück.
WCRed()->post_exist( $post_id );Der $POST-ID wird übergeben, und es wird gesagt, ob er existiert. Achtung, es kann jeder Beitrag, Beitragstyp oder benutzerdefinierter Beitragstyp sein, es wird nur gesagt, ob er existiert.
WCRed()->is_redsys_order( $order_id, $type = null );Es kann ein Parameter oder zwei übergeben werden. Wenn nur der erste Parameter (die Bestell-ID) übergeben wird, wird gesagt, ob die Bestellung über Redsys mit einer der Zahlungsmethoden, die das Plugin hinzufügt, getätigt wurde, und es gibt true oder false zurück. Wenn der zweite Parameter übergeben wird, wird true oder false zurückgegeben, je nachdem, ob die Zahlung über diese spezifische Zahlungsmethode erfolgt ist.
Die möglichen Werte für $type sind:
- redsys
- masterpass
- redsysbank
- bizumredsys
- iupay
- insite
- redsyspreauthorizations
WCRed()->get_gateway( $order_id );Der Bestell-ID wird übergeben, und es gibt die ID des Gateways zurück, mit dem bezahlt wurde. Wenn die Bestell-ID nicht existiert, gibt es false zurück.
WCRed()->get_order_date( $order_id );Der Bestell-ID wird übergeben, und es gibt das Zahlungsdatum in Redsys zurück. Wenn kein Datum vorhanden ist oder es keine Zahlung von Redsys ist, gibt es false zurück.
WCRed()->get_order_hour( $order_id );Der Bestell-ID wird übergeben, und es gibt die Zahlungszeit in Redsys zurück. Wenn keine Zeit vorhanden ist oder es keine Zahlung von Redsys ist, gibt es false zurück.
WCRed()->get_order_auth( $order_id );Der Bestell-ID wird übergeben, und es gibt den Authentifizierungscode der Zahlung in Redsys zurück. Wenn kein Code vorhanden ist oder es keine Zahlung von Redsys ist, gibt es false zurück.
WCRed()->get_status_pending();Gibt ein Array() mit den möglichen Status von ausstehenden Zahlungen zurück, die das Redsys- und WooCommerce-Plugin hinzufügt.
apply_filters( 'redsys_status_pending', $status );Dieser Filter, der sich innerhalb von WCRed()->get_status_pending() befindet, dient dazu, dass bei Bedarf weitere Status einfach hinzugefügt werden können und die Funktion WCRed()->get_status_pending() die korrekten ausstehenden Status zurückgibt.
WCRed()->is_paid( $order_id );Der Bestell-ID wird übergeben, und es wird gesagt, ob sie bezahlt ist oder nicht.
WCRed()->get_redsys_option( $option, $gateway );Die Option, die man wissen möchte, und die ID des Gateways (welches auch immer) müssen übergeben werden. Gibt den Wert der Option zurück.
WCRed()->is_gateway_enabled( $gateway );Die ID des Gateways wird übergeben, und es gibt true oder false zurück, je nachdem, ob es existiert und aktiviert ist oder nicht.
WCRed()->check_if_token_is_valid( $token_id );Überprüft, ob ein Token mit der ID $token_id gültig ist (überprüft das Ablaufdatum der Karte). Wenn es gültig ist, gibt es „true“ zurück, wenn es nicht gültig ist (Ablaufdatum überschritten), wird es gelöscht und gibt false zurück.
WCRed()->get_redsys_users_token();Gibt das Redsys-Token des im Site identifizierten Benutzers zurück.
WCRed()->get_users_token_bulk( $user_id );Gibt das Token eines Benutzers nach ID zurück. Der Wert $user_id muss übergeben werden.
WCRed()->prepare_order_number( $order_id );Bereitet die Bestellnummer vor, um an Redsys gesendet zu werden.
WCRed()->clean_order_number( $ordernumber );Konvertiert die an Redsys gesendete Bestellnummer in die WooCommerce-Nummer.
WCRed()->redsys_amount_format( $total );Konvertiert den zu zahlenden Gesamtbetrag in das Format von Redsys.
WCRed()->set_txnid( $token_num, $redsys_txnid );Speichert den TXNID-Code. Der Token, mit dem wir ihn verknüpfen möchten, und der TXNID müssen übergeben werden.
WCRed()->get_txnid( $token_num );Ruft den TXNID-Code ab, der Token, von dem wir ihn abrufen möchten, muss übergeben werden.