# Fizetési mód módosítása az admin felületen: átjáró-támogatás

> Hogyan teheted lehetővé az áruházkezelőknek, hogy egy előfizetés fizetési módját és meta-adatait az Előfizetés szerkesztése oldalon módosítsák.

Ez a fejezet fizetési átjáró fejlesztőknek szól. Azt írja le, hogyan támogathatja az átjáró a fizetési mód módosítását az **Előfizetés szerkesztése** oldalon. Ha az átjáród még nem támogatja az előfizetések feldolgozását, előbb a [Fizetési átjáró integrálása](https://hub.hellowp.io/hu/plugins/woocommerce-subscriptions/fejlesztoknek-fizetesi-atjaro-integracio/) fejezetet olvasd el. Az egyedi kódokra nem vonatkozik terméktámogatás.

A funkcióval az átjárók lehetővé teszik, hogy az áruházkezelő az új szerkesztő oldalon hozzáadja vagy módosítsa az előfizetés fizetési módját és a hozzá tartozó meta-adatokat. Az automatikus fizetés beállítása az előfizetés szerkesztésénél a [Előfizetés hozzáadása és szerkesztése](https://hub.hellowp.io/hu/plugins/woocommerce-subscriptions/webaruhaz-kezeles-elofizetes-hozzaadasa/) fejezetben szerepel.

![Az Előfizetés szerkesztése oldal: a Számlázás részben a Fizetési mód sora, itt még a Kézi megújítással](./kepek/fejlesztoknek-admin-fizetesi-mod-uj-elofizetes.webp)

*Az Előfizetés szerkesztése oldal: a Számlázás részben a Fizetési mód sora, itt még a Kézi megújítással* (https://minta-bolt.hu/wp-admin/admin.php?page=wc-orders--shop_subscription&action=new)

A **Számlázás** rész **Fizetési mód** sorát érinti a funkció: alapból itt csak a **Kézi megújítás** áll, a támogatást bejelentő átjárók a ceruza ikonra kattintva válnak választhatóvá.

Bármelyik átjáróhoz hozzáadható, amely vásárlói vagy bankkártya-tokeneket használ. A lépések:

1. Add hozzá a támogatási jelzőt, hogy az átjáró deklarálja: az áruházkezelő módosíthatja a fizetési módot.
2. Tedd lehetővé a fizetési meta-adatok módosítását.
3. Ellenőrizd az új meta-adatokat az előfizetés mentése előtt.

## 1. A támogatási jelző

Alapból a bővítmény az **Előfizetés szerkesztése** oldalon csak a beépített **Kézi megújítás** fizetési módra enged váltani. A funkció támogatásához add a `subscription_payment_method_change_admin` jelzőt az átjáró `$this->supports` tulajdonságához:

```php
$this->supports = array(
    // Más támogatási jelzők
    'subscription_payment_method_change_admin',
    // Más támogatási jelzők
);
```

Ha az átjáró bejelentette a támogatást, az **Előfizetés szerkesztése** oldalon választható fizetési módként megjelenik.

## 2. A fizetési meta-adatok módosítása

Hogy az áruházkezelő helyesen beállíthassa az automatikus fizetést az átjáróddal az **Előfizetés szerkesztése** oldalon, el kell mondanod a bővítménynek, milyen meta-adatokra van szüksége az átjáródnak az automatikus fizetések feldolgozásához. Ezt a `woocommerce_subscription_payment_meta` szűrővel teheted meg.

A szűrő visszahívása megkapja az áruház összes fizetési átjárójának meta-adat tömbjét és annak az előfizetésnek a `WC_Subscription` példányát, amelyhez a meta-adat tartozik. A tömbbe az átjáró azonosítóját használd kulcsként (`payment_meta[ AZ_ATJARO_AZONOSITOJA ]`), és töltsd fel az előfizetés jelenlegi vagy alapértelmezett értékeivel (az előfizetés a visszahívás második paramétere).

A szerkezet:

```php
$payment_meta[ AZ_ATJARO_AZONOSITOJA ] = array(
    'tabla_neve' => array(
        'meta_kulcs_1' => array(
            'value' => get_post_meta( $subscription->id, '...', true ),
            'label' => 'A felületen megjelenő felirat',
        ),
        'meta_kulcs_2' => array(
            'value' => get_user_meta( $subscription->customer_user, '...', true ),
            'label' => 'A felületen megjelenő felirat',
        ),
    ),
);
```

A bővítmény ezt kétféleképpen használja:

- ebből jeleníti meg a megfelelő mezőket az **Előfizetés szerkesztése** oldalon, ezért kötelező a `label` (felirat);
- ebből tudja, hova mentse a meta-adatot az oldal mentésekor, ezért kötelező a meta-kulcs és a tábla neve.

A tábla neve megmondja, hova tárolja és honnan olvassa a bővítmény a meta-adatot. Ha az érték `post_meta`, `user_meta` vagy `options`, a bővítmény magától menti az új adatot a megfelelő táblába, a webhely adatbázis-előtagjával (`wpdb->prefix`):

- a `payment_meta[ AZ_ATJARO_AZONOSITOJA ]['post_meta']` alatt lévő adat: `update_post_meta( $subscription, 'meta_kulcs', $uj_adat )`;
- a `['user_meta']` alatt lévő adat: `update_user_meta( $subscription->customer_user, 'meta_kulcs', $uj_adat )`;
- a `['options']` alatt lévő adat: `update_option( 'meta_kulcs', $uj_adat )`.

Ha az alap táblanevek nem megfelelőek az adataidnak, lásd lejjebb az egyedi tárolást.

Példa: így engedi a Stripe átjáró, hogy az adminisztrátorok módosítsák a `_stripe_customer_id` és a `_stripe_card_id` meta-adatot a post meta táblában:

```php
class WC_Gateway_Stripe_Addons extends WC_Gateway_Stripe {

    // ...

    /**
     * Hozzáadja az automatikus ismétlődő fizetéshez szükséges fizetési meta-adatokat,
     * hogy az áruházkezelők az Előfizetés szerkesztése oldalon kézzel is beállíthassák
     * az automatikus ismétlődő fizetést egy vásárlónak.
     *
     * @param array $payment_meta az automatikus fizetéshez szükséges meta-adatok asszociatív tömbje
     * @param WC_Subscription $subscription az előfizetés objektuma
     * @return array
     */
    public function add_subscription_payment_meta( $payment_meta, $subscription ) {

        $payment_meta[ $this->id ] = array(
            'post_meta' => array(
                '_stripe_customer_id' => array(
                    'value' => get_post_meta( $subscription->id, '_stripe_customer_id', true ),
                    'label' => 'Stripe Customer ID',
                ),
                '_stripe_card_id' => array(
                    'value' => get_post_meta( $subscription->id, '_stripe_card_id', true ),
                    'label' => 'Stripe Card ID',
                ),
            ),
        );

        return $payment_meta;
    }
}
```

## 3. A meta-adatok ellenőrzése

Hogy az áruházkezelők helyes adatot írjanak be, érdemes (nem kötelező, de erősen ajánlott) az adatot mentés előtt ellenőrizni. Erre való a `woocommerce_subscription_validate_payment_meta` szűrő. A visszahívások megkapják a `payment_method_id` és a `payment_meta` paramétert. A `payment_meta` a felhasználó által beírt összes adatot tartalmazza a 2. lépésben leírt szerkezetben. Az ellenőrző függvényt erre a szűrőre kösd.

Az ellenőrző függvényben dobott kivételeket a bővítmény elkapja, és a kivétel üzenete az **Előfizetés szerkesztése** oldal értesítési részén jelenik meg. Ha kivétel történt, az előfizetés mentése előtti összes új módosítás elveszik.

```php
function my_validation_function( $payment_method_id, $payment_meta ) {
    if ( 'AZ_ATJARO_AZONOSITOJA' === $payment_method_id ) {
        if ( 'example_throw' == $payment_meta['AZ_ATJARO_AZONOSITOJA']['post_meta']['example_meta_key'] ) {
            throw new Exception( 'Érvénytelen adat esetén ez a hiba jelenik meg az Előfizetés szerkesztése oldalon' );
        }
    }
}
add_action( 'woocommerce_subscription_validate_payment_meta', 'my_validation_function', 10, 2 );
```

A Stripe átjáró így ellenőrzi az adatait: kötelező a `_stripe_customer_id`, és `cus_` előtaggal kell kezdődnie; kötelező a `_stripe_card_id`, és `card_` előtaggal kell kezdődnie.

```php
public function validate_subscription_payment_meta( $payment_method_id, $payment_meta ) {

    if ( $this->id === $payment_method_id ) {

        if ( ! isset( $payment_meta['post_meta']['_stripe_customer_id']['value'] ) || empty( $payment_meta['post_meta']['_stripe_customer_id']['value'] ) ) {
            throw new Exception( 'A "_stripe_customer_id" érték kötelező.' );
        } elseif ( 0 !== strpos( $payment_meta['post_meta']['_stripe_customer_id']['value'], 'cus_' ) ) {
            throw new Exception( 'Érvénytelen ügyfélazonosító. A "_stripe_customer_id" értéke "cus_" előtaggal kell kezdődjön.' );
        }

        if ( ! isset( $payment_meta['post_meta']['_stripe_card_id']['value'] ) || empty( $payment_meta['post_meta']['_stripe_card_id']['value'] ) ) {
            throw new Exception( 'A "_stripe_card_id" érték kötelező.' );
        } elseif ( 0 !== strpos( $payment_meta['post_meta']['_stripe_card_id']['value'], 'card_' ) ) {
            throw new Exception( 'Érvénytelen kártyaazonosító. A "_stripe_card_id" értéke "card_" előtaggal kell kezdődnie.' );
        }
    }
}
```

## Tesztelés

Ha a fenti lépések megvannak, az átjárónak ezeket kell tudnia:

1. fizetési módként megjelenik az **Előfizetés szerkesztése** oldalon;
2. megjeleníti és menti az automatikus fizetéshez szükséges meta-adatokat;
3. ellenőrzi, hogy az áruházkezelő által megadott meta-adat érvényes-e.

Az ellenőrzés lépései:

1. Nyisd meg a **WooCommerce → Előfizetések** oldalt.
2. Kattints egy előfizetés azonosítójára az **Előfizetés szerkesztése** oldal megnyitásához.
3. Kattints a ceruza ikonra a **Számlázás** rész mellett.
4. Ellenőrizd, hogy megjelenik-e az automatikus fizetéshez szükséges összes mező.
5. Ha igen, írj be érvénytelen meta-adatot minden mezőbe.
6. Mentsd az előfizetést.
7. Ellenőrizd, hogy a megfelelő admin értesítések jelennek meg (az ellenőrző függvény kivételeinek üzenetei).
8. Ismételd meg ezt a három lépést az átjáród minden mezőjénél.
9. Írj be érvényes meta-adatot minden mezőbe.
10. Mentsd az előfizetést.
11. Indíts [korai megújítási fizetést](https://hub.hellowp.io/hu/plugins/woocommerce-subscriptions/megujitas-tesztelese/) az előfizetéshez.
12. Ellenőrizd, hogy a megújítási fizetés helyesen lefutott-e (a megújítási rendelés státusza **Feldolgozás alatt** vagy **Teljesítve**).
13. Az átjárónál ellenőrizd, hogy a megújítás az új ügyfelet vagy kártyát használta-e.

Ha az előfizetést a szokásos pénztárfolyamattal vásárolták, az **Előfizetés szerkesztése** oldalon a pénztárban használt fizetési mód látszik, mert az automatikus fizetéshez szükséges meta-adatot a pénztárban kellett begyűjteni. Ha az áruházkezelő az előfizetés fizetési módját az átjárádról másikra váltja, az átjáró már nem jelenik meg a lehetőségek között.

## Egyedi tárolás

Ha a meta-adatot máshol szeretnéd tárolni, a bővítmény a `wcs_save_other_payment_meta` akciót adja a mentéshez. Ahhoz, hogy a bővítmény ne mentse el maga az adatot, a tábla neve nem lehet `post_meta`, `postmeta`, `user_meta`, `usermeta` vagy `options`. Ezután a bővítményednek el kell kapnia a `wcs_save_other_payment_meta` akciót.

A példa az adatot a megjegyzések táblába menti, illetve a post meta táblába mentés előtt kiegészíti egy értékkel:

```php
function my_gateway_meta( $payment_details, $subscription ) {
    $payment_details[ AZ_ATJARO_AZONOSITOJA ] = array(
        'wc_comments' => array(
            '_gateway_comments' => array(
                'value' => get_comments_meta( /* ... */ ),
                'label' => 'A felületen megjelenő felirat',
            ),
        ),
        'wc_post_meta' => array(
            'meta_key_1' => array(
                'value' => get_post_meta( $subscription->id, 'meta_key_1', true ),
                'label' => 'A felületen megjelenő felirat',
            ),
        ),
    );
    return $payment_details;
}
add_filter( 'woocommerce_subscription_payment_meta', 'my_gateway_meta', 10, 2 );

function save_meta_in_comments( $subscription, $table, $meta_key, $meta_value ) {
    switch ( $table ) {
        case 'wc_comments':
            update_comments_meta( /* ... */, $meta_key, $meta_value );
            break;
        case 'wc_post_meta':
            update_post_meta( $subscription->id, $meta_key, $meta_value . '_edited' );
            break;
    }
}
add_action( 'wcs_save_other_payment_meta', 'save_meta_in_comments', 10, 4 );
```
