Transfers

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

200 Transfer was successful

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

401 Permission denied

400: Bad Request Validation error

{
    "statusCode": 400,
    "reason": "VALIDATION_ERROR",
    "details": {
        "narration": "narration cannot be empty",
        "transactionDate": "transactionDate is invalid"
    }
}

Curl

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"
     }'