Skip to main content

Stripe Connector

Prerequisites​

  • A Stripe account (any plan, including free/test)
  • Admin or Developer access to the Stripe Dashboard

Step 1: Create an API Key​

We recommend using a restricted key with read-only access for security.

  1. Go to Stripe Dashboard > Developers > API keys
  2. Click Create restricted key
  3. Name it (e.g., Landed sync)
  4. Grant Read access to all resources you want to sync:
    • Charges, Customers, Subscriptions, Invoices, Products, Prices, etc.
  5. Click Create key
  6. Copy the key (starts with rk_live_ or rk_test_)

Option B: Secret Key​

  1. Go to Stripe Dashboard > Developers > API keys
  2. Click Reveal live key (or Reveal test key for test mode)
  3. Copy the key (starts with sk_live_ or sk_test_)

Warning: The secret key has full access to your Stripe account. Use a restricted key in production.

Step 2: Choose Live vs Test Mode​

  • Live mode keys (sk_live_*, rk_live_*): sync real production data
  • Test mode keys (sk_test_*, rk_test_*): sync test/sandbox data only

Toggle between modes using the switch in the top-right of the Stripe Dashboard before copying keys.

Step 3: Configure in Landed​

FieldValue
Secret KeyYour Stripe API key (e.g., rk_live_... or sk_live_...)

Available Streams​

StreamDescriptionSync Mode
chargesPayment charges with amount, currency, statusIncremental
customersCustomer records with email, name, metadataIncremental
subscriptionsActive and past subscriptionsIncremental
invoicesInvoice records with line itemsIncremental
productsProduct catalogIncremental
pricesPrice/plan definitionsIncremental
payment_intentsPayment intent objectsIncremental
disputesCharge disputes/chargebacksIncremental
refundsRefund recordsIncremental
balance_transactionsBalance transaction historyIncremental
payoutsPayout recordsIncremental
eventsStripe event logIncremental
couponsDiscount couponsIncremental
plansLegacy plan objectsIncremental

Common Errors​

ErrorCauseFix
Invalid API KeyWrong or expired keyGenerate a new key from the Stripe Dashboard
Permission deniedRestricted key missing permissionsEdit the restricted key to grant Read access on the needed resources
Rate limit exceededToo many API callsLanded handles rate limiting automatically; no action needed