Skip to main content

Shopify

Integrate Ledyer's B2B checkout solution with your Shopify store to offer flexible payment options specifically designed for business customers.

Prerequisites​

Before you begin, ensure you have:

  • Active Shopify store (we support all features starting from the Basic plan)
  • Business customer focus - Ledyer is designed specifically for B2B transactions

Features and limitations​

Supported Features​

✅ Available with Ledyer:

  • Company credit checks
  • Invoice payments with extended terms (30 days)
  • Fallback to advance invoice when credit is denied
  • Multi-currency support
  • Order lines and tax handling (VAT, sales tax)
  • Order management and tracking
  • Full order capture
  • Full and partial refunds
  • Order cancellation

❌ Not Available:

  • B2C
  • Partial capture (due to Shopify limitations)

Currency support​

Ledyer Payments works with multi-currency stores where the base currency differs from the storefront currency. For example, a store with EUR as base currency but displaying SEK prices to Swedish customers. Shopify only provides us with the base currency (EUR), so Shopify checkout will show "Amount will be charged in EUR." However, once customers reach the Ledyer payment page, we display and charge in the correct storefront currency (SEK). This is a Shopify limitation.

An image from the static

The user can ignore the note about being charged in EUR, in this case Ledyer will charge the user in the expected currency SEK.

Order creation from Shopify admin​

If you want to create an order for your customer that will be paid with Ledyer, the easiest way is to create a draft order:

  1. Open your Shopify admin
  2. Go to Orders > Drafts
  3. Click Create order
  4. Add the products and (if you prefer) customer details
  5. Click Send invoice and type the email you want to receive the order.

After this has been done the chosen email address will receive an email from Shopify with a link to your stores checkout page. Your customer can now choose to pay with Ledyer or any other payment provider you have available.

Setup Steps​

Step 1: Install Ledyer App​

  1. Visit Shopify App Store

  2. Connect Your Ledyer Account

    • Enter your Ledyer API credentials
    • Configure sandbox/production environment
    • Test the connection

Step 2: Configure Payment Settings​

Ledyer payments will work with any settings, but we strongly recommend the following for optimal integration. Configure these Shopify settings under Checkout:

An image from the static

  1. Always collect email - we'll collect it in Ledyer Payments otherwise, but keep this setting for the best customer experience
  2. Require both first and last name
  3. Company name isn't necessary as this information will be collected more easily inside Ledyer Payments
  4. Always allow your customer to be as precise as possible with address information
  5. Shipping address phone number will be used as backup contact information if the email bounces

Step 3: Webhook Configuration​

For optimal integration, configure these webhooks in your Shopify settings.

  1. Navigate to Settings > Notifications > Webhooks
  2. Click Create webhook and select Event: checkout/update, URL: https://shopify-api.live.ledyer.com/webhook
  3. Create another webhook with the same URL but Event: checkout/creation
  • checkout/update - tells Ledyer that an order has been updated
  • checkout/creation - tells Ledyer that an order has been created

An image from the static

Step 3: Retrieve credentials for Ledyer payments​

In this step, you will generate two important keys that connect Ledyer payments to Ledyer

  1. Log in to Ledyer merchant portal.
  2. Inside the merchant portal you can click Settings > API credentials > Generate new > Choose Full access, enter any name like "Ledyer payments for shopify" and press Generate.
  3. Copy the generated ID and Secret and save them somewhere safe (if you lose them you can always generate new ones).
  4. You can now proceed to the next step where we will enter the ID and Secret inside Shopify.

Step 4: Configure Ledyer payments​

This is the final step for setting up Ledyer payments on your Shopify store

  1. Navigate to Options > Payments > Click on Ledyer > More actions > Manage
  2. Enter the ID and Secret you generated in the previous step in Live Client ID and Live Client Secret.
  3. Enter the url to your shops terms and conditions page.
  4. Submit

An image from the static

How to find settings for Ledyer payments

An image from the static

How to configure Ledyer Payments for live (production)

Sandbox Environment​

Optional step

If you are not setting up a test environment you can skip this step.

Use Ledyer's sandbox environment for testing. You can use any company and contact information - no real orders will be created and no money will be involved. Just remember that the email you use will receive test data.

  1. Generate sandbox client ID and secret in our sandbox merchant portal
  2. Set your environment to Sandbox
  3. Set up Shopify webhook secret to keep orders in sync between Shopify and Ledyer e.g. just like in Webhook Configuration step but use the sandbox url https://shopify-api.sandbox.ledyer.com/webhook instead.

An image from the static

How to configure Ledyer Payments for sandbox (test)

Testing Best Practices

Always test your integration thoroughly in sandbox mode before going live. Pay special attention to order status synchronization - making sure orders stay in sync between Shopify and Ledyer's merchant portal.

Going Live​

Pre-Launch Checklist​

Before switching to production:

  • Environment is set to Live
  • Live Client ID and Live Client Secret are configured
  • You've read about security levels and set one that fits your store
  • Webhooks are set up
  • Successful purchase has been tested
  • Customer service team is trained

Support and Resources​

Getting Help​

If you run into issues during setup, reach out to merchant@ledyer.com.

Required Information for Support​

When contacting support, please provide:

  • Shopify store URL
  • Detailed description of the issue
  • Screenshots or error messages
  • Test transaction details (if applicable)

Need help with your Shopify integration? Contact our integration specialists for personalized assistance with your B2B payment setup.