> For the complete documentation index, see [llms.txt](https://docs.nevogate.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nevogate.com/segedlet/fizetesi-szolgaltato-specifikus-adatok/paypal-rest/extra-parameterek.md).

# Extra paraméterek

A *PayPal REST* lehetővé teszi automatikus feliratkozások használatát és kezelését előfizetésekhez, az ehhez szükséges egyedi adatok az `Extra` paraméterben adhatók át.

A paraméterek három csoportra bonthatók:

* termékadatok (`Product`)
* előfizetési terv adatai (`Plan`)
* előfizetés adatai (`Subscription`)

Az első indított tranzakció felel az előfizetésre történő feliratkozásért, melynek lehet kezdő költsége (`setupFee`) is.

Az előfizetést létrehozó, első tranzakció indításakor figyeljen a következőkre:

* kezdő költséggel (`setupFee`) rendelkező feliratkozáshoz az első tranzakciót a kezdő költség összegével hozza létre
* kezdő költséggel (`setupFee`) **nem** rendelkező feliratkozás esetén az első tranzakciót a következő összeggel hozza létre (lenti példa):

> első tranzakció összege = darabszám x (fizetési szekvenciák első összege + szállítási költség díja)

A *PayPal REST* a feliratkozások kezeléséhez és használatához a következő szolgáltató specifikus `Extra` paraméterekkel rendelkezik:

<table data-full-width="true"><thead><tr><th width="258">Paraméter</th><th width="130">Típus</th><th width="146">Érték</th><th>Leírás</th></tr></thead><tbody><tr><td><code>isSubscriptionPayment</code></td><td>boolean</td><td>• true<br>• false</td><td>Jelzi, hogy a létrehozott tranzakció feliratkozás egy előfizetésre vagy egyszeri fizetés.</td></tr><tr><td><code>Product</code></td><td>JSON object</td><td>egyedi értékek</td><td><p>Termékre vonatkozó információk.</p><p></p><p>Részletekért tekintse meg a <em>PayPal</em> oldalát (angol):</p><p></p><p><a href="https://developer.paypal.com/docs/subscriptions/integrate/">Integrate Subscriptions</a></p></td></tr><tr><td><code>Product: Id</code></td><td>string</td><td></td><td><p><em>PayPal</em> oldalán korábban létrehozott termék egyedi azonosítója.</p><p></p><p>Használata esetén egyéb termékadatok ismételt megadására nincs szükség.</p></td></tr><tr><td><code>Plan</code></td><td>JSON object</td><td></td><td><p>Az előfizetési tervre vonatkozó adatok.</p><p></p><p>Részletekért tekintse meg a <em>PayPal</em> oldalát (angol):</p><p></p><p><a href="https://developer.paypal.com/docs/subscriptions/integrate/">Integrate Subscriptions</a></p></td></tr><tr><td><code>Plan: Id</code></td><td>string</td><td></td><td><p><em>PayPal</em> oldalán korábban létrehozott előfizetési terv egyedi azonosítója.</p><p></p><p>Használata esetén az előfizetési tervre vonatkozó egyéb adatok ismételt megadására nincs szükség.</p></td></tr><tr><td><code>Subscription</code></td><td>JSON object</td><td></td><td><p>Előfizetésre vonatkozó adatok.</p><p></p><p>Részletekért tekintse meg a <em>PayPal</em> oldalát (angol):</p><p></p><p><a href="https://developer.paypal.com/docs/subscriptions/integrate/">Integrate Subscriptions</a></p></td></tr></tbody></table>

#### Mintakód

{% code overflow="wrap" %}

```php
{
   "isSubscription":true,
   "Product":{
      "name":"Video Streaming Service",
      "description":"Video streaming service",
      "type":"SERVICE",
      "category":"SOFTWARE",
      "image_url":"https://example.com/streaming.jpg",
      "home_url":"https://example.com/home"
   },
   "Plan":{
      "name":"Basic Plan",
      "description":"Basic plan",
      "quantity_supported":true,
      "billing_cycles":[
         {
            "frequency":{
               "interval_unit":"DAY",
               "interval_count":1
            },
            "tenure_type":"TRIAL",
            "sequence":1,
            "total_cycles":1,
            "pricing_scheme":{
               "fixed_price":{
                  "value":"6",
                  "currency_code":"USD"
               }
            }
         },
         {
            "frequency":{
               "interval_unit":"DAY",
               "interval_count":1
            },
            "tenure_type":"REGULAR",
            "sequence":2,
            "total_cycles":3,
            "pricing_scheme":{
               "fixed_price":{
                  "value":"10",
                  "currency_code":"USD"
               }
            }
         }
      ],
      "payment_preferences":{
         "auto_bill_outstanding":false,
         "setup_fee_failure_action":"CANCEL",
         "setup_fee":{
            "value":"12.2",
            "currency_code":"USD"
         },
         "payment_failure_threshold":1
      }
   },
   "Subscription":{
      "quantity":"1",
      "shipping_amount":{
         "currency_code":"USD",
         "value":"11.00"
      },
      "application_context":{
         "brand_name":"example"
      }
   }
}
```

{% endcode %}