> For the complete documentation index, see [llms.txt](https://docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verifone.com/api-reference/open-api-references/paypal-ecommerce/billing-plans.md). # Billing Plans **Billing Plans** define the pricing, billing cycles, and payment terms that subscribers are enrolled into. A plan belongs to a [Product](/api-reference/open-api-references/paypal-ecommerce/products.md) and is the template from which [Subscriptions](/api-reference/open-api-references/paypal-ecommerce/subscriptions.md) are created. Plans can be activated or deactivated to control availability without deletion. ## How It Works {% stepper %} {% step %} ## Create a product A billing plan must be associated with a product. See [Products](/api-reference/open-api-references/paypal-ecommerce/products.md) for how to create one. {% endstep %} {% step %} ## Create a billing plan Call `POST /billingPlans/create` with the product ID, pricing structure, and billing cycle configuration. {% endstep %} {% step %} ## Activate the plan New plans may require activation before subscribers can enroll. Call `PUT /billingPlans/{planId}/activate`. {% endstep %} {% step %} ## Create subscriptions With an active plan, call `POST /subscriptions` to enrol subscribers. See [Subscriptions](/api-reference/open-api-references/paypal-ecommerce/subscriptions.md). {% endstep %} {% endstepper %} ## List Billing Plans Returns a paginated list of billing plans. Filter by product ID or specific plan IDs. ## GET /billingPlans > List billing plans ```json {"openapi":"3.0.1","info":{"title":"PayPal eComm API","version":"1.6.0"},"servers":[{"url":"https://emea.gsc.verifone.cloud/oidc/paypal-ecom","description":"EMEA Production"},{"url":"https://us.gsc.verifone.cloud/oidc/paypal-ecom","description":"Americas Production"},{"url":"https://nz.gsc.verifone.cloud/oidc/paypal-ecom","description":"New Zealand"},{"url":"https://cst.test-gsc.vfims.com/oidc/paypal-ecom","description":"Global Sandbox"},{"url":"https://uscst.gb.gsc.cficloud/oidc/paypal-ecom","description":"Americas Sandbox"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"Model4":{"type":"object","properties":{"plans":{"$ref":"#/components/schemas/plans"},"totalItems":{"type":"number","description":"The total number of items."},"totalPages":{"type":"number","description":"The total number of pages."}}},"plans":{"type":"array","items":{"$ref":"#/components/schemas/Model3"}},"Model3":{"required":["billingCycles","createTime","name","paymentPreferences"],"type":"object","properties":{"id":{"maxLength":50,"minLength":6,"type":"string","description":"Filters the response by a Product ID."},"name":{"maxLength":127,"type":"string","description":"The plan name"},"billingCycles":{"$ref":"#/components/schemas/billingCycles"},"paymentPreferences":{"$ref":"#/components/schemas/paymentPreferences"},"status":{"type":"string","description":"The initial state of the plan","enum":["ACTIVE","INACTIVE","CREATED"]},"description":{"maxLength":127,"type":"string","description":"The detailed description of the plan."},"taxes":{"$ref":"#/components/schemas/taxes"},"quantitySupported":{"type":"boolean","description":"Indicates whether you can subscribe to this plan by providing a quantity for the goods or service."},"createTime":{"type":"string","description":"The date and time when the billing plan was created.","format":"date"},"updateTime":{"type":"string","description":"The date and time when the billing plan was updated.","format":"date"}}},"billingCycles":{"minItems":1,"type":"array","description":"An array of billing cycles for trial billing and regular billing","items":{"$ref":"#/components/schemas/Model2"}},"Model2":{"required":["frequency","sequence","tenureType"],"type":"object","properties":{"pricingScheme":{"$ref":"#/components/schemas/pricingScheme"},"frequency":{"$ref":"#/components/schemas/frequency"},"tenureType":{"type":"string","description":"The interval at which the subscription is charged or billed.","enum":["REGULAR","TRIAL"]},"sequence":{"type":"number","description":"The order in which this cycle is to run among other billing cycles."},"totalCycles":{"type":"number","description":"The number of times this billing cycle gets executed."}}},"pricingScheme":{"type":"object","properties":{"version":{"maximum":999,"type":"number","description":"The version of the pricing scheme."},"fixedPrice":{"$ref":"#/components/schemas/fixedPrice"},"pricingModel":{"type":"string","description":"The pricing model for tiered plan","enum":["VOLUME","TIERED"]},"tiers":{"$ref":"#/components/schemas/tiers"}},"description":"The active pricing scheme for this billing cycle."},"fixedPrice":{"required":["currencyCode","value"],"type":"object","properties":{"currencyCode":{"maxLength":3,"minLength":3,"type":"string","description":"Currency code (ISO-4217)","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BOV","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHE","CHF","CHW","CLF","CLP","CNY","COP","COU","CRC","CUC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MXV","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLL","SOS","SRD","SSP","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","USN","UYI","UYU","UYW","UZS","VES","VND","VUV","WST","XAF","XAG","XAU","XBA","XBB","XBC","XBD","XCD","XDR","XOF","XPD","XPF","XPT","XSU","XTS","XUA","XXX","YER","ZAR","ZMW","ZWL"]},"value":{"type":"integer","description":"Integer amount value (100 is 1.00)"}},"description":"The fixed amount to charge for the subscription"},"tiers":{"type":"array","description":"An array of pricing tiers which are used for billing volume/tiered plans.","items":{"$ref":"#/components/schemas/Model1"}},"Model1":{"required":["amount","startingQuantity"],"type":"object","properties":{"startingQuantity":{"type":"string","description":"The starting quantity for the tier."},"endingQuantity":{"type":"string","description":"The ending quantity for the tier. Optional for the last tier."},"amount":{"$ref":"#/components/schemas/amount"}}},"amount":{"required":["currencyCode","value"],"type":"object","properties":{"currencyCode":{"maxLength":3,"minLength":3,"type":"string","description":"Currency code (ISO-4217)","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BOV","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHE","CHF","CHW","CLF","CLP","CNY","COP","COU","CRC","CUC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MXV","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLL","SOS","SRD","SSP","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","USN","UYI","UYU","UYW","UZS","VES","VND","VUV","WST","XAF","XAG","XAU","XBA","XBB","XBC","XBD","XCD","XDR","XOF","XPD","XPF","XPT","XSU","XTS","XUA","XXX","YER","ZAR","ZMW","ZWL"]},"value":{"type":"integer","description":"Integer amount value (100 is 1.00)"}}},"frequency":{"required":["intervalUnit"],"type":"object","properties":{"intervalUnit":{"type":"string","description":"The interval at which the subscription is charged or billed.","enum":["DAY","WEEK","MONTH","YEAR"]},"intervalCount":{"type":"number","description":"The number of intervals after which a subscriber is billed."}}},"paymentPreferences":{"type":"object","properties":{"autoBillOutstanding":{"type":"boolean","description":"Indicates whether to automatically bill the outstanding amount in the next billing cycle."},"setupFee":{"$ref":"#/components/schemas/setupFee"},"setupFeeFailureAction":{"type":"string","description":"The action to take on the subscription if the initial payment for the setup fails.","enum":["CONTINUE","CANCEL"]},"paymentFailureThreshold":{"type":"number","description":"The maximum number of payment failures before a subscription is suspended."}},"description":"The payment preferences for a subscription."},"setupFee":{"required":["currencyCode","value"],"type":"object","properties":{"currencyCode":{"maxLength":3,"minLength":3,"type":"string","description":"Currency code (ISO-4217)","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BOV","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHE","CHF","CHW","CLF","CLP","CNY","COP","COU","CRC","CUC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MXV","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLL","SOS","SRD","SSP","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","USN","UYI","UYU","UYW","UZS","VES","VND","VUV","WST","XAF","XAG","XAU","XBA","XBB","XBC","XBD","XCD","XDR","XOF","XPD","XPF","XPT","XSU","XTS","XUA","XXX","YER","ZAR","ZMW","ZWL"]},"value":{"type":"integer","description":"Integer amount value (100 is 1.00)"}},"description":"The initial set-up fee for the service."},"taxes":{"required":["percentage"],"type":"object","properties":{"percentage":{"type":"string","description":"The tax percentage on the billing amount."},"inclusive":{"type":"boolean","description":"Indicates whether the tax was already included in the billing amount."}},"description":"The tax details."},"Model5":{"required":["code","message"],"type":"object","properties":{"code":{"type":"number","description":"A 3-digit code which uniquely identify an error."},"details":{"$ref":"#/components/schemas/details"},"message":{"type":"string","description":"A description of the error."},"timestamp":{"type":"string","description":"Error timestamp","format":"date"}}},"details":{"type":"object"}}},"paths":{"/billingPlans":{"get":{"tags":["Billing Plans"],"summary":"List billing plans","operationId":"getBillingplans","parameters":[{"name":"paymentProviderContract","in":"query","description":"PayPal Payment Provider Contract UUID","required":true,"schema":{"type":"string"}},{"name":"productId","in":"query","description":"Filters the response by a Product ID.","schema":{"maxLength":50,"minLength":6,"type":"string"}},{"name":"ids","in":"query","description":"Filters the response by list of plan IDs.","schema":{"maxLength":270,"minLength":6,"type":"string"}},{"name":"pageSize","in":"query","description":"The number of items to return in the response.","schema":{"maximum":20,"minimum":1,"type":"number"}},{"name":"page","in":"query","description":"A non-zero integer which is the start index of the entire list of items to return in the response.","schema":{"maximum":100000,"minimum":1,"type":"number"}},{"name":"totalRequired","in":"query","description":"Indicates whether to show the total count in the response.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model4"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}}}}}}} ``` ## Create Billing Plan Creates a new billing plan under an existing product. Specify billing cycles, pricing scheme (fixed price or tiered), and payment preferences. {% hint style="warning" %} Use `x-vfi-api-idempotencyKey` to prevent duplicate plan creation on retries. {% endhint %} ## POST /billingPlans/create > Create billing plan ```json {"openapi":"3.0.1","info":{"title":"PayPal eComm API","version":"1.6.0"},"servers":[{"url":"https://emea.gsc.verifone.cloud/oidc/paypal-ecom","description":"EMEA Production"},{"url":"https://us.gsc.verifone.cloud/oidc/paypal-ecom","description":"Americas Production"},{"url":"https://nz.gsc.verifone.cloud/oidc/paypal-ecom","description":"New Zealand"},{"url":"https://cst.test-gsc.vfims.com/oidc/paypal-ecom","description":"Global Sandbox"},{"url":"https://uscst.gb.gsc.cficloud/oidc/paypal-ecom","description":"Americas Sandbox"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"Model36":{"required":["billingCycles","name","paymentProviderContract","productId"],"type":"object","properties":{"paymentProviderContract":{"type":"string","description":"PayPal Payment Provider Contract UUID"},"productId":{"type":"string","description":"PayPal catalog product id"},"name":{"maxLength":127,"type":"string","description":"The plan name"},"status":{"type":"string","description":"The initial state of the plan","enum":["ACTIVE","INACTIVE","CREATED"]},"description":{"maxLength":127,"type":"string","description":"The detailed description of the plan."},"billingCycles":{"$ref":"#/components/schemas/Model35"},"paymentPreferences":{"$ref":"#/components/schemas/paymentPreferences"},"taxes":{"$ref":"#/components/schemas/taxes"},"quantitySupported":{"type":"boolean","description":"Indicates whether you can subscribe to this plan by providing a quantity for the goods or service."}}},"Model35":{"minItems":1,"type":"array","description":"An array of billing cycles for trial billing and regular billing","items":{"$ref":"#/components/schemas/Model34"}},"Model34":{"required":["sequence","tenureType"],"type":"object","properties":{"pricingScheme":{"$ref":"#/components/schemas/pricingScheme"},"frequency":{"$ref":"#/components/schemas/frequency"},"tenureType":{"type":"string","description":"The tenure type of the billing cycle.","enum":["REGULAR","TRIAL"]},"sequence":{"type":"number","description":"The order in which this cycle is to run among other billing cycles."},"totalCycles":{"type":"number","description":"The number of times this billing cycle gets executed."}}},"pricingScheme":{"type":"object","properties":{"version":{"maximum":999,"type":"number","description":"The version of the pricing scheme."},"fixedPrice":{"$ref":"#/components/schemas/fixedPrice"},"pricingModel":{"type":"string","description":"The pricing model for tiered plan","enum":["VOLUME","TIERED"]},"tiers":{"$ref":"#/components/schemas/tiers"}},"description":"The active pricing scheme for this billing cycle."},"fixedPrice":{"required":["currencyCode","value"],"type":"object","properties":{"currencyCode":{"maxLength":3,"minLength":3,"type":"string","description":"Currency code (ISO-4217)","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BOV","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHE","CHF","CHW","CLF","CLP","CNY","COP","COU","CRC","CUC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MXV","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLL","SOS","SRD","SSP","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","USN","UYI","UYU","UYW","UZS","VES","VND","VUV","WST","XAF","XAG","XAU","XBA","XBB","XBC","XBD","XCD","XDR","XOF","XPD","XPF","XPT","XSU","XTS","XUA","XXX","YER","ZAR","ZMW","ZWL"]},"value":{"type":"integer","description":"Integer amount value (100 is 1.00)"}},"description":"The fixed amount to charge for the subscription"},"tiers":{"type":"array","description":"An array of pricing tiers which are used for billing volume/tiered plans.","items":{"$ref":"#/components/schemas/Model1"}},"Model1":{"required":["amount","startingQuantity"],"type":"object","properties":{"startingQuantity":{"type":"string","description":"The starting quantity for the tier."},"endingQuantity":{"type":"string","description":"The ending quantity for the tier. Optional for the last tier."},"amount":{"$ref":"#/components/schemas/amount"}}},"amount":{"required":["currencyCode","value"],"type":"object","properties":{"currencyCode":{"maxLength":3,"minLength":3,"type":"string","description":"Currency code (ISO-4217)","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BOV","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHE","CHF","CHW","CLF","CLP","CNY","COP","COU","CRC","CUC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MXV","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLL","SOS","SRD","SSP","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","USN","UYI","UYU","UYW","UZS","VES","VND","VUV","WST","XAF","XAG","XAU","XBA","XBB","XBC","XBD","XCD","XDR","XOF","XPD","XPF","XPT","XSU","XTS","XUA","XXX","YER","ZAR","ZMW","ZWL"]},"value":{"type":"integer","description":"Integer amount value (100 is 1.00)"}}},"frequency":{"required":["intervalUnit"],"type":"object","properties":{"intervalUnit":{"type":"string","description":"The interval at which the subscription is charged or billed.","enum":["DAY","WEEK","MONTH","YEAR"]},"intervalCount":{"type":"number","description":"The number of intervals after which a subscriber is billed."}}},"paymentPreferences":{"type":"object","properties":{"autoBillOutstanding":{"type":"boolean","description":"Indicates whether to automatically bill the outstanding amount in the next billing cycle."},"setupFee":{"$ref":"#/components/schemas/setupFee"},"setupFeeFailureAction":{"type":"string","description":"The action to take on the subscription if the initial payment for the setup fails.","enum":["CONTINUE","CANCEL"]},"paymentFailureThreshold":{"type":"number","description":"The maximum number of payment failures before a subscription is suspended."}},"description":"The payment preferences for a subscription."},"setupFee":{"required":["currencyCode","value"],"type":"object","properties":{"currencyCode":{"maxLength":3,"minLength":3,"type":"string","description":"Currency code (ISO-4217)","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BOV","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHE","CHF","CHW","CLF","CLP","CNY","COP","COU","CRC","CUC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MXV","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLL","SOS","SRD","SSP","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","USN","UYI","UYU","UYW","UZS","VES","VND","VUV","WST","XAF","XAG","XAU","XBA","XBB","XBC","XBD","XCD","XDR","XOF","XPD","XPF","XPT","XSU","XTS","XUA","XXX","YER","ZAR","ZMW","ZWL"]},"value":{"type":"integer","description":"Integer amount value (100 is 1.00)"}},"description":"The initial set-up fee for the service."},"taxes":{"required":["percentage"],"type":"object","properties":{"percentage":{"type":"string","description":"The tax percentage on the billing amount."},"inclusive":{"type":"boolean","description":"Indicates whether the tax was already included in the billing amount."}},"description":"The tax details."},"Model37":{"required":["billingCycles","createTime","id","name","productId","status"],"type":"object","properties":{"id":{"maxLength":50,"minLength":6,"type":"string","description":"The unique PayPal-generated ID for the plan."},"productId":{"type":"string","description":"PayPal catalog product id"},"name":{"maxLength":127,"type":"string","description":"The plan name"},"status":{"type":"string","description":"The initial state of the plan","enum":["ACTIVE","INACTIVE","CREATED"]},"description":{"maxLength":127,"type":"string","description":"The detailed description of the plan."},"billingCycles":{"$ref":"#/components/schemas/billingCycles"},"paymentPreferences":{"$ref":"#/components/schemas/paymentPreferences"},"taxes":{"$ref":"#/components/schemas/taxes"},"quantitySupported":{"type":"boolean","description":"Indicates whether you can subscribe to this plan by providing a quantity for the goods or service."},"createTime":{"type":"string","description":"The date and time when the billing plan was created.","format":"date"},"updateTime":{"type":"string","description":"The date and time when the billing plan was updated.","format":"date"}}},"billingCycles":{"minItems":1,"type":"array","description":"An array of billing cycles for trial billing and regular billing","items":{"$ref":"#/components/schemas/Model2"}},"Model2":{"required":["frequency","sequence","tenureType"],"type":"object","properties":{"pricingScheme":{"$ref":"#/components/schemas/pricingScheme"},"frequency":{"$ref":"#/components/schemas/frequency"},"tenureType":{"type":"string","description":"The interval at which the subscription is charged or billed.","enum":["REGULAR","TRIAL"]},"sequence":{"type":"number","description":"The order in which this cycle is to run among other billing cycles."},"totalCycles":{"type":"number","description":"The number of times this billing cycle gets executed."}}},"Model5":{"required":["code","message"],"type":"object","properties":{"code":{"type":"number","description":"A 3-digit code which uniquely identify an error."},"details":{"$ref":"#/components/schemas/details"},"message":{"type":"string","description":"A description of the error."},"timestamp":{"type":"string","description":"Error timestamp","format":"date"}}},"details":{"type":"object"}}},"paths":{"/billingPlans/create":{"post":{"tags":["Billing Plans"],"summary":"Create billing plan","operationId":"postBillingplansCreate","parameters":[{"name":"x-vfi-api-idempotencyKey","in":"header","description":"A value you specify that uniquely identifies the transaction. If you're unsure whether a particular transaction succeeded, you can reattempt it with the same idempotency key without worrying about duplicating the transaction.","schema":{"type":"string"}}],"requestBody":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Model36"}}},"required":false},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model37"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}}}}}}} ``` ## Get Billing Plan Retrieves the full details of a billing plan by its ID. ## GET /billingPlans/{planId} > Get billing plan ```json {"openapi":"3.0.1","info":{"title":"PayPal eComm API","version":"1.6.0"},"servers":[{"url":"https://emea.gsc.verifone.cloud/oidc/paypal-ecom","description":"EMEA Production"},{"url":"https://us.gsc.verifone.cloud/oidc/paypal-ecom","description":"Americas Production"},{"url":"https://nz.gsc.verifone.cloud/oidc/paypal-ecom","description":"New Zealand"},{"url":"https://cst.test-gsc.vfims.com/oidc/paypal-ecom","description":"Global Sandbox"},{"url":"https://uscst.gb.gsc.cficloud/oidc/paypal-ecom","description":"Americas Sandbox"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"Model9":{"required":["billingCycles","createTime","name","productId"],"type":"object","properties":{"id":{"maxLength":50,"minLength":6,"type":"string","description":"Filters the response by a Product ID."},"productId":{"type":"string","description":"PayPal catalog product id"},"name":{"maxLength":127,"type":"string","description":"The plan name"},"billingCycles":{"$ref":"#/components/schemas/billingCycles"},"paymentPreferences":{"$ref":"#/components/schemas/paymentPreferences"},"status":{"type":"string","description":"The initial state of the plan","enum":["ACTIVE","INACTIVE","CREATED"]},"description":{"maxLength":127,"type":"string","description":"The detailed description of the plan."},"taxes":{"$ref":"#/components/schemas/taxes"},"quantitySupported":{"type":"boolean","description":"Indicates whether you can subscribe to this plan by providing a quantity for the goods or service."},"createTime":{"type":"string","description":"The date and time when the billing plan was created.","format":"date"},"updateTime":{"type":"string","description":"The date and time when the billing plan was updated.","format":"date"}}},"billingCycles":{"minItems":1,"type":"array","description":"An array of billing cycles for trial billing and regular billing","items":{"$ref":"#/components/schemas/Model2"}},"Model2":{"required":["frequency","sequence","tenureType"],"type":"object","properties":{"pricingScheme":{"$ref":"#/components/schemas/pricingScheme"},"frequency":{"$ref":"#/components/schemas/frequency"},"tenureType":{"type":"string","description":"The interval at which the subscription is charged or billed.","enum":["REGULAR","TRIAL"]},"sequence":{"type":"number","description":"The order in which this cycle is to run among other billing cycles."},"totalCycles":{"type":"number","description":"The number of times this billing cycle gets executed."}}},"pricingScheme":{"type":"object","properties":{"version":{"maximum":999,"type":"number","description":"The version of the pricing scheme."},"fixedPrice":{"$ref":"#/components/schemas/fixedPrice"},"pricingModel":{"type":"string","description":"The pricing model for tiered plan","enum":["VOLUME","TIERED"]},"tiers":{"$ref":"#/components/schemas/tiers"}},"description":"The active pricing scheme for this billing cycle."},"fixedPrice":{"required":["currencyCode","value"],"type":"object","properties":{"currencyCode":{"maxLength":3,"minLength":3,"type":"string","description":"Currency code (ISO-4217)","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BOV","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHE","CHF","CHW","CLF","CLP","CNY","COP","COU","CRC","CUC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MXV","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLL","SOS","SRD","SSP","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","USN","UYI","UYU","UYW","UZS","VES","VND","VUV","WST","XAF","XAG","XAU","XBA","XBB","XBC","XBD","XCD","XDR","XOF","XPD","XPF","XPT","XSU","XTS","XUA","XXX","YER","ZAR","ZMW","ZWL"]},"value":{"type":"integer","description":"Integer amount value (100 is 1.00)"}},"description":"The fixed amount to charge for the subscription"},"tiers":{"type":"array","description":"An array of pricing tiers which are used for billing volume/tiered plans.","items":{"$ref":"#/components/schemas/Model1"}},"Model1":{"required":["amount","startingQuantity"],"type":"object","properties":{"startingQuantity":{"type":"string","description":"The starting quantity for the tier."},"endingQuantity":{"type":"string","description":"The ending quantity for the tier. Optional for the last tier."},"amount":{"$ref":"#/components/schemas/amount"}}},"amount":{"required":["currencyCode","value"],"type":"object","properties":{"currencyCode":{"maxLength":3,"minLength":3,"type":"string","description":"Currency code (ISO-4217)","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BOV","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHE","CHF","CHW","CLF","CLP","CNY","COP","COU","CRC","CUC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MXV","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLL","SOS","SRD","SSP","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","USN","UYI","UYU","UYW","UZS","VES","VND","VUV","WST","XAF","XAG","XAU","XBA","XBB","XBC","XBD","XCD","XDR","XOF","XPD","XPF","XPT","XSU","XTS","XUA","XXX","YER","ZAR","ZMW","ZWL"]},"value":{"type":"integer","description":"Integer amount value (100 is 1.00)"}}},"frequency":{"required":["intervalUnit"],"type":"object","properties":{"intervalUnit":{"type":"string","description":"The interval at which the subscription is charged or billed.","enum":["DAY","WEEK","MONTH","YEAR"]},"intervalCount":{"type":"number","description":"The number of intervals after which a subscriber is billed."}}},"paymentPreferences":{"type":"object","properties":{"autoBillOutstanding":{"type":"boolean","description":"Indicates whether to automatically bill the outstanding amount in the next billing cycle."},"setupFee":{"$ref":"#/components/schemas/setupFee"},"setupFeeFailureAction":{"type":"string","description":"The action to take on the subscription if the initial payment for the setup fails.","enum":["CONTINUE","CANCEL"]},"paymentFailureThreshold":{"type":"number","description":"The maximum number of payment failures before a subscription is suspended."}},"description":"The payment preferences for a subscription."},"setupFee":{"required":["currencyCode","value"],"type":"object","properties":{"currencyCode":{"maxLength":3,"minLength":3,"type":"string","description":"Currency code (ISO-4217)","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BOV","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHE","CHF","CHW","CLF","CLP","CNY","COP","COU","CRC","CUC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MXV","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLL","SOS","SRD","SSP","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","USN","UYI","UYU","UYW","UZS","VES","VND","VUV","WST","XAF","XAG","XAU","XBA","XBB","XBC","XBD","XCD","XDR","XOF","XPD","XPF","XPT","XSU","XTS","XUA","XXX","YER","ZAR","ZMW","ZWL"]},"value":{"type":"integer","description":"Integer amount value (100 is 1.00)"}},"description":"The initial set-up fee for the service."},"taxes":{"required":["percentage"],"type":"object","properties":{"percentage":{"type":"string","description":"The tax percentage on the billing amount."},"inclusive":{"type":"boolean","description":"Indicates whether the tax was already included in the billing amount."}},"description":"The tax details."},"Model5":{"required":["code","message"],"type":"object","properties":{"code":{"type":"number","description":"A 3-digit code which uniquely identify an error."},"details":{"$ref":"#/components/schemas/details"},"message":{"type":"string","description":"A description of the error."},"timestamp":{"type":"string","description":"Error timestamp","format":"date"}}},"details":{"type":"object"}}},"paths":{"/billingPlans/{planId}":{"get":{"tags":["Billing Plans"],"summary":"Get billing plan","operationId":"getBillingplansPlanid","parameters":[{"name":"planId","in":"path","description":"PayPal billing plan Id","required":true,"schema":{"type":"string"}},{"name":"paymentProviderContract","in":"query","description":"PayPal Payment Provider Contract UUID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model9"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}}}}}}} ``` ## Update Billing Plan Updates fields on an existing billing plan, including pricing scheme, billing cycles, taxes, and payment preferences. Returns `204 No Content` on success. ## PUT /billingPlans/{planId} > Update billing plans ```json {"openapi":"3.0.1","info":{"title":"PayPal eComm API","version":"1.6.0"},"servers":[{"url":"https://emea.gsc.verifone.cloud/oidc/paypal-ecom","description":"EMEA Production"},{"url":"https://us.gsc.verifone.cloud/oidc/paypal-ecom","description":"Americas Production"},{"url":"https://nz.gsc.verifone.cloud/oidc/paypal-ecom","description":"New Zealand"},{"url":"https://cst.test-gsc.vfims.com/oidc/paypal-ecom","description":"Global Sandbox"},{"url":"https://uscst.gb.gsc.cficloud/oidc/paypal-ecom","description":"Americas Sandbox"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"Model61":{"required":["paymentProviderContract"],"type":"object","properties":{"paymentProviderContract":{"type":"string","description":"PayPal Payment Provider Contract UUID"},"description":{"maxLength":127,"type":"string","description":"The detailed description of the plan."},"paymentPreferences":{"$ref":"#/components/schemas/paymentPreferences"},"taxes":{"$ref":"#/components/schemas/Model60"}}},"paymentPreferences":{"type":"object","properties":{"autoBillOutstanding":{"type":"boolean","description":"Indicates whether to automatically bill the outstanding amount in the next billing cycle."},"setupFee":{"$ref":"#/components/schemas/setupFee"},"setupFeeFailureAction":{"type":"string","description":"The action to take on the subscription if the initial payment for the setup fails.","enum":["CONTINUE","CANCEL"]},"paymentFailureThreshold":{"type":"number","description":"The maximum number of payment failures before a subscription is suspended."}},"description":"The payment preferences for a subscription."},"setupFee":{"required":["currencyCode","value"],"type":"object","properties":{"currencyCode":{"maxLength":3,"minLength":3,"type":"string","description":"Currency code (ISO-4217)","enum":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BOV","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHE","CHF","CHW","CLF","CLP","CNY","COP","COU","CRC","CUC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MXV","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLL","SOS","SRD","SSP","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","USN","UYI","UYU","UYW","UZS","VES","VND","VUV","WST","XAF","XAG","XAU","XBA","XBB","XBC","XBD","XCD","XDR","XOF","XPD","XPF","XPT","XSU","XTS","XUA","XXX","YER","ZAR","ZMW","ZWL"]},"value":{"type":"integer","description":"Integer amount value (100 is 1.00)"}},"description":"The initial set-up fee for the service."},"Model60":{"required":["percentage"],"type":"object","properties":{"percentage":{"type":"string","description":"The tax percentage on the billing amount."}}},"Model5":{"required":["code","message"],"type":"object","properties":{"code":{"type":"number","description":"A 3-digit code which uniquely identify an error."},"details":{"$ref":"#/components/schemas/details"},"message":{"type":"string","description":"A description of the error."},"timestamp":{"type":"string","description":"Error timestamp","format":"date"}}},"details":{"type":"object"}}},"paths":{"/billingPlans/{planId}":{"put":{"tags":["Billing Plans"],"summary":"Update billing plans","operationId":"putBillingplansPlanid","parameters":[{"name":"planId","in":"path","description":"PayPal billing plan Id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Model61"}}},"required":false},"responses":{"204":{"description":"No Content","content":{}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}}}}}}} ``` ## Activate Billing Plan Activates a billing plan, making it available for new subscriptions. ## PUT /billingPlans/{planId}/activate > Activate billing plans ```json {"openapi":"3.0.1","info":{"title":"PayPal eComm API","version":"1.6.0"},"servers":[{"url":"https://emea.gsc.verifone.cloud/oidc/paypal-ecom","description":"EMEA Production"},{"url":"https://us.gsc.verifone.cloud/oidc/paypal-ecom","description":"Americas Production"},{"url":"https://nz.gsc.verifone.cloud/oidc/paypal-ecom","description":"New Zealand"},{"url":"https://cst.test-gsc.vfims.com/oidc/paypal-ecom","description":"Global Sandbox"},{"url":"https://uscst.gb.gsc.cficloud/oidc/paypal-ecom","description":"Americas Sandbox"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"Model38":{"required":["paymentProviderContract"],"type":"object","properties":{"paymentProviderContract":{"type":"string","description":"PayPal Payment Provider Contract UUID"}}},"Model5":{"required":["code","message"],"type":"object","properties":{"code":{"type":"number","description":"A 3-digit code which uniquely identify an error."},"details":{"$ref":"#/components/schemas/details"},"message":{"type":"string","description":"A description of the error."},"timestamp":{"type":"string","description":"Error timestamp","format":"date"}}},"details":{"type":"object"}}},"paths":{"/billingPlans/{planId}/activate":{"put":{"tags":["Billing Plans"],"summary":"Activate billing plans","operationId":"putBillingplansPlanidActivate","parameters":[{"name":"planId","in":"path","description":"PayPal billing plan Id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Model38"}}},"required":false},"responses":{"204":{"description":"No Content","content":{}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}}}}}}} ``` ## Deactivate Billing Plan Deactivates a billing plan. Deactivated plans cannot be used for new subscriptions, but existing active subscriptions are not affected. {% hint style="info" %} Deactivation is reversible — you can reactivate a deactivated plan using `PUT /billingPlans/{planId}/activate`. {% endhint %} ## PUT /billingPlans/{planId}/deactivate > Deactivate billing plans ```json {"openapi":"3.0.1","info":{"title":"PayPal eComm API","version":"1.6.0"},"servers":[{"url":"https://emea.gsc.verifone.cloud/oidc/paypal-ecom","description":"EMEA Production"},{"url":"https://us.gsc.verifone.cloud/oidc/paypal-ecom","description":"Americas Production"},{"url":"https://nz.gsc.verifone.cloud/oidc/paypal-ecom","description":"New Zealand"},{"url":"https://cst.test-gsc.vfims.com/oidc/paypal-ecom","description":"Global Sandbox"},{"url":"https://uscst.gb.gsc.cficloud/oidc/paypal-ecom","description":"Americas Sandbox"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"Model38":{"required":["paymentProviderContract"],"type":"object","properties":{"paymentProviderContract":{"type":"string","description":"PayPal Payment Provider Contract UUID"}}},"Model5":{"required":["code","message"],"type":"object","properties":{"code":{"type":"number","description":"A 3-digit code which uniquely identify an error."},"details":{"$ref":"#/components/schemas/details"},"message":{"type":"string","description":"A description of the error."},"timestamp":{"type":"string","description":"Error timestamp","format":"date"}}},"details":{"type":"object"}}},"paths":{"/billingPlans/{planId}/deactivate":{"put":{"tags":["Billing Plans"],"summary":"Deactivate billing plans","operationId":"putBillingplansPlanidDeactivate","parameters":[{"name":"planId","in":"path","description":"PayPal billing plan Id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/Model38"}}},"required":false},"responses":{"204":{"description":"No Content","content":{}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Model5"}}}}}}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verifone.com/api-reference/open-api-references/paypal-ecommerce/billing-plans.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.