Withdraw Funds

Withdraw funds from wallet to your main account

Withdraw Funds

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

Transfers money from a wallet to your main account.

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
amount*	number	Amount to be deposited to a wallet
accountNo*	string	Account number of the wallet to withdraw from
transactionDate*	date string	The date of the transaction in the YYYY-MM-DD format
narration*	string	Narration for this transaction
externalRef*	string	External reference to be associated with this transaction

200 Transfer was successful

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

401: Unauthorized Unauthorized request

400: Bad Request Validation error

{
    "statusCode": 400,
    "reason": "VALIDATION_ERROR",
    "details": {
        "walletId": "walletId is required",
        "amount": "amount must be greater than zero"
    }
}

Curl

curl --request POST \
  --url https://sandbox.temboplus.com/tembo/v1/transaction/withdraw \
  --header 'content-type: application/json' \
  --header 'x-account-id: ff6IfxxVceIMM6oFAc9Zig' \
  --header 'x-secret-key: HYX5X4is3a4bnJJo4lXM936bFD6B8iMeAtXijNvHXMI==' \
  --header 'x-request-id: 546d7a200cd8cb45d8ac' \
  --data  '{
     "amount": 1000,
     "accountNo": "70089773",
     "externalRef": "TEMBO-CUSTOMER-003",
     "narration": "Withdrawing for purchase: PJ9383",
     "transactionDate": "2022-11-30"
  }'