Mandatory parameters

Mandatory parameterDescriptionFlow type
login32 charsALL
pass32 charsALL
external_idMax. 100 charsALL
beneficiary_nameMax. 50 charsALL
beneficiary_lastnameMax. 50 charsALL
countryMAALL
bank_accountRIB length 24 digits
See bank codes below.
ALL
amountMax. 2 decimal numbersALL
currencyMAD or USDALL
addressMax. 200 charsALL
purposeEPREMT - Remittance (P2P)
Mandatory only for remittance (P2P)
P2P
remitter_full_nameMax. 200 chars
Mandatory only for remittance (P2P)
P2P
remitter_countryISO 3166-1 alpha-2 code
Mandatory only for remittance (P2P)
P2P
remitter_document_type'ID' for national identification number
'PASS' for passport
Mandatory only for remittance (P2P)
P2P
remitter_documentMax. 45 chars
Mandatory only for remittance (P2P)
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 account validations

ValidationTypeLengthTypeVerification
Bank accountRIB24numericValidate length

Bank codes

These are the bank codes supported in Morocco (positions 1 to 3 in the RIB to be sent in the bank_account parameter).

Bank CodeBank Name
001BANK AL-MAGHRIB
002ARAB BANK
003CAIXA
005UMB
007AWB
011BMCE
013BMCI
019EX-WAFA BANK
021CDM
022SGMB
023ABN AMRO
025BMAO
026UNIBAN
028CITI BANK
031SMDC
045BANK AL AMAL
048BCP SECURITIES SERVICES
050CFM
054CDG CAPITAL
060CDG
070BANCO SABADELL
101BANQUE POPULAIRE CENTRE SUD
105BANQUE POPULAIRE EL HOUCEIMA
109BANQUE POPULAIRE BENI MELLAL
117BANQUE POPULAIRE EL JADIDA SAFI
121BANQUE POPULAIRE ERRACHIDIA
127BANQUE POPULAIRE FES TAZA
130BANQUE POPULAIRE JADIDA
133BANQUE POPULAIRE GHARB
140BANQUE POPULAIRE KHOURIBGA
143BANQUE POPULAIRE LAAYOUNE
145BANQUE POPULAIRE MARRAKESH BENI MELLAL
148BANQUE POPULAIRE MEKNES
150BANQUE POPULAIRE NADOR EL HOCEIMA
155BANQUE POPULAIRE OUARZAZATE
157BANQUE POPULAIRE OUJDA
159BANQUE POPULAIRE SAFI
163BANQUE POPULAIRE BERKANE
164BANQUE POPULAIRE TANGER TETOUAN
169BANQUE POPULAIRE TAZA
172BANQUE POPULAIRE TETOUAN
175BANQUE POPULAIRE TIZNIT
178BANQUE POPULAIRE CASABLANCA
181BANQUE POPULAIRE RABAT KENITRA
190BCP
195BANQUE POPULAIRE CASA EST
197BANQUE POPULAIRE CASA SUD
205BNDE
225CAM
230CIH BANK
310TGR
350AL BARID BANK
360UMNIA BANK
361BMCI NAJMAH
362BANK ASSAFA
363DAR AL AMANE
364ARREDA
365AL AKHDAR BANK
366BANK AL YOUSR
367BANK AL TAMWEEL WA AL INMA
605ATW INTERNATIONAL BANK SA
610BANQUE INTERNATIONALE DE TANGER /CREDIT DU MAROC
615BMCI OFFSHORE GROUP BNP
625CHAABI INTERNATIONAL BANK OFFSHORE
630BMCE BANK OFFSHORE