Introducing our brand new Rules Engine —
Read the docs
LogoLogo
Core APIOther APIsChangelog
How-tos
How-tos
  • Introduction
  • Product discovery
    • Product listing page
    • Product page
  • Placing orders
    • Shopping cart
      • Creating a shopping cart
      • Adding products to cart
      • Updating cart quantities
      • Removing products from cart
      • Displaying the cart summary
    • Checkout
      • Adding the customer
      • Adding a billing address
      • Adding a shipping address
      • Selecting a shipping method
      • Selecting a payment method
      • Adding a payment source
      • Adding a gift card or coupon
      • Placing the order
    • Subscriptions
      • Configuring a subscription model
      • Selecting the source order
      • Generating the subscriptions
      • Updating the subscriptions
    • Payments
      • Adyen
        • Adding the payment source
        • Sending back the payment details
        • Configuring the notification webhooks
        • Reusing the payment source
      • Axerve
        • Adding the payment source
        • Updating the payment intent
      • Braintree
        • Adding the payment source
        • Sending back the payment method nonce
        • Accepting local payments
        • Reusing the payment source
      • Checkout.com
        • Adding the payment source
        • Getting the payment details
        • Refreshing pending transactions
        • Reusing the payment source
      • Klarna
        • Adding the payment source
        • Sending back the authorization token
        • Reusing the payment source
      • PayPal
        • Adding the payment source
        • Preparing the payment for execution
      • Stripe
        • Adding the payment source
        • Refreshing the payment source
        • Reusing the payment source
      • Manual payments
        • Adding a wire transfer payment source
      • External payments
        • Adding the payment source
        • Reusing the payment source
    • Auto-capture
      • Enabling the auto-capture
      • Limiting the auto-capture amount
  • inventory
    • Inventory strategies
      • No split
      • Split shipments
      • Split by line items
      • Ship from first available (or primary)
      • Ship from primary
  • FAQ
    • Environments and initial setup
    • Authentication and access tokens
On this page
  1. Placing orders

Payments

How to pay for an order using one of the supported payment gateways

PreviousUpdating the subscriptionsNextAdyen

Last updated 2 years ago

Typically, every payment gateway integration process consists of two main stages: a client-side and a server-side one.

For security and compliance reasons, Commerce Layer never touches credit card data.

Specifically, the payment details are collected, tokenized — or encrypted — and sent to the payment service on the client-side, leveraging the SDKs and libraries provided by the service itself (i.e. Commerce Layer always receives a token — never stores, for instance, any credit card information). On the other hand, our platform takes care of all the server-side parts of the process, offering an out-of-the-box integration with the most common payment gateways.

Commerce Layer payments are idempotent. The order and payment statuses are granted to be , throughout the whole payment process (e.g. it's possible to place or cancel an order more than one time, without worrying about duplicated transactions and other side effects).

These guides will walk you through the different steps you need to follow in order to let your customers process their payments using the payment method they selected and its corresponding payment gateway or service.

Supported payment gateways

These are the payment gateways and services Commerce Layer is currently integrated with. Most of them are compliant with the PSD2 European regulation so that you can implement a payment flow that supports SCA and 3DS2. As anticipated, each of them has its own integration pattern. For details and examples of how to implement the payment flow in any of these cases, see the related sections.

If you're planning to use a different service to process your payments, feel free to contact us. We are constantly working on expanding this list and definitely open to adding any additional payment gateway, based on the requests and needs of our clients.

consistent upon multiple updates
Adyen
Axerve
Braintree
Checkout.com
Klarna
PayPal
Stripe
Manual payments
External payments