Migrating Data From Stripe

    Securely export sensitive payment data out of your Stripe account to another payment processor.

    We believe that our customers should own the sensitive data they entrust to Stripe, and we work hard to ensure your access to this data—even if you are moving elsewhere.

    If you decide to leave Stripe for another payment processor, we’ll work with your new processor’s team to securely transfer your credit card data.

    Where we can transfer your data

    To meet PCI compliance obligations, we can only transfer your card data to another PCI DSS Level 1-compliant payment processor. Stripe requires the following information about the processor receiving the data:

    1. The processor’s current PCI Attestation of Compliance (AOC), or their listing on Visa’s Global Registry of Service Providers.
    2. The processor’s PGP public encryption key, which must be 4096 bits or greater in length. This key must be hosted over HTTPS on one of the processor’s domain names referenced in their AOC or Visa Registry listing.

    Once you let us know who your new payment processor is, we can usually confirm if they meet these requirements.

    Data that can be migrated

    Stripe can help you migrate your customer card information to a new payment processor. To do this securely, Stripe prepares an encrypted JSON export file containing your data, including the card details of your customers, email addresses, and any attached metadata. We then arrange a secure transfer with your new processor, who uses this file to import the data into their system. You can start the migration process by contacting us with the name of your new payment processor.

    {
      "customers": [
        {
          "id": "cus_abc123def456",
          "email": "jenny.rosen@example.com",
          "description": "Jenny Rosen",
          "default_source": "card_edf214abc789",
          "metadata": {
            "color_preference": "turquoise",
            ...
          },
          "cards": [
            {
              "id": "card_edf214abc789",
              "number":"4242424242424242",
              "name": "Jeny Rosen",
              "exp_month": 1,
              "exp_year": 2020,
              "address_line1": "123 Main St.",
              "address_line2": null,
              "address_city": "Springfield",
              "address_state": "MA",
              "address_zip": "01101",
              "address_country": "US"
            },
            ...
          ]
        },
        ...
      ]
    }
    

    Stripe does not export your account’s payment history, subscriptions, or other objects. Instead, you should use the API or Dashboard to retrieve this information. You can continue to access your data through the Dashboard and API after you migrate and no longer process payments with us, so long as you don’t close or delete your account.

    Further reading