Verify a customer by phone number

POST 
https://core-prod.malipopay.co.tz/api/v1/customer/verify

Verifies a customer's existence and identity by phone number

Request

application/json

Body

Bodyrequired

phoneNumberstringrequired
Customer's mobile phone number in international format
Example: 255742200105
firstnamestringrequired
Customer's first name
Example: John
lastnamestringrequired
Customer's last name
Example: Doe
emailemail
Customer's email address
Example: john.doe@example.com
typestring
Customer type (e.g., INDIVIDUAL, BUSINESS)
Example: INDIVIDUAL
address object
streetstring
Example: Morogoro Road
citystring
Example: Dar es Salaam
countrystring
Example: Tanzania

Example (auto)

{
  "phoneNumber": "255742200105",
  "firstname": "John",
  "lastname": "Doe",
  "email": "john.doe@example.com",
  "type": "INDIVIDUAL",
  "address": {
    "street": "Morogoro Road",
    "city": "Dar es Salaam",
    "country": "Tanzania"
  }
}

Responses

200

Customer verified successfully

application/json

Schema

Schema

_idstring
Unique identifier for the customer
Example: 6281559426fa29659c5ac38a
phoneNumberstring
Example: 255742200105
firstnamestring
Example: John
lastnamestring
Example: Doe
emailemail
Example: john.doe@example.com
typestring
Example: INDIVIDUAL
projectstring
Project ID this customer belongs to
Example: 63db68a6c5f3e7682e23c2ca
deletedboolean
Example: false
createdAtdate-time
Example: 2023-02-02T07:39:18.979Z
updatedAtdate-time
Example: 2023-02-02T07:39:24.934Z

Example (auto)

{
  "_id": "6281559426fa29659c5ac38a",
  "phoneNumber": "255742200105",
  "firstname": "John",
  "lastname": "Doe",
  "email": "john.doe@example.com",
  "type": "INDIVIDUAL",
  "project": "63db68a6c5f3e7682e23c2ca",
  "deleted": false,
  "createdAt": "2023-02-02T07:39:18.979Z",
  "updatedAt": "2023-02-02T07:39:24.934Z"
}

400

Phone number not found

application/json

Schema

Schema

codeint32required
messagestringrequired

Example (auto)

{
  "code": 0,
  "message": "string"
}

500

Internal server error

application/json

Schema

Schema

codeint32required
messagestringrequired

Example (auto)

{
  "code": 0,
  "message": "string"
}

Authorization: apiToken

name: apiTokentype: apiKeyin: headerdescription: Project API key. Get yours from the Malipopay dashboard under Settings → API Keys.

• curl
• python
• nodejs
• php
• java
• go

• CURL

curl -L 'https://core-prod.malipopay.co.tz/api/v1/customer/verify' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'apiToken: <apiToken>' \
--data-raw '{
  "phoneNumber": "255742200105",
  "firstname": "John",
  "lastname": "Doe",
  "email": "john.doe@example.com",
  "type": "INDIVIDUAL",
  "address": {
    "street": "Morogoro Road",
    "city": "Dar es Salaam",
    "country": "Tanzania"
  }
}'

Request

Base URL

https://core-prod.malipopay.co.tz

Auth

apiToken

Body required

{
  "phoneNumber": "255742200105",
  "firstname": "John",
  "lastname": "Doe",
  "email": "john.doe@example.com",
  "type": "INDIVIDUAL",
  "address": {
    "street": "Morogoro Road",
    "city": "Dar es Salaam",
    "country": "Tanzania"
  }
}

Response

Click the Send API Request button above and see the response here!