Market specifications

Take a look of all the payment methods available.

Country reference Cards supported APM supported

Cards

Find all the information about the card supported capabilities.

Capabilities Process Card Payments

Alternative Payments

Learn how to integrate cash, bank transfer or wallet payment.

Mobile Money

This page covers Senegal's supported payment methods, country requirements, and Mobile Money flow rules.

Market specifications

Do you want to know more information about Senegal's market? Go to the Expand Your Reach in Africa’s eCommerce Market article.

Country reference

`country` code	`currency` code	`amount` decimals	`document` name	`document` format	`document` required?
`SN`	`XOF`	2	CNI or ECOWAS ID Card	13 to 17 digits	Yes

Cards supported

`payment_method_id`	Brand ID	Name	`payment_method_type`	Details	Allowed Flows
`CARD`	`VD`	Visa Debit	`CARD`	Debit Card	`DIRECT` `REDIRECT`
`CARD`	`MC`	Mastercard	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`MD`	Mastercard Debit	`CARD`	Debit Card	`DIRECT` `REDIRECT`

ℹ️
To offer all the card options that may be available in your integration, send the payment_method_id as CARD.

Alternative payment methods

`payment_method_id`	Name	`payment_method_type`	Allowed Flows
`MW` / All telecom companies	Mobile Money	`BANK_TRANSFER`	`DIRECT`
`WV` / Wave	Mobile Money	`BANK_TRANSFER`	`REDIRECT`
`FM` / Mixx by Yas	Mobile Money	`BANK_TRANSFER`	`DIRECT`
`OR` / Orange	Mobile Money	`BANK_TRANSFER`	`REDIRECT`

Cards

Capabilities

	Mastercard Credit	Visa Debit	Mastercard Debit
Refunds	Yes	Yes	Yes
Recurring	Yes	Yes	Yes
Chargeback option	Yes	Yes	Yes
Chargeback Dispute option	Yes	Yes	Yes
Descriptor	Can be personalized, depending on provider.	Can be personalized, depending on provider.	Can be personalized, depending on provider.

Process card payments

Learn how to process payments with credit and debit cards with dLocal in our Card Payments section.

Alternative Payment Method

Mobile Money

Mobile Money enables transactions through mobile phone accounts operated by Senegal's major telecom providers: Wave, Orange Money, and Mixx by Yas (Free Money).

Capabilities

	Mobile Money
Maximum expiration time supported	10 minutes to 5 days, depending on provider.
Notification delay	Immediate
Refunds	Yes
Flow	`DIRECT` or `REDIRECT` — depends on provider (see table below)
Supported wallets	Wave, Orange Money and Free Money

Flow type varies by provider

Wave (WV) and Orange Money (OR) use REDIRECT flow — the customer is sent to the provider's page to complete payment.
Mixx by Yas (FM) and the generic code (MW) use DIRECT flow — a push notification is sent to the customer's phone for PIN authorization. Using the wrong flow will result in a failed payment.

Provider	Code	Flow	Max. expiration	Refunds	Notification delay
Wave	`WV`	`REDIRECT`	5 days	Yes	Immediate
Orange Money	`OR`	`REDIRECT`	5 days	Yes	Immediate
Mixx by Yas (Free Money)	`FM`	`DIRECT`	10 minutes	Yes	Immediate
Generic	`MW`	`DIRECT`	10 minutes	Yes	Immediate

circle-info

The generic code MW routes to DIRECT-flow providers only. To initiate a Wave or Orange Money payment, use the specific provider code (WV or OR) with REDIRECT flow. Using the wrong flow can cause the payment to fail.

UX Flow

Flow might slightly differ depending on the provider.

Alternative flow

Request parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged.	Yes
`currency`	String	`XOF` Transaction currency in ISO 4217.	Yes
`country`	String	`SN` Transaction country in ISO 3166.	Yes
`payment_method_id`	String	`WV`, `OR`, `FM`, or `MW`	Yes
`payment_method_flow`	String	`DIRECT` for `FM`/`MW`; `REDIRECT` for `WV`/`OR`	Yes
`payer.name`	String	Name of the payer.	Yes
`payer.email`	String	Email of the payer.	Yes
`payer.phone`	String	Phone number of the payer.	Yes
`payer.document`	String	Document of the payer.	Yes
`order_id`	String	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	No
`callback_url`	String	The payer will be redirected to the merchant’s website after completing the payment via the `callback_url` specified by the merchant.	Required for `REDIRECT`

Examples

{
    "amount": 1000,
    "currency": "XOF",
    "country": "SN",
    "payment_method_id": "FM",
    "payment_method_flow": "DIRECT",
    "payer": {
        "name": "Jane Doe",
        "email": "[email protected]",
        "phone": "+221771234567",
        "document": "1234567890123456",
        "address": {
            "country": "SN",
            "state": "Dakar",
            "city": "Dakar",
            "zip_code": "8858",
            "street": "Main St.",
            "number": "540"
        }
    },
    "order_id": "34545sk3483kqw0",
    "description": "T-shirt",
    "notification_url": "http://merchantsite.com/notification/new"
}

{
  "amount": 1000,
  "currency": "XOF",
  "country": "SN",
  "payment_method_id": "WV",
  "payment_method_flow": "REDIRECT",
  "order_id": "ord-0002",
  "description": "Order payment",
  "notification_url": "https://merchant.com/notifications",
  "callback_url": "https://merchant.com/return",
  "payer": {
    "name": "Aminata Diallo",
    "email": "[email protected]",
    "phone": "+221771234567",
    "document": "1234567890123"
  }
}

{
  "id": "D-0001-XXXXXXXXXX",
  "amount": 1000,
  "currency": "XOF",
  "payment_method_id": "FM",
  "payment_method_flow": "DIRECT",
  "country": "SN",
  "status": "PENDING",
  "status_code": "100",
  "status_detail": "The payment is pending"
}
```

{
  "id": "D-0002-XXXXXXXXXX",
  "amount": 1000,
  "currency": "XOF",
  "payment_method_id": "WV",
  "payment_method_flow": "REDIRECT",
  "country": "SN",
  "status": "PENDING",
  "status_code": "100",
  "status_detail": "The payment is pending",
  "redirect_url": "https://wave.com/pay/XXXXXXXXXX"
}
```