Market specifications

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

Country reference

`country` code	`currency` code	`amount` decimals
`BF`	`XOF`	2

Mandatory parameters

Bank transfers

Bank transfer parameters	B2C	P2P
`external_id`	Yes	Yes
`payment_method_id`	Yes	Yes
`flow_type`	Yes	Yes
`purpose`	Yes	Yes
`country`	Yes	Yes
`amount`	Yes	Yes
`currency`	Yes	Yes
`beneficiary.first_name`	Yes	Yes
`beneficiary.last_name`	Yes	Yes
`beneficiary.bank_account.branch`	Yes	Yes
`beneficiary.bank_account.account`	Yes	Yes
`remitter.document.type`	-	Yes
`remitter.document.id`	-	Yes
`remitter.birth_info.date`	-	Yes
`remitter.address.street`	-	Yes
`remitter.address.city`	-	Yes
`remitter.address.country`	-	Yes
`remitter.nationality`	-	Yes

Wallet transfers

Wallet transfers parameters	B2C	P2P
`external_id`	Yes	Yes
`payment_method_id`	Yes	Yes
`flow_type`	Yes	Yes
`purpose`	Yes	Yes
`country`	Yes	Yes
`amount`	Yes	Yes
`currency`	Yes	Yes
`beneficiary.first_name`	Yes	Yes
`beneficiary.last_name`	Yes	Yes
`beneficiary.instant_payment.type`	Yes	Yes
`beneficiary.instant_payment.id`	Yes	Yes
`remitter.first_name`	-	Yes
`remitter.last_name`	-	Yes
`remitter.document.type`	-	Yes
`remitter.document.id`	-	Yes
`remitter.birth_info.date`	-	Yes
`remitter.address.street`	-	Yes
`remitter.address.city`	-	Yes
`remitter.address.country`	-	Yes
`remitter.nationality`	-	Yes

Payment methods

Burkina Faso supports payouts via Bank transfers and Wallet transfers. Both methods require specific parameters and follow 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

Bank transfers in Burkina Faso require detailed account information. 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
`external_id`	Unique payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method identifier. For bank transfers, use `BANK_TRANSFER`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer) or `P2P` (Person to Person).
`purpose`	Payout purpose code. See purpose codes reference.
`country`	Country code. or Burkina Faso, use `BF`.
`amount`	Payout amount in `XOF`. Use up to 2 decimal places.
`currency`	Source currency of the FX operation. For Burkina Faso, use `XOF`. Payouts are typically paid in local currency to the beneficiary.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters.
`beneficiary.last_name`	Beneficiary's last name. Maximum 50 characters.
`beneficiary.business_name`	Beneficiary's business name. Mandatory only for B2B.
`beneficiary.bank_account.branch`	Beneficiary's bank branch.
`beneficiary.bank_account.account`	Beneficiary's bank account number.
`remitter.first_name`	Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.last_name`	Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.document.type`	Remitter's document type. Valid values: `ID` (national identification number) or `PASS` (passport). Mandatory only for remittance (P2P).
`remitter.document.id`	Remitter's identification number. Maximum 45 characters. Mandatory only for remittance (P2P).
`remitter.birth_info.date`	Remitter's date of birth in ISO 8601 format (YYYY-MM-DD). Mandatory only for remittance (P2P).
`remitter.address.street`	Remitter's street address. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter.address.city`	Remitter's city. Maximum 40 characters. Mandatory only for remittance (P2P).
`remitter.address.country`	Remitter's country code in ISO 3166-1 alpha-2 format. Mandatory only for remittance (P2P).
`remitter.nationality`	Remitter's nationality. ISO 3166-1 alpha-2 code. Mandatory only for remittance (P2P).

Example requests

{
  "external_id": "FGY3WBIPE",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "country": "BF",
  "currency": "XOF",
  "amount": 10000.50,
  "beneficiary": {
    "first_name": "Jean",
    "last_name": "Kouame",
    "bank_account": {
      "code": "BF084",
      "account": "BF42BF0840101300463574000390"
    }
  }
}

{
  "external_id": "GF0B374D-N2",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "P2P",
  "purpose": "REMITTANCES",
  "country": "BF",
  "currency": "XOF",
  "amount": 10000.50,
  "beneficiary": {
    "first_name": "Jean",
    "last_name": "Kouame",
    "bank_account": {
      "code": "BF084",
      "account": "BF42BF0840101300463574000390"
    }
  },
  "remitter": {
    "first_name": "Pierre",
    "last_name": "Dupont",
    "document": {
      "type": "Passport",
      "id": "AB1234567"
    },
    "birth_info": {
      "date": "1985-05-20"
    },
    "address": "45 Rue de la Liberté",
    "city": "Ouagadougou",
    "country": "BF",
    "nationality": "BF"
  }
}

Wallet transfers

Mobile wallet transfers in Burkina Faso enable payouts directly to mobile money accounts. Supported wallet providers include MOOV and Orange. Each provider requires specific validation rules for phone numbers and account details.

Mandatory parameters

The table below outlines the required parameters for Wallet transfers.

Mandatory parameter	Description
`external_id`	Unique payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method identifier. For wallet transfers, use `INSTANT_PAYMENT`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer) or `P2P` (Person to Person).
`purpose`	Payout purpose code. See purpose codes reference.
`country`	Country code. or Burkina Faso, use `BF`.
`amount`	Payout amount in `XOF`. Use up to 2 decimal places.
`currency`	Source currency of the FX operation. For Burkina Faso, use `XOF`. Payouts are typically paid in local currency to the beneficiary.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters.
`beneficiary.last_name`	Beneficiary's last name. Maximum 50 characters.
`beneficiary.business_name`	Beneficiary's business name. Mandatory only for B2B.
`beneficiary.phone`	Beneficiary's mobile phone. Country code (`+226`) plus mobile phone number (8 digits). Ex: +22678901234.
`beneficiary.instant_payment.type`	Type of wallet being used: `MOOV`, `ORANGE`.
`beneficiary.instant_payment.id`	Beneficiary's wallet identifier, typically the phone number.
`remitter.first_name`	Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.last_name`	Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.document.type`	Remitter's document type. Valid values: `ID` (national identification number) or `PASS` (passport). Mandatory only for remittance (P2P).
`remitter.document.id`	Remitter's identification number. Maximum 45 characters. Mandatory only for remittance (P2P).
`remitter.birth_info.date`	Remitter's date of birth in ISO 8601 format (YYYY-MM-DD). Mandatory only for remittance (P2P).
`remitter.address.street`	Remitter's street address. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter.address.city`	Remitter's city. Maximum 40 characters. Mandatory only for remittance (P2P).
`remitter.address.country`	Remitter's country code in ISO 3166-1 alpha-2 format. Mandatory only for remittance (P2P).
`remitter.nationality`	Remitter's nationality. Use ISO 3166-1 alpha-2 format. Mandatory only for remittance (P2P).

Example requests

{
  "external_id": "FGY3WBIPE1",
  "payment_method_id": "INSTANT_PAYMENT",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "country": "BF",
  "currency": "XOF",
  "amount": 10000.50,
  "beneficiary": {
    "first_name": "Jean",
    "last_name": "Kouame",
    "instant_payment": {
      "type": "MOOV",
      "id": "+22678901234"
    }
  }
}

{
  "external_id": "427GHPFEIUWB",
  "payment_method_id": "INSTANT_PAYMENT",
  "flow_type": "P2P",
  "purpose": "REMITTANCES",
  "country": "BF",
  "currency": "XOF",
  "amount": 5500.25,
  "beneficiary": {
    "first_name": "Fatou",
    "last_name": "Sankara",
    "wallet": {
      "type": "ORANGE",
      "phone": "+22678901234"
    }
  },
  "remitter": {
    "first_name": "Jean-Paul",
    "last_name": "Ouattara",
    "document": {
      "type": "PASS",
      "id": "Z987654321"
    },
    "birth_info": {
      "date": "1990-01-15"
    },
    "address": "450 Avenue de l'Indépendance",
    "city": "Bobo-Dioulasso",
    "country": "FR",
    "nationality": "FR"
  }
}