Market specifications

Do you want to know more information about Morocco's market? Go to the Morocco’s economy and eCommerce market article.

Country reference

`country` code	`currency` code	`amount` decimals	`document_type` name	`document_id` format
`MA`	`MAD`	2	CNIE	Between 5 to 20 characters

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_account`	Yes	Yes	Yes
`amount`	Yes	Yes	Yes
`currency`	Yes	Yes	Yes
`address`	Yes	Yes	Yes
`purpose`	-	-	Yes
`remitter_full_name`	-	-	Yes
`remitter_country`	-	-	Yes
`remitter_document_type`	-	-	Yes
`remitter_document`	-	-	Yes
`remitter_birth_date`	-	-	Yes

Payment methods

Morocco supports payouts via Bank transfers. This method requires specific parameters and follows validation rules aligned with local compliance and banking standards.

Bank transfers

Bank transfers in Morocco require detailed account information, including RIB. The format of these fields depends on the receiving bank, and strict validation rules apply.

Refer to the bank codes section for format specifications.

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 Morocco, use `MA`.
`bank_account`	RIB (Relevé d'Identité Bancaire) length 24 digits. See bank codes below.
`amount`	Payout amount. Use up to 2 decimal places.
`currency`	Payout currency. For Morocco, use `MAD` or `USD`.
`address`	Full address of the beneficiary. Maximum 200 characters.
`purpose`	Reason for the payout. `EPREMT` for Remittance (P2P). Mandatory only for remittance (P2P).
`remitter_full_name`	Full name of the sender. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter_country`	ISO 3166-1 alpha-2 code of the sender. 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).

Example request

{
  "login": "1n234n56",
  "pass": "HolAc123o",
  "external_id": "1234567812345678b",
  "beneficiary_name": "JUAN",
  "beneficiary_lastname": "PEREZ",
  "country": "MA",
  "bank_account": "007787001988877665431292",
  "amount": "2977.89",
  "comments": "this is the 1st comment",
  "currency": "MAD",
  "address": "14 Boulevard Al Massira Al Khadra",
  "extra_info": "{ \"this_is_extra\": 2334 }",
  "notification_url": "https://thisisawebsite.net/payments",
  "type": "json"
}

Bank information

Access the reference formats and accepted values required for processing bank payouts in Morocco.

Bank account validations

Validation	Type	Length	Type	Verification
Bank account	RIB	24	numeric	Validate length

Bank codes

These are the values the bank_code parameter can take in Morocco (positions 1 to 3 in the RIB to be sent in the bank_account parameter).

Bank name	Bank Code
ABN Amro	023
Al Barid Bank	350
Al Akhdar Bank	365
Al Amal Bank	045
Arab Bank	002
Arreda	364
ATW International Bank SA	605
AWB	007
Bank Al-Maghrib	001
Bank Al Yousr	366
Bank Al Tamweel Wa Al Inma	367
Banco Sabadell	070
Banque Internationale de Tanger /Credit du Maroc	610
Banque Populaire Beni Mellal	109
Banque Populaire Berkane	163
Banque Populaire Casa Est	195
Banque Populaire Casa Sud	197
Banque Populaire Casablanca	178
Banque Populaire Centre Sud	101
Banque Populaire El Houceima	105
Banque Populaire El Jadida Safi	117
Banque Populaire Errachidia	121
Banque Populaire Fes Taza	127
Banque Populaire Gharb	133
Banque Populaire Jadida	130
Banque Populaire Khouribga	140
Banque Populaire Laayoune	143
Banque Populaire Marrakesh Beni Mellal	145
Banque Populaire Meknes	148
Banque Populaire Nador El Hoceima	150
Banque Populaire Ouarzazate	155
Banque Populaire Oujda	157
Banque Populaire Rabat Kenitra	181
Banque Populaire Safi	159
Banque Populaire Tanger Tetouan	164
Banque Populaire Taza	169
Banque Populaire Tetouan	172
Banque Populaire Tiznit	175
BCP	190
BCP Securities Services	048
BMCE	011
BMCE Bank Offshore	630
BMCI	013
BMCI Najmah	361
BMCI Offshore Group BNP	615
BMAO	025
BNDE	205
Caixa	003
CAM	225
CDG	060
CDG Capital	054
CDM	021
CFM	050
Chaabi International Bank Offshore	625
CIH Bank	230
Citi Bank	028
Dar Al Amane	363
Ex-Wafa Bank	019
SGMB	022
SMDC	031
TGR	310
UMNIA Bank	360
UMB	005
Uniban	026