Configure Stripe Payments

In this article

Stripe lets customers pay online through the YoPrint customer portal. Connect your Stripe account to accept credit card payments on quotes and invoices.

Create Stripe keys

In your Stripe dashboard, locate or create your Publishable Key and Secret Key. Follow Stripe's guide on how to Locate API keys in the Dashboard for the provider-side steps. Keep your Secret Key secure and never share it publicly.

Stripe dashboard

These steps happen in Stripe. Stripe's screens may have changed since we took these pictures. If something looks different, follow Stripe's guide: Locate API keys in the Dashboard.

Test mode API keys

To test payments before accepting real cards, turn on Test mode in your Stripe dashboard. Copy your test API keys (starting with pk_test_  and sk_test_ ) into YoPrint. When you are ready to accept real payments, switch to live mode in Stripe, copy your live API keys (starting with pk_live_  and sk_live_ ), and update your connection in YoPrint.

  1. Log in to your Stripe Dashboard.

  2. Navigate to Settings > Developers.

  3. Under Developers, go to API keys.

    Stripe Developers page showing API keys

  4. Select + Create secret key. Your Publishable Key is also on this page.

    Stripe API keys page showing Publishable key and Create secret key

  5. Enter a key name.

    Name your secret key prompt

  6. Select Verify by email + more verification and follow the verification prompts.

    Verify your identity prompt

  7. Select Building your own integration, then select Create secret key.

    Choose integration type dialog and Create secret key button

  8. Copy your new secret key and select Done.

    Copy secret key dialog showing Done button

Connect Stripe in YoPrint

  1. On the Connected Apps page (Configuration > Settings > Apps), scroll to the Stripe card and select Connect.

    Stripe is already connected

    If your shop already connected Stripe, the card displays a disabled Connected button and a three-dot menu (Open integration actions). To view or update your keys, select Open integration actions > Edit. To disconnect Stripe, select Open integration actions > Remove.

    Stripe card in Connected Apps

  2. In the Connect your Stripe Account dialog, enter your Publishable Key and Secret Key, then select Save.

    Stripe connection form

  3. Confirm that the Stripe card displays Connected. The button is disabled because the integration is active.

    Stripe connected state

After you connect Stripe

Once Stripe is connected, customers can select Credit Card to pay outstanding quotes and invoices in the customer portal. Follow Customer Portal Overview for customer payment instructions.

YoPrint automatically configures a webhook with Stripe during connection. When a customer pays through the portal, Stripe confirms the transaction, and YoPrint records the payment against the order and updates the balance. YoPrint records the full payment amount on the invoice. Stripe deducts payment processing fees and manages payouts in your Stripe account.

To issue a refund from YoPrint, follow All About Refunds in YoPrint. If you issue a refund in Stripe's dashboard instead, Stripe notifies YoPrint through the webhook and records the refund against the order.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.