Accept a payment with Alma

To support Alma payments, a Checkout Session must satisfy all of the following conditions:

• Prices for all line items must be in the same currency.
  • If you have line items in different currencies, create separate Checkout Sessions for each currency.

This guide describes how to enable Alma and shows the differences between accepting a card payment and using Alma.

Enable Alma as a payment method

When creating a new Checkout Session, you need to:

1. Add alma to the list of payment_method_types.
2. Make sure all line_items use the same currency.

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'alma'],
  line_items: [{
    price_data: {
      currency: 'usd',
      # To accept `alma`, all line items must have currency: eur
      currency: 'eur',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Fulfill your orders

After accepting a payment, learn how to fulfill orders.

When testing your Checkout integration, select Alma as the payment method and click the Pay button.