Tembo
  • Welcome!
  • Introduction
  • Reference
    • Merchant Virtual Accounts
      • Create Merchant Virtual Account
      • Get Account Balance
      • Get Account Statement
      • Webhook Callback
    • Banking & Wallets
      • Create Wallet
      • Deposit Funds
      • Withdraw Funds
      • Wallet to Wallet Transfer
      • Wallet Balance
      • Wallet Statement
      • Main Balance
      • Main Statement
      • List Wallets
    • Make Payment
      • Pay to Mobile
      • Pay to Other Banks
      • Utility Payments
      • Payment Status
    • Collect Money
      • Collect from Mobile Money
      • Collection Balance
      • Collection Statement
      • Payment Status
    • eKYC
      • Start Onboarding
      • Retrieve First Question
      • Reply to Question
    • Remittance
      • API Overview
      • Create Remittance
      • Transaction Status
      • Callback Notification
Powered by GitBook
On this page
  1. Reference
  2. eKYC

Retrieve First Question

Use this endpoint to retrieve the first question to verify customer identity using the Q&A method.

Retrieve First Question

POST /onboard/verify

After initiating an onboarding request, you can begin verifying the customer’s identity through a series of Q&A sessions retrieved from the NIDA database. Use this endpoint to retrieve the first question and start the Q&A process.

Headers

Name
Type
Description

authorization*

string

Authorization Bearer token

x-request-id*

string

A unique id identifying this request

Request Body

Name
Type
Description

onboardId*

string

Onboard ID returned after initiating an onboarding session

{
  "id": "2024080211055020554100688170",
  "code": "120",
  "result": {
    "questionCode": "103",
    "nin": "XXXXXXXXXXXXX",
    "questionEnglish": "Mention your mobile number",
    "questionSwahili": "Taja namba ya simu uliyoweka kipindi unasajiliwa"
  }
}

{
    "statusCode": 400,
    "reason": "VALIDATION_ERROR",
    "details": {
        "onboardId": "onboardId cannot be emtpy"
    }
}
curl --request POST \
  --url https://sandbox.temboplus.com/onboard/v1/onboard/verify \
  --header 'content-type: application/json' \
  --header 'authorization: Bearer <your token>' \
  --header 'x-request-id: 546d7a200cd8cb45d8ac' \
  --data '{
	"onboardId": "1JpXezddTbXH"
   }'

PreviousStart OnboardingNextReply to Question

Last updated 8 months ago