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

{
    "amount": 50000,
    "from": "9000123456",
    "to": "8000654321",
    "description": "Move funds to payout wallet"
}

---

Responses

200 OK

Transfer completed successfully.

Response Format

{
    "transactionId": "hnZDA7QSQ8qS", // Unique identifier for this transfer, generated by TemboPlus
    "from": "9000123456",
    "to": "8000654321",
    "transactionDate": "2026-03-23T09:31:52+03:00",
    "narration": "Move funds to payout wallet", // Echo of your description
    "amount": 50000,
    "transactionRef": "HFsoXk2llnfE" // Reference generated by TemboPlus for this transfer
}

400 BAD REQUEST

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

Response Format

{
    "statusCode": 400,
    "reason": "VALIDATION_ERROR",
    "details": {
        "from": "\"from\" must be a string",
        "to": "\"to\" must be a string"
    }
}

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.

401 UNAUTHORIZED

Returned when authentication headers are missing or invalid.

Response Format:

{
    "statusCode": 401,
    "reason": "INVALID_CREDENTIALS",
    "details": {}
}

404 NOT FOUND

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

Response Format

{
    "statusCode": 404,
    "reason": "NOT_FOUND",
    "details": {}
}

---

Common Validation Errors to Avoid

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

500 INTERNAL SERVER ERROR

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

Response Format:

{
    "statusCode": 500,
    "reason": "SERVER_ERROR"
}