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

Wallet to Wallet Transfer

Transfer funds between accounts. See below an example of the payload that will be expected by the server.

Wallet Transfer

POST https://sandbox.temboplus.com/tembo/v1/transaction/transfer

Transfers money from one wallet to another

Headers

Name
Type
Description

x-account-id*

string

Partner account id

x-secret-key*

string

Partner secret key

x-request-id*

string

An id identifying this request

Request Body

Name
Type
Description

amount*

number

Amount to be transferred

fromAccountNo*

string

Account number of the wallet from which to transfer money

toAccountNo*

string

Account number of the wallet to which money should be transferred

transactionDate*

date string

The date of the transaction

narration*

string

Narration for this transaction

externalRefNo*

string

A reference number to be associated with this transaction

{
   "paymentRef":"",
   "transactionId":"TEMBO-001",
   "transactionRef":"TEMBO-001"
}

{
    "statusCode": 400,
    "reason": "VALIDATION_ERROR",
    "details": {
        "narration": "narration cannot be empty",
        "transactionDate": "transactionDate is invalid"
    }
}
curl --request POST \
--url https://sandbox.temboplus.com/tembo/v1/transaction/transfer \
--header 'content-type: application/json' \
--header 'x-account-id: ff6IfxxVceIMM6oFAc9Zig' \
--header 'x-secret-key: HYX5X4is3a4bnJJo4lXM936bFD6B8iMeAtXijNvHXMI==' \
--header 'x-request-id: 546d7a200cd8cb45d8ac' \
--data  '{
          "amount":10000,
          "fromAccountNo": "70089773"
          "toAccountNo": "70089004",
          "externalRefNo":"TEMBO-CUSTOMER-004",
          "narration":"Integration Test...",
          "transactionDate":"2022-11-30"
     }'

PreviousWithdraw FundsNextWallet Balance

Last updated 2 years ago