# Create a wallet funding invoice > Create a wallet funding invoice: TrueProxies customer API reference with the required scope, parameters, responses and code samples. Source: https://docs.trueproxies.com/api/operations/post_v1_wallet_topups/ `POST /v1/wallet/topups` **Fetch** ```js const url = 'https://api.trueproxies.com/v1/wallet/topups'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"amount_cents":1}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` **cURL** ```sh curl --request POST \ --url https://api.trueproxies.com/v1/wallet/topups \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "amount_cents": 1 }' ``` Resellers only. Creates an unpaid invoice; does not add funds until the payment settles. No on-behalf access. Uses normal provider checkout. ## Authorizations - **[customerAPIKey](https://docs.trueproxies.com/api/#customerapikey)** ## Parameters ### Header Parameters - **Idempotency-Key** string <= 200 characters Makes a retry safe. The first request carrying a given key is executed and its response recorded; repeating the same request with the same key replays that response, with Idempotency-Replayed: true, rather than buying or paying a second time. Reusing a key for a different request is refused with 409, as is a repeat that arrives while the first is still running. Keys are scoped to your account and to the endpoint. Successful and uncertain invoice commands are retained so that an old retry cannot create another invoice. Completed definite rejections are kept for at least 24 hours; after that, the same key may be evaluated again. ## Request Body (required) Media type: `application/json` object - **amount\_cents** required Amount in USD cents. Also limited by daily\_remaining\_cents returned by GET /v1/wallet; unpaid funding invoices count toward that rolling limit. integer \>= 1000 <= 1000000 ##### Example (generated) ```json { "amount_cents": 1 } ``` ## Responses ### 201 Success Media type: `application/json` object - **activated\_at** When this invoice’s service activation, top-up, renewal, or charge-only processing committed. Payment receipt and an already-active service do not establish this outcome. string format: date-time - **activation\_failed\_at** Automatic fulfillment stopped and needs operator attention. Payment remains received; this does not mean a refund completed or previously purchased service was revoked. string format: date-time - **amount\_cents** required integer - **bill\_to** Who the invoice is issued to, copied from the account’s billing details when the invoice was created. Absent when the account had no billing details then; saving details later does not change it. object - **address** string - **company** string - **country** string - **name** string - **vat\_id** string - **created\_at** required string format: date-time - **currency** required string - **discount\_bp** integer - **display\_name** required string - **due\_at** required string format: date-time - **expired** True when a cancelled invoice closed because it was not paid by due\_at. Invoices cancelled before this field existed report false. boolean - **id** required Internal API identifier. Use reference for customer-facing display. string format: uuid - **kind** required string Allowed values: wallet\_topup purchase renewal topup custom white\_label - **list\_amount\_cents** integer - **offer\_key** required string - **options** object - **city** string - **gb** GB for top-ups; taken from the offer otherwise integer - **paid\_at** string format: date-time - **payments** required Array\