> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fedapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ruby SDK

FedaPay propose une **librairie Ruby** intégrée pour interagir avec son API, particulièrement utile dans des projets Ruby on Rails.

### Installation

***Ajoutez la gemme suivante à votre fichier Gemfile***

```ruby theme={null}
$ gem install fedapay-ruby
```

### Cas d'usage

#### exemple de cas pour créer un client

```ruby theme={null}
require 'fedapay';
# configure FedaPay library
FedaPay.api_key = '' # Your secret api key
FedaPay.environment = '' # sandbox or live
phone = {
  country: 'bj',
  number: '66000001'
};
customer = FedaPay::Customer.create(
  firstname: 'firstname',
  lastname: 'lastname',
  email: 'email@test.com',
  phone_number: phone
);
```

#### exemple de cas pour créer une transaction

```ruby theme={null}
require 'fedapay'

FedaPay.api_key = 'YOUR_SECRET_API_KEY'
FedaPay.environment = 'sandbox'

transaction = FedaPay::Transaction.create(
  amount: 1000,
  currency: { iso: 'XOF' },
  customer: { id: 1 },
  description: 'Payment for order #1234',
  callback_url: 'https://example.com/callback',
  mode: 'mtn_open'
)

puts "Transaction successfully created : #{transaction.inspect}"
```

<Note>
  Pour intégrer FedaPay avec Ruby, consultez les ressources ci-dessous :

  Le dépôt GitHub officiel : [fedapay-ruby](https://github.com/FedaPay/fedapay-ruby)

  La Référence API : [api-reference](https://docs.fedapay.com/api-reference/introduction)

  Code source de l’application de démonstration : [ruby-sample](https://github.com/fedapay-samples/sample-ruby)

  Démo en ligne  : [rubysample](https://rubysample.fedapay.com)

  Ces ressources proposent des cas d’usage concrets pour vous aider à intégrer FedaPay dans vos projets Ruby de manière fluide et rapide.
</Note>