Accept card, direct debit, and digital wallet payments through Stripe using PaymentKit. PaymentKit acts as the payment orchestrator and provides the required PCI compliance documentation used to enable Stripe’s raw card APIs.

Set up summary

To accept payments with Stripe in PaymentKit, you will need to:

1. Request access to Stripe raw card APIs
2. Enable raw card number processing in Stripe Dashboard
3. Create Stripe API keys
4. Connect Stripe to PaymentKit
5. (Optional) Enable Apple Pay and Google Pay

Request access to Stripe raw card APIs

PaymentKit uses Stripe’s raw card APIs, which must be enabled by Stripe.

Share the following documents with Stripe when submitting your request:

• ASV Site Certification Attestation
• Compliance Certificate
• Self-Assessment Questionnaire (SAQ D-SP)

Submit a request through Stripe Support using the following message:

I am requesting access to Stripe’s raw card data APIs for my account. PaymentKit serves as our PCI-compliant payment orchestrator and provides the required Self-Assessment Questionnaire (SAQ D) and On-Site Attestation of Compliance, which can be accessed at the following links:

• ASV Site Certification Attestation: https://storage.googleapis.com/trust.paymentkit.com/2026_Q1_asv_sitecert_attestation.pdf
• Compliance Certificate: https://storage.googleapis.com/trust.paymentkit.com/2026_Q1_compliance_certificate.pdf
• Self-Assessment Questionnaire (SAQ D-SP): https://storage.googleapis.com/trust.paymentkit.com/SAQ_D-SP_18%20Feb%202026.pdf

Stripe should get back to you within a few days.

Enable raw card number processing in Stripe Dashboard

Once Stripe has approved your raw card API access, you must enable the setting in your Stripe Dashboard to avoid warnings when PaymentKit processes payments.

1. In your Stripe Dashboard, navigate to Settings > Integration
2. Under the Advanced section, enable Allow processing of raw card numbers

For more details, see Stripe’s documentation on enabling access to raw card data APIs and Stripe’s integration security guide.

Create Stripe API keys

PaymentKit requires Stripe API keys to securely connect to your Stripe account.

1. In your Stripe account, navigate to the API keys page
2. Create a restricted API key
   • How will you use this API key: Providing this key to another website
   • 3rd party name: PaymentKit
   • 3rd party URL:http://app.paymentkit.com/
3. Copy the following values:
   • Publishable key
   • Restricted secret key

Connect Stripe to PaymentKit

1. Navigate to Orchestration → Payment processors
2. Click Add Processor and select Stripe
3. Enter your publishable key and restricted key
4. Turn on the payment methods you want to accept payments in (for Apple Pay and Google Pay, you will need to complete the additional steps below)

Enable Apple Pay and Google Pay

Register Your Domain

A custom domain is required before digital wallets can be enabled.

1. Register your domain in Stripe here
2. Verify the domain

Add Apple Pay and Google Pay as accepted payment methods

After your domain is registered:

1. Navigate to Orchestration → Payment processors

2. Edit your Stripe processor settings

   

3. Add Apple Pay and Google Pay as accepted payment methods

Notes on how wallet availability works

Availability Summary

Apple Pay

• Safari on macOS, iOS, and iPadOS

Google Pay

• Android devices
• Supported Chrome desktop browsers

For full requirements, see Stripe’s documentation here.

You can also compare expected behavior using Stripe’s demo pages here and here.

Stripe Link

Stripe Link is Stripe’s one-click wallet: returning shoppers who have a Link account can pay with a saved card without re-entering their card details. In PaymentKit, Link is offered as a checkout wallet on Stripe processors, alongside Apple Pay and Google Pay.

Enable Stripe Link

1. Navigate to Orchestration → Payment processors
2. Edit your Stripe processor
3. In the wallet section, turn on Stripe Link

Unlike Apple Pay and Google Pay, Stripe Link does not require registering a custom domain — enabling the payment method is all that’s needed.

How Stripe Link appears at checkout

PaymentKit renders Link in one of two ways, chosen automatically per shopper:

• Express button — shown when the shopper already has an authenticated Link session, letting them pay in one click near the top of the checkout.
• Link tile — shown otherwise, as a selectable method in the checkout’s payment-method list. Selecting it mounts the same Link element so the shopper can authenticate.

Payment mode vs setup mode

A checkout session runs in one of two modes, and Link supports both:

• Payment — charges the shopper now. The Link payment method is attached to the customer and a payment is created and confirmed.
• Setup — saves the Link payment method for later use without charging (for example, to collect a reusable method before a trial or for future invoices).

Custom checkout integration

If you’re building a fully custom Link flow instead of using <ElementsForm />, PaymentKit.js exposes Link through a callback-driven API — initStripeLink() mounts the element and onLinkResult() delivers the outcome. Unlike Apple Pay and Google Pay, Link is not confirmed via paymentKit.submit(): Stripe renders the button and fires its own confirm event.

---