> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.littglobal.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.littglobal.com/_mcp/server. # Add Wallet Balance POST TBD/api/v2/users/add-wallet-balance Content-Type: application/json This API endpoint lets a partner add dollars to a member's wallet balance, for example when the member converts points held by the partner. It is called server to server: it is restricted to the partner's IP addresses and does not use a user API token. Sending the same `transaction_reference` again returns the original load and does not add the amount twice, so retries are safe. Use this to recover a load whose outcome is unknown, for example after a timeout. ### Request Body - `user_id` (string): The member's user ID. - `transaction_reference` (string): The partner's unique reference for this load (max 255 characters). - `amount` (number): The amount to add in the member's currency (minimum 0.01). - `description` (string, optional): Shown in the member's wallet history (max 255 characters). ### Response The wallet transaction. The fields a partner needs: - `transaction_id` (string): The ID of the wallet transaction. - `to` (string): The member's user ID. - `amount` (string): The amount added. - `transaction_type` (string): `29` (Partner wallet load). - `description` (string): The description sent in the request. - `external_transaction_reference` (string): The reference sent in the request. - `created_at` (string): When the wallet was loaded. `status` is `error`, with a `message` explaining why, when the request is invalid, the `user_id` does not exist, or the load would take the wallet balance above A$1,000. Nothing is loaded in any of these cases. Reference: https://docs.littglobal.com/litt-white-label/api-reference/digital-wallet/add-wallet-balance ## Request ### Body (application/json) This endpoint expects an object. - `api` (string, optional) - `data` (ApiV2UsersAddWalletBalancePostRequestBodyContentApplicationJsonSchemaData, optional) ## Response ### 200 Add Wallet Balance - `message` (string, optional) - `api` (string, optional) - `status` (string, optional) - `data` (ApiV2UsersAddWalletBalancePostResponsesContentApplicationJsonSchemaData, optional) ## Types ### ApiV2UsersAddWalletBalancePostRequestBodyContentApplicationJsonSchemaData - `user_id` (string, optional) - `transaction_reference` (string, optional) - `amount` (integer, optional) - `description` (string, optional) ### ApiV2UsersAddWalletBalancePostResponsesContentApplicationJsonSchemaData - `transaction_id` (string, optional) - `from` (string, optional) - `to` (string, optional) - `amount` (string, optional) - `invoice_id` (any, optional, nullable) - `currency_id` (integer, optional) - `exchange_rate` (double, optional) - `original_amount` (string, optional) - `original_currency_id` (integer, optional) - `original_exchange_rate` (double, optional) - `commission_percentage` (any, optional, nullable) - `commission` (any, optional, nullable) - `commission_discount` (any, optional, nullable) - `net` (any, optional, nullable) - `loyalty_percentage` (any, optional, nullable) - `loyalty_min_transaction` (string, optional) - `loyalty_max_cashback` (string, optional) - `loyalty_cashback_status` (integer, optional) - `promotion` (any, optional, nullable) - `related_transaction_id` (any, optional, nullable) - `disbursement_id` (any, optional, nullable) - `transaction_type` (string, optional) - `description` (string, optional) - `external_request` (string, optional) - `external_transaction_reference` (string, optional) - `created_at` (datetime, optional) - `updated_at` (datetime, optional) ## Examples **Request** ```json { "api": "add-wallet-balance", "data": { "user_id": "2ef350a0-f8cd-4730-8e29-9b5fc5db0ada", "transaction_reference": "PARTNER-LOAD-123", "amount": 10, "description": "Points redemption" } } ``` **Response** ```json { "message": "Success", "api": "add-wallet-balance", "status": "success", "data": { "transaction_id": "2009f771-dd56-45b9-8de6-fdec8ddc5e23", "from": "Partner", "to": "2ef350a0-f8cd-4730-8e29-9b5fc5db0ada", "amount": "10.00", "invoice_id": null, "currency_id": 1, "exchange_rate": 1.000001, "original_amount": "10.00", "original_currency_id": 1, "original_exchange_rate": 1.000001, "commission_percentage": null, "commission": null, "commission_discount": null, "net": null, "loyalty_percentage": null, "loyalty_min_transaction": "0.00", "loyalty_max_cashback": "0.00", "loyalty_cashback_status": 1, "promotion": null, "related_transaction_id": null, "disbursement_id": null, "transaction_type": "29", "description": "Points redemption", "external_request": "{\"api\":\"add-wallet-balance\",\"data\":{\"user_id\":\"2ef350a0-f8cd-4730-8e29-9b5fc5db0ada\",\"transaction_reference\":\"PARTNER-LOAD-123\",\"amount\":10,\"description\":\"Points redemption\"}}", "external_transaction_reference": "PARTNER-LOAD-123", "created_at": "2026-11-03T01:15:13.000000Z", "updated_at": "2026-11-03T01:15:13.000000Z" } } ``` **SDK Code** ```python Digital Wallet_addWalletBalance_example import requests url = "https://tbd/api/v2/users/add-wallet-balance" payload = { "api": "add-wallet-balance", "data": { "user_id": "2ef350a0-f8cd-4730-8e29-9b5fc5db0ada", "transaction_reference": "PARTNER-LOAD-123", "amount": 10, "description": "Points redemption" } } headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Digital Wallet_addWalletBalance_example const url = 'https://tbd/api/v2/users/add-wallet-balance'; const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"api":"add-wallet-balance","data":{"user_id":"2ef350a0-f8cd-4730-8e29-9b5fc5db0ada","transaction_reference":"PARTNER-LOAD-123","amount":10,"description":"Points redemption"}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Digital Wallet_addWalletBalance_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://tbd/api/v2/users/add-wallet-balance" payload := strings.NewReader("{\n \"api\": \"add-wallet-balance\",\n \"data\": {\n \"user_id\": \"2ef350a0-f8cd-4730-8e29-9b5fc5db0ada\",\n \"transaction_reference\": \"PARTNER-LOAD-123\",\n \"amount\": 10,\n \"description\": \"Points redemption\"\n }\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Digital Wallet_addWalletBalance_example require 'uri' require 'net/http' url = URI("https://tbd/api/v2/users/add-wallet-balance") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Content-Type"] = 'application/json' request.body = "{\n \"api\": \"add-wallet-balance\",\n \"data\": {\n \"user_id\": \"2ef350a0-f8cd-4730-8e29-9b5fc5db0ada\",\n \"transaction_reference\": \"PARTNER-LOAD-123\",\n \"amount\": 10,\n \"description\": \"Points redemption\"\n }\n}" response = http.request(request) puts response.read_body ``` ```java Digital Wallet_addWalletBalance_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://tbd/api/v2/users/add-wallet-balance") .header("Content-Type", "application/json") .body("{\n \"api\": \"add-wallet-balance\",\n \"data\": {\n \"user_id\": \"2ef350a0-f8cd-4730-8e29-9b5fc5db0ada\",\n \"transaction_reference\": \"PARTNER-LOAD-123\",\n \"amount\": 10,\n \"description\": \"Points redemption\"\n }\n}") .asString(); ``` ```php Digital Wallet_addWalletBalance_example request('POST', 'https://tbd/api/v2/users/add-wallet-balance', [ 'body' => '{ "api": "add-wallet-balance", "data": { "user_id": "2ef350a0-f8cd-4730-8e29-9b5fc5db0ada", "transaction_reference": "PARTNER-LOAD-123", "amount": 10, "description": "Points redemption" } }', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Digital Wallet_addWalletBalance_example using RestSharp; var client = new RestClient("https://tbd/api/v2/users/add-wallet-balance"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"api\": \"add-wallet-balance\",\n \"data\": {\n \"user_id\": \"2ef350a0-f8cd-4730-8e29-9b5fc5db0ada\",\n \"transaction_reference\": \"PARTNER-LOAD-123\",\n \"amount\": 10,\n \"description\": \"Points redemption\"\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Digital Wallet_addWalletBalance_example import Foundation let headers = ["Content-Type": "application/json"] let parameters = [ "api": "add-wallet-balance", "data": [ "user_id": "2ef350a0-f8cd-4730-8e29-9b5fc5db0ada", "transaction_reference": "PARTNER-LOAD-123", "amount": 10, "description": "Points redemption" ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://tbd/api/v2/users/add-wallet-balance")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```