Payments

PayPal and payment processing for your IPTV store

How payments work in your store, how to connect your own PayPal account with its Client ID and Secret, and how to confirm a payment that didn't come through.

6 min read
Published November 2, 2026
Last checked November 18, 2026
payments
paypal
payment-gateways
checkout

Every payment in your store goes to your own payment gateway account. The store never holds your money: it sends the customer to your gateway, waits for the gateway to confirm the payment, and then delivers the order. This guide explains how that works, how to connect a PayPal account, and what to do when a payment doesn't come through.

Your gateway, your choice: Which provider you use is up to you. You open the account yourself and it runs under that provider's terms, so read them before you start. We don't recommend one provider over another.

How payment processing works in your store

  1. The customer picks a plan and goes to checkout. They see every gateway you have switched on.
  2. They pay on your provider's own page (for PayPal, they sign in to PayPal or pay by card there).
  3. Your store gets the confirmation from your provider, using your keys, and marks the order paid. For PayPal, the store asks PayPal itself about the order before it counts as paid.
  4. The order is delivered: the line is created on your panel and the customer gets their login by email. See What happens after a customer pays.

Your keys are stored encrypted.

1Step 1 of 6Get your PayPal API credentials

Your store connects to PayPal with a Client ID and a Client Secret from a REST API app in your own PayPal business account. In PayPal, open the Developer Dashboard, go to My Apps & Credentials, and create an app (or open the one you have). Copy the live Client ID and Secret, not the sandbox ones: the store uses PayPal's live API. Copy each value without spaces or line breaks.

2Step 2 of 6Add PayPal to your store

Go to Payment gateways → All gateways. Under Supported Gateways, click PayPal, or click Add Gateway and choose PayPal under Gateway. The Add Payment Gateway page opens.

  • Client ID: paste the Client ID.
  • Client Secret: paste the Secret.

Click Add Gateway. Your keys are checked with PayPal before they are saved. If they are refused, nothing is saved and the message says why, for example that you pasted sandbox keys.

You don't need to set up a webhook for PayPal: the payment is captured and confirmed when the customer approves it and comes back to your store.

3Step 3 of 6Check that it shows Active

PayPal now appears under Configured Gateways. Active means it is offered at checkout. Misconfigured means PayPal rejected the keys later on, for example after you changed them in PayPal: click Configure, paste them again and save. A misconfigured gateway is left out of checkout until it is fixed.

To take PayPal off checkout for a while, click Configure and switch Gateway Status off.

Optional: to let customers pay by card on a payment page of your store, click Configure, switch on Expanded checkout (card fields on your store's payment page) and click Save Changes. Customers then see the PayPal buttons plus card fields there. The card fields only show once PayPal has approved card payments (Advanced Credit and Debit Card Payments) for your business account; until then only the PayPal buttons show. The switch is off by default.

4Step 4 of 6Choose your selling currency

Your store's currency is set under Payment gateways → Currency. Sell in a currency your PayPal account accepts. If PayPal receives a currency your account doesn't hold yet, it can keep the payment pending until you accept it in your PayPal account, and the order waits until then.

5Step 5 of 6Add a backup gateway (optional)

With two gateways connected, use Failover Settings on the Payment gateways page to pick a primary and a backup gateway for each shop. Both are your own accounts.

6Step 6 of 6Find and confirm a payment that didn't come through

Sometimes a customer approves the payment but closes the browser before returning to your store. Your store checks pending PayPal orders again by itself and completes the ones PayPal approved, so most of these settle without you.

If one still isn't paid, go to Invoices → Payment logs. The Payment Logs page lists every attempt; Pending means the store never got a confirmation. First check the payment in your PayPal account. If the money really arrived:

  1. Go to Customers → All customers, open the customer, open the Orders tab and click the order.
  2. On Order Details, the order shows Awaiting Payment. Click Confirm payment.
  3. Under Payment reference (optional), paste the PayPal transaction ID so the payment can be traced later.
  4. Click Mark paid & provision. The order is delivered as if PayPal had confirmed it.

Only do this for a payment you can see in your PayPal account. Service is delivered against real, received payments only. More cases are in Fix payment and checkout problems.

Other ways customers can pay

PayPal is one option. Your store also supports card processors, crypto gateways and bank transfers you confirm by hand; all of them are listed under Supported Gateways. Each works the same way: your account, your keys, and an automatic confirmation before delivery. For a crypto overview, see Accept crypto for IPTV.

Frequently asked questions

Does the money go through IPTVbp?

No. Customers pay into your own gateway account. Your store only stores your keys (encrypted) and checks with the provider that the payment went through, so the order can be delivered.

Do I need a PayPal webhook?

No. The add-gateway form for PayPal asks only for the Client ID and Client Secret. The payment is captured and confirmed when the customer returns to your store after approving it, and pending PayPal orders are checked again later by themselves. A payment that was never confirmed stays Pending under Invoices → Payment logs, where you can find it.

Can I test PayPal with sandbox keys?

No. The PayPal gateway uses PayPal's live API. If you paste sandbox keys, the gateway is not saved and the message tells you they are sandbox credentials. To test, place a small real order on your own store and refund it in PayPal.

Is PayPal allowed for selling IPTV subscriptions?

That depends on PayPal's terms and on what you sell. Your account runs under PayPal's rules, so check them yourself. PayPal receives the product name with each payment.

Can customers renew with PayPal?

Yes. Renewal reminders carry a pay link to your checkout, and PayPal is offered there as long as it is Active. When the renewal is paid, the same line is extended on your panel.

Ready to try it yourself?

Spin up your own IPTVbp store and connect a panel. It's free until you have 25 paying customers, no card needed.

Start free trial