Rwanda
Learn everything you need to know to make payouts in Rwanda with dLocal.
Market specifications
Take a look of all the information you need to make a payout.
Country reference Mandatory paramentersPayment methods
Find all the information about payment methods capabilities.
Bank transfers Wallet transfersMarket specifications
Do you want to know more information about Rwanda's market? Go to the Expand Your Reach in Africa’s eCommerce Market article.
Country reference
country code | currency code | amount decimals | document_type name | document_id format |
---|---|---|---|---|
RW | RWF | 0 | National Identity Card | 16 digits |
Mandatory parameters
Bank transfers
Bank transfer parameters | B2C | B2B | P2P |
---|---|---|---|
login | Yes | Yes | Yes |
pass | Yes | Yes | Yes |
external_id | Yes | Yes | Yes |
beneficiary_name | Yes | Yes | Yes |
beneficiary_lastname | Yes | Yes | Yes |
country | Yes | Yes | Yes |
bank_branch | Yes | Yes | Yes |
bank_account | Yes | Yes | Yes |
amount | Yes | Yes | Yes |
currency | Yes | Yes | Yes |
purpose | - | - | Yes |
remitter_full_name | - | - | Yes |
remitter_document_type | - | - | Yes |
remitter_document | - | - | Yes |
remitter_birth_date | - | - | Yes |
remitter_address | - | - | Yes |
remitter_city | - | - | Yes |
remitter_country | - | - | Yes |
remitter_nationality | - | - | Yes |
Wallet transfers
Wallet transfer parameters | B2C | B2B | P2P |
---|---|---|---|
login | Yes | Yes | Yes |
pass | Yes | Yes | Yes |
external_id | Yes | Yes | Yes |
beneficiary_name | Yes | Yes | Yes |
beneficiary_lastname | Yes | Yes | Yes |
country | Yes | Yes | Yes |
account_type | Yes | Yes | Yes |
phone | Yes | Yes | Yes |
amount | Yes | Yes | Yes |
currency | Yes | Yes | Yes |
purpose | - | - | Yes |
remitter_full_name | - | - | Yes |
remitter_document_type | - | - | Yes |
remitter_document | - | - | Yes |
remitter_birth_date | - | - | Yes |
remitter_address | - | - | Yes |
remitter_city | - | - | Yes |
remitter_country | - | - | Yes |
remitter_nationality | - | - | Yes |
Payment methods
Rwanda supports payouts via Bank transfers and Wallet transfers. Each method requires specific parameters and follows validation rules aligned with local compliance and banking standards.
Use Wallet transfers for instant payments to mobile wallets. Use Bank transfers when sending funds directly to a bank account.
Bank transfers
Rwanda bank transfers require detailed account information, including SWIFT code and account number. The format of these fields depends on the receiving bank, and strict validation rules apply.
Mandatory parameters
All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types.
Mandatory parameter | Description |
---|---|
login | API authentication credentials. Maximum 32 characters. |
pass | API authentication credentials. Maximum 32 characters. |
external_id | Unique transaction identifier. Maximum 100 characters. |
beneficiary_name | First name of the beneficiary. Maximum 50 characters. |
beneficiary_lastname | Last name of the beneficiary. Maximum 50 characters. |
country | Country code. For Rwanda, use RW . |
bank_branch | SWIFT code (8 or 11 alphanumeric characters in upper case). |
bank_account | Bank account number. Minimum length 8 and Maximum length 20. |
amount | Payout amount. Use up to 2 decimal places. |
currency | Payout currency. For Rwanda, use RWF or USD . |
purpose | Reason for the payout. EPREMT (remittance). Mandatory only for remittance (P2P). |
remitter_full_name | Full name of the sender. Maximum 50 characters. Mandatory only for remittance (P2P). |
remitter_document_type | Type of identification document: ID for national identification number, PASS for passport. Mandatory only for remittance (P2P). |
remitter_document | Document number of the sender. Maximum 45 characters. Mandatory only for remittance (P2P). |
remitter_birth_date | Sender’s birth date in YYYYMMDD format. Mandatory only for remittance (P2P). |
remitter_address | Full address of the sender. Maximum 200 characters. Mandatory only for remittance (P2P). |
remitter_city | City of the sender. Maximum 40 characters. Mandatory only for remittance (P2P). |
remitter_country | ISO 3166-1 alpha-2 code of the sender. Mandatory only for remittance (P2P). |
remitter_nationality | ISO 3166-1 alpha-2 code of the sender's nationality. Mandatory only for remittance (P2P). |
Example request
{
"login": "1n234n56",
"pass": "HolAc123o",
"external_id": "68907654222332-223",
"beneficiary_name": "Jhon",
"beneficiary_lastname": "Miles",
"country": "RW",
"amount": "100",
"currency": "RWF",
"bank_branch": "ABBRRWRW",
"bank_account": "045264442334",
"notification_url": "https://thisisawebsite.net/payments",
"type": "json"
}
Wallet transfers
Wallet transfers enable real-time transfers using a mobile phone number linked to a wallet.
The account_type
field must indicate the type of wallet being used (e.g., Airtel, MTN). The phone
field must be present and correctly formatted.
Mandatory parameters
The table below outlines the required parameters for Wallet transfers.
Mandatory parameter | Description |
---|---|
login | API authentication credentials. Maximum 32 characters. |
pass | API authentication credentials. Maximum 32 characters. |
external_id | Unique transaction identifier. Maximum 100 characters. |
beneficiary_name | First name of the beneficiary. Maximum 50 characters. |
beneficiary_lastname | Last name of the beneficiary. Maximum 50 characters. |
country | Country code. For Rwanda, use RW . |
account_type | Type of wallet being used: AIRTEL or MTN . |
phone | Phone number in E.164 format +250 + mobile phone number (9 digits). |
amount | Payout amount. Use up to 2 decimal places. |
currency | Payout currency. For Rwanda, use RWF or USD . |
purpose | Reason for the payout. EPREMT for Remittance (P2P). Mandatory only for remittance (P2P). |
remitter_full_name | Full name of the sender. Maximum 50 characters. Mandatory only for remittance (P2P). |
remitter_document_type | Type of identification document: ID for national identification number, PASS for passport. Mandatory only for remittance (P2P). |
remitter_document | Document number of the sender. Maximum 45 characters. Mandatory only for remittance (P2P). |
remitter_birth_date | Sender’s birth date in YYYYMMDD format. Mandatory only for remittance (P2P). |
remitter_address | Full address of the sender. Maximum 200 characters. Mandatory only for remittance (P2P). |
remitter_city | City of the sender. Maximum 40 characters. Mandatory only for remittance (P2P). |
remitter_country | ISO 3166-1 alpha-2 code of the sender. Mandatory only for remittance (P2P). |
remitter_nationality | ISO 3166-1 alpha-2 code of the sender's nationality. Mandatory only for remittance (P2P). |
Example request
{
"login": "1n234n56",
"pass": "HolAc123o",
"external_id": "RWX7Y2P4Q",
"beneficiary_name": "Kamanzi",
"beneficiary_lastname": "Uwase",
"country": "RW",
"account_type": "MTN",
"phone": "+250783456789",
"amount": 1250.50,
"currency": "RWF",
"purpose": "EPREMT",
"remitter_full_name": "Mukamana Aline",
"remitter_document_type": "ID",
"remitter_document": "987654321",
"remitter_birth_date": "19930612",
"remitter_address": "123 Rue de Bruxelles, Brussels, BE",
"remitter_city": "Brussels",
"remitter_country": "BE",
"remitter_nationality": "RW"
}
Updated 14 days ago