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. Banking & Wallets

Create Wallet

This is the endpoint for creating wallets (accounts)

Create Wallet

POST https://sandbox.temboplus.com/tembo/v1/wallet

Call this endpoint to create a wallet. You should supply KYC information in the request payload as described below. The API returns and .

External reference can optionally be included to associate a wallet with your reference.

Headers

Name
Type
Description

x-account-id*

string

Partner account id

x-secret-key*

string

Partner secret key

x-request-id*

string

A unique id identifying this request

Request Body

Name
Type
Description

firstName*

string

Customer's first name

middleName

string

Customer's middle name

lastName*

string

Customer's last name

dateOfBirth*

string

Date of birth

gender*

string

M or F

idType*

string

Type of the identity document used to open account. Possible values are DRIVER_LICENSE, VOTER_ID, INTL_PASSPORT, NATIONAL_ID

idNumber*

string

Identity document number

issueDate*

string

Issue date of the identity document

expiryDate*

string

Expiry date for the identity document

street*

string

Customer's address: street

city*

string

Customer's address: city

postalCode*

string

Customer's address: postal code

mobileNo*

string

Customers mobile number

email*

string

Customers email address

currencyCode*

string

Account currency. Acceptable values are TZS, KES, USD

externalCustomerRef

string

External customer reference to be associated with this account

{
   "accountNo":"6530000002", // Bank account number
}

Make sure the account id or secret key is valid

{
    "statusCode": 401,
    "reason": "INVALID_CREDENTIALS"
}
{
    "statusCode": 400,
    "reason": "VALIDATION_ERROR",
    "details": {
        "firstName": "firstName is required",
        "dateOfBirth": "Invalid date",
        "address.city": "address.city cannot be empty"
    }
}

Unexpected error occur while communication with bank servers.

{
    "statusCode": 400,
    "reason": "ACCOUNT_EXISTS"
}
curl --request POST \
  --url https://sandbox.temboplus.com/tembo/v1/wallet \
  --header 'content-type: application/json' \
  --header 'x-account-id: ff6IfxxVceIMM6oFAc9Zig' \
  --header 'x-secret-key: HYX5X4is3a4bnJJo4lXM936bFD6B8iMeAtXijNvHXMI==' \
  --header 'x-request-id: 546d7a200cd8cb45d8ac' \
  --data '{
     "firstName": "Manase",
     "middleName": "James",
     "lastName": "Mwina",
     "dateOfBirth": "1985-01-01",
     "gender": "M",
     "identityInfo": {
       "idType": "NATIONAL_ID",
       "idNumber": "1985-1828JD1002",
       "issueDate": "2020-01-01",
       "expiryDate": "2028-01-01"
     },
     "address": {
       "street": "A.H Mwinyi Road",
       "city": "Dar es Salaam",
       "postalCode": "255"
     },
     "mobileNo": "1230008914292",
     "email": "john@email.com",
     "currencyCode": "TZS",
     "externalCustomerRef": "8773663"
  }'

PreviousBanking & WalletsNextDeposit Funds

Last updated 8 months ago