Mandatory parameters - Bank transfers

Mandatory parameter	Description	Flow type
`login`	32 chars	ALL
`pass`	32 chars	ALL
`external_id`	Max. 100 chars	ALL
`beneficiary_name`	Max. 50 chars	ALL
`beneficiary_lastname`	Max. 50 chars	ALL
`country`	KE	ALL
`bank_branch`	SWIFT code (we accept 8 or 11 alphanumeric characters in upper case)	ALL
`bank_account`	Min. length 8 and Max. length 20	ALL
`amount`	Max. 2 decimal numbers	ALL
`currency`	KES or USD	ALL
`purpose`	EPREMT - Remittance (C2C) EPBTOB - Business to Business (B2B)	C2C, B2B
`remitter_full_name`	Max. 200 chars Mandatory only for remittance (C2C)	C2C
`remitter_document`	Max. 45 chars Mandatory only for remittance (C2C)	C2C
`remitter_document_type`	'ID' for national identification number 'PASS' for passport Mandatory only for remittance (C2C)	C2C
`remitter_birth_date`	Format 'YYYYMMDD' Mandatory only for remittance (C2C)	C2C
`remitter_address`	Max. 200 chars Mandatory only for remittance (C2C)	C2C
`remitter_city`	Max. 40 chars Mandatory only for remittance (C2C)	C2C
`remitter_country`	ISO 3166-1 alpha-2 code Mandatory only for remittance (C2C)	C2C
`remitter_nationality`	ISO 3166-1 alpha-2 code Mandatory only for remittance (C2C)	C2C

Example request

{
  "login": "1n234n56",
  "pass": "HolAc123o",
  "external_id": "68907654",
  "beneficiary_name": "Jhon",
  "beneficiary_lastname": "Miles",
  "country": "KE",
  "amount": "100",
  "currency": "KES",
  "bank_branch": "BARCKENX",
  "bank_account": "433212345678",
  "notification_url": "https://thisisawebsite.net/payments",
  "type": "json"
}

Mandatory parameters - Wallet transfers

Mandatory parameter	Description	Flow type
`login`	32 chars	B2C, C2C
`pass`	32 chars	B2C, C2C
`external_id`	Max. 100 chars	B2C, C2C
`beneficiary_name`	Max. 50 chars	B2C, C2C
`beneficiary_lastname`	Max. 50 chars	B2C, C2C
`country`	KE	B2C, C2C
`amount`	Max. 2 decimal numbers	B2C, C2C
`account_type`	Possible options: MPESA, AIRTEL, EQUITEL	B2C, C2C
`phone`	+254 + mobile phone number (9 digits)	B2C, C2C
`currency`	KES	B2C, C2C
`purpose`	EPREMT - Remittance (C2C) Mandatory only for remittance (C2C)	C2C
`remitter_full_name`	Max. 200 chars Mandatory only for remittance (C2C)	C2C
`remitter_document_type`	'ID' for national identification number 'PASS' for passport Mandatory only for remittance (C2C)	C2C
`remitter_document`	Max. 45 chars Mandatory only for remittance (C2C)	C2C
`remitter_birth_date`	Format 'YYYYMMDD' Mandatory only for remittance (C2C)	C2C
`remitter_address`	Max. 200 chars Mandatory only for remittance (C2C)	C2C
`remitter_city`	Max. 40 chars Mandatory only for remittance (C2C)	C2C
`remitter_country`	ISO 3166-1 alpha-2 code Mandatory only for remittance (C2C)	C2C
`remitter_nationality`	ISO 3166-1 alpha-2 code Mandatory only for remittance (C2C)	C2C

Example request

{
  "login": "1n234n56",
  "pass": "HolAc123o",
  "external_id": "68907654",
  "beneficiary_name": "Jhon",
  "beneficiary_lastname": "Miles",
  "country": "KE",
  "amount": "1",
  "currency": "KES",
  "account_type": "MPESA",
  "phone": "+254123456789",
  "notification_url": "https://thisisawebsite.net/payments",
  "type": "json"
}