Awesome Open Source
Awesome Open Source


Build Status Coverage Status

[rahy-uh l]


  1. rose noble.
  2. a former gold coin of Scotland, equal to 60 shillings.
  3. a former silver coin of Scotland, equal to 30 shillings.

An e-commerce library for elixir.


Ryal is a wrapper over several packages. Each one has its own purpose, but they all depend on two dependencies: Ecto and Ryal Core. The core concept of Ryal is to make it easier for you to make money, which is essencially what the core is: a payment system. If you're making a SaaS product and need to accept credit cards, the ryal_core package is all you need. This is basically all Ryal tries to do at the end of the day: put money in your bank account.

Each app inside of Ryal has a Readme which will detail exactly how to use that dependency. Each Ryal package has its own methods points of being configured and you should refer to those on their usage and configuration steps.

Quick Setup

First and foremost, add Ryal to your mixfile and each umbrella application to the applications.

# mix.exs

defp applications do

defp deps do
    {:ryal, "~> 0.x"}
    # or, if you're brave and trust us (which you shouldn't):
    {:ryal, github: "ryal/ryal"}

Add this bad boy to your config.exs and replace App with the name of your application. We're setting it to :ryal_core because that's what everything builds off of. Please see Ryal.Core for an explanation on the keys provided in this configuration.

config :ryal_core,
  repo: App.Repo,
  user_module: App.User,
  user_table: :users,
  payment_gateways: [
    %{type: :bogus},
    %{type: :stripe, token: "sk_test_123"}

Now you'll want to copy over the migrations.

mix ryal.install

And, to mount the API (if you'll be using it), add this line to your router:

forward "/api", Ryal.Api.Router

Also, please don't forget to add pagination via Scrivener to your Repo:

defmodule App.Repo do
  use Ecto.Repo, otp_app: :app
  use Scrivener, page_size: 20


Don't hesitate to open a PR! We're always happy to help out. If you have a question, a bug report, or a performance issue, we're happy to hear about it and answer it. Also, this project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.


Run this command over every package that you wish to test:

MIX_ENV=test mix db.reset

Then run the tests:

mix test



We currently accept donations with Bitcoin. If you're really interested in this project and would love to see the development accelerate, you can always send us a message via email or on the Elixir Slack and let us know what you need. By providing Bitcoin, the neurons in our brain suddenly begin feeling more interested. Wallet QR code and address:



This package is available as open source under the terms of the MIT License.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
elixir (1,209
ecommerce (223
shop (92
e-commerce (80
money (76
shopping-cart (72
ecommerce-platform (58