- PayPal Express Checkout is the PayPal button, offered next to the card form whichever card provider is active. See PayPal Express Checkout.
- PayPal Card Processing processes the cards shoppers type into your checkout, as your main card processor or as the backup. It uses its own PayPal app. See PayPal Card Processing.
What each provider supports
How each one renews a subscription, and what happens when a renewal fails, is on
Subscription renewals by payment method.
PlatformDTC Payments
The default. PlatformDTC Payments runs on Stripe, so no separate Stripe account is needed. It costs 2.9% + 30¢ per sale with no plan fee (see Payment fees and rates). Customers pay by card, Apple Pay or Google Pay, and the money goes to your bank.Set up PlatformDTC Payments
1
Start
Open Settings → Payments
(the setup guide’s Set up payments button opens the same screen). PlatformDTC Payments is
listed first. Above the button is what to have ready (about 3 minutes): your date of birth and
home address, the last 4 digits of your SSN in the US or your national ID
number in countries that ask for it, and your ID nearby in case a photo is needed.
Check the country line, for example Start with Italy · change, and select Start taking
payments. If your store has no country yet, we start with where you are right now (or your
browser’s region); select change if that’s wrong. Pick the country your business is registered
in: it can’t be changed later. Only countries where cards can be taken are listed. Not there? Select
Prefer PayPal? Connect your PayPal business account instead.
2
Fill in Stripe's secure form
The form opens on the same screen. What we already know about you, such as your name and email
and the kind of store you run, is filled in, and you can change it there. It usually takes about
3 minutes. Anything still missing is named in plain words, like “your home address” or “a photo ID”.
It doesn’t ask for your bank yet.
3
Take payments
As soon as Stripe lets your account take cards, your checkout uses it, with Apple Pay and Google
Pay switched on for your checkout address. The screen says You’re taking payments.
4
Add your bank so we can pay you
Once you’re taking payments, the same screen shows Add your bank so we can pay you. Select
Add your bank and Stripe’s secure form asks for your bank account details and nothing else.
Until then, your money is kept safe in your PlatformDTC Payments account; the screen shows how much
is waiting. Once your bank is added, it’s paid out to you automatically.
- Two lines tell you where you stand. The screen shows Take card payments and Get paid to your bank, each with On, Needs your details, Add your bank, Being checked, Paused or Off.
- What the form asks before your first sale. Your name, date of birth, home address, phone and the last 4 digits of your SSN (in the US). Card payments switch on only once these are in, usually within seconds. A photo ID is asked for only if your details can’t be checked automatically.
- Your bank comes later. Stripe only needs your bank account to pay you, so it’s asked for after card payments are on, not before. You can add it any time from Settings → Payments.
- US business with an EIN? In the form, pick Sole proprietorship or Company as your business type and enter your EIN as the business tax ID. Stripe may still ask for the last 4 digits of your SSN to confirm who runs the business. Pick Individual only if you sell under your own name with no EIN.
- You can sell before payouts are verified. Your store takes cards as soon as Stripe allows charges. Stripe holds payouts until it has verified your details.
- If your account is turned down, both lines say Off and the screen says so plainly. Sending more details won’t change it. Contact the PlatformDTC team, or connect another way to get paid below.
- Until payments are on, buyers are told. Your checkout shows This store isn’t taking payments yet at the top instead of a form that can’t be paid.
- Checkout switches on by itself. If you never chose a card provider, checkout uses PlatformDTC Payments once your account can take cards. A provider you activated yourself is never replaced.
- Left the form half-way? Come back to Settings → Payments and the screen says how far you are, for example You’re 3 steps away from taking payments, lists exactly what’s missing, and opens the form at your next step. Nothing you entered is lost. If Stripe couldn’t check something you typed (say your name and date of birth don’t match your ID, or the address isn’t a real street address), the list says what to fix instead of asking for it again.
- Reminder emails. After a day we email you how many details Stripe still needs, with a Continue link back to where you stopped. You get at most 3 reminders, 3 days apart, and none if your store heartbeat is set to No emails. The same reminder shows in your dashboard’s notifications.
- “Add your bank” emails. If you’ve made a sale at least 2 days ago, money is waiting and you still haven’t added your bank, we email you an Add your bank link. At most 3, 3 days apart, and none if your store heartbeat is set to No emails. Your dashboard’s notifications show it too.
- Currency. If your store never chose a currency and has no orders yet, it takes your payments account’s currency.
Your own Stripe account
Use this if you already have a Stripe account and want charges and payouts to land there.1
Open Stripe
Go to Settings → Payments → Third-party payment providers → Stripe Card Payments.
2
Connect
Either sign in at Stripe in the popup (PlatformDTC never sees your Stripe password), or paste
your publishable key (
pk_…) and secret key (sk_… or a restricted rk_… key).3
Activate
Click Activate Stripe Card Payments. It becomes the active card provider and the list shows
it as Active.
Authorize.Net
Authorize.Net is a gateway: charges run against your own Authorize.Net merchant account.1
Find your keys
In the Authorize.Net Merchant Interface, go to
Account → Security Settings and copy your API Login ID and Transaction Key.
2
Connect
Go to Settings → Payments → Third-party payment providers → Authorize.net and paste both.
PlatformDTC checks them with Authorize.Net before saving; wrong keys are rejected straight away.
The Transaction Key is stored encrypted and never sent to the browser.
3
Activate
Click Activate Authorize.Net.
Subscriptions on Authorize.Net
When a customer checks out a subscription, Authorize.Net saves their card in a customer profile on your Authorize.Net account, and renewals charge that profile as a recurring card-on-file payment. If the customer later updates their card in the customer portal, the subscription moves to Stripe — see When a customer updates their card.Authorize.Net refunds
- Settled payments are refunded, in full or in part.
- Payments not yet settled (usually the same day) can only be refunded in full — the payment is voided instead of refunded. A partial refund is refused until the payment settles.
PayPal Express Checkout
The PayPal button at your checkout. Connect it from Settings → Payments: select Activate next to PayPal Express Checkout (or Prefer PayPal? under the PlatformDTC Payments button), select Open PayPal, sign in to your PayPal business account, create an app (or open one) and copy its Client ID and Secret back. We check them with PayPal before saving. Then activate it. PayPal appears at checkout next to the card form. For subscriptions, PayPal saves the customer’s PayPal account so renewals can charge it — see PayPal renewals. To send tracking numbers to PayPal automatically, see Send tracking to PayPal. If PayPal Card Processing is connected with a different PayPal account, the PayPal button can also take part of your new PayPal sales on that second account. See Use two PayPal accounts for the PayPal button.PayPal Card Processing
PayPal processes the cards shoppers type into your checkout, like Stripe does. Shoppers stay on your checkout — they don’t leave for PayPal — and cards are saved with PayPal, so subscriptions renew on them. It’s a separate connection from PayPal Express Checkout, with its own PayPal app, and connecting it doesn’t change your PayPal button.1
Create a PayPal app for card payments
Open PayPal Developer → Apps & Credentials → Live
and sign in with your PayPal business account. Select Create App. Under the app’s features,
tick Advanced Credit and Debit Card Payments and Save payment methods. Copy the app’s
Client ID and Secret.
2
Connect it
Go to Settings → Payments → Third-party payment providers → PayPal Card Processing, paste the
Client ID and Secret, and select Connect. We check them with PayPal before saving. If
PayPal says no, the screen tells you why in plain words.
3
Check that PayPal approved card payments
The page shows Card payments: approved or not approved yet. PayPal may need to approve card
payments for your business account first: select Turn it on in PayPal, finish PayPal’s steps,
then select Check again.
4
Choose what it's for
Under Use for, pick one:
- Main card processor — every card payment goes through PayPal, instead of the card provider you had, for new checkouts.
- Backup when a card is declined or card payments are down — keep your card provider. If card payments stop working or a card is declined, we try again with PayPal.
- Off — PayPal doesn’t process card payments.
- One backup at a time. Making PayPal the backup replaces an NMI or Authorize.Net backup. It works as the backup for PlatformDTC Payments, your own Stripe account, Authorize.Net, NMI and the other card providers.
- You can also turn the backup on from your card provider’s page, under If card payments stop working or a card is declined, try again with PayPal. If PayPal Card Processing isn’t connected yet, it links you to the page to connect it.
- Disconnect stops PayPal processing card payments. Your PayPal button (PayPal Express Checkout) isn’t affected.
- The provider list shows each PayPal connection as Connected, Not connected or Not approved for cards yet.
- Failed card renewals can move here. While it’s connected and on, a subscriber whose card renewal failed can save their card with PayPal from the update-payment-method page, and later renewals charge it through PayPal. See Card renewals that failed.
Smart retry
When PlatformDTC Payments or your own Stripe account declines a card at checkout, smart retry offers the shopper your backup card processor (today, PayPal Card Processing set to Backup when a card is declined or card payments are down). The shopper enters their card once more in the same checkout and pays there. Nothing to set up beyond choosing a backup. It only retries declines another processor may approve:- Never a fraud block. A payment stopped by your fraud rules or by your card provider’s fraud check isn’t retried.
- Never a card the bank says not to retry, such as a lost or stolen card, a closed account, or a card the bank told us to stop charging.
- Visa “suspected fraud” declines are retried only with 3D Secure, so the shopper confirms with their bank first.
- One retry per checkout.
- 1 in 10 eligible declines is not retried on purpose. Those checkouts are the comparison group that shows how much smart retry adds compared with not retrying.
- Settings → Payments shows Recovered by smart retry: the money from payments your card provider declined and your backup processor then took, in the last 30 days — at checkout, and on subscription renewals whose customer saved their card with PayPal after a failed renewal. The card only appears once smart retry has saved a payment.
- An order it saved shows a Saved by smart retry tag next to its payment status. Hover it to see which provider declined the card and which one took the payment.