Wallet to Wallet Transfer

Use this endpoint to transfer funds between your disbursement wallets. Both wallets must be in the same currency.

Endpoint

POST /transaction/transfer-local

Request

Headers

  • Content-Type* — Must be application/json

  • x-account-id* — Your unique TemboPlus account identifier

  • x-secret-key* — Your TemboPlus API secret key

  • x-request-id* — Unique UUID per request for tracing

Body Parameters

  • amount* (number) — Amount to transfer. Must be a positive integer.

  • from* (string) — Account number of the source disbursement wallet.

  • to* (string) — Account number of the destination disbursement wallet.

  • description* (string) — A short description of the transfer. Appears in both wallet statements.

Example Request Payload


Responses

chevron-right200 OKhashtag

Transfer completed successfully.

Response Format

chevron-right400 BAD REQUESThashtag

Returned when the request payload is missing required fields or contains invalid data.

Response Format

Fields inside details are optional and vary depending on the specific validation failure.


Common Validation Errors to Avoid

  • Ensure all required fields are included in the request body in the right format.

  • x-request-id must be included in the request headers.

chevron-right401 UNAUTHORIZEDhashtag

Returned when authentication headers are missing or invalid.

Response Format:

chevron-right404 NOT FOUNDhashtag

Returned when the source or destination wallet account number does not exist or is not accessible with your credentials.

Response Format


Common Validation Errors to Avoid

  • Ensure the account number passed in the request payload is a valid account

chevron-right500 INTERNAL SERVER ERRORhashtag

Indicates a temporary issue within TemboPlus. Retry later or contact TemboPlus Support with your x-request-id.

Response Format:

Last updated