DocsGetting startedSelect your payment methods

Payment Methods

Available Providers

// List available payment providers
const providers = await lomi.providers.list();

Response example:

{
  "providers": [
    {
      "code": "ORANGE_MONEY",
      "name": "Orange Money",
      "currencies": ["XOF"],
      "status": "active"
    },
    {
      "code": "WAVE",
      "name": "Wave",
      "currencies": ["XOF"],
      "status": "active"
    },
    {
      "code": "MTN",
      "name": "MTN Mobile Money",
      "currencies": ["XOF"],
      "status": "active"
    }
  ]
}

Using Providers in Checkout

const session = await lomi.checkoutSessions.create({
  merchant_id: 'your_merchant_id',
  provider_codes: ['ORANGE_MONEY', 'WAVE'], // Specify available methods
  amount: 1000,
  currency: 'XOF',
  success_url: 'https://your-site.com/success',
  cancel_url: 'https://your-site.com/cancel',
  metadata: {
    order_id: '123'
  }
});

Provider Requirements

Mobile Money

  • Orange Money: Requires customer phone number
  • Wave: Requires customer phone number

All mobile money providers:

  • Support XOF currency
  • Require valid phone numbers
  • Process payments in real-time

Testing

Use these test credentials:

xxxxxx

Error Handling

xxxxxx

Next Steps

Last updated on