--- updatedAt: 2026-06-17T14:52:25.000Z agentTools: projectIndex: https://docs.dlocal.com/llms.txt --- # Senegal Learn about the dLocal supported payment methods in Senegal. [block:html] { "html": "\n \n

\n\n \n

$\"\"$

Market specifications

\n Take a look of all the payment methods available. \n

\n Country reference\n Cards supported\n APM supported\n

\n \n \n \n

$\"\"$

Cards

\n Find all the information about the card supported capabilities. \n

\n Capabilities\n Process Card Payments\n

\n \n \n

$\"\"$

Alternative Payments

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

\n Mobile Money\n

\n \n " } [/block] 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](https://dlocal.com/payment-processors-middle-east-africa) 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 | Logo | | :------------------ | :------- | :----------------- | :-------------------- | :------------ | :------------------ | :---------------------------------------------------------------------------------- | | `CARD` | `VD` | Visa Debit | `CARD` | Debit Card | `DIRECT` `REDIRECT` |

| | `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](https://docs.dlocal.com/docs/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](http://en.wikipedia.org/wiki/ISO_4217). | Yes | | `country` | String | `SN`

Transaction country in [ISO 3166](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes). | 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 ```json Request Example DIRECT { "amount": 1000, "currency": "XOF", "country": "SN", "payment_method_id": "FM", "payment_method_flow": "DIRECT", "payer": { "name": "Jane Doe", "email": "janedoe@mymail.com", "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" } ``` ```json Request Example REDIRECT { "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": "aminata@example.com", "phone": "+221771234567", "document": "1234567890123" } } ``` ````json Response Example DIRECT { "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" } ``` ```` ````json Response Example REDIRECT { "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" } ``` ````