---
title: "Inserir saldo na carteira do usuário"
method: POST
path: "/api/v2/me/balance"
---

# Inserir saldo na carteira do usuário

`POST /api/v2/me/balance`

## Request

- Base URL: `https://sandbox.melhorenvio.com.br`
- URL: `https://sandbox.melhorenvio.com.br/api/v2/me/balance`
- Auth: none required
- TypeScript: <https://skmtc.dev/melhorenvio/apis/api-melhor-envio-sandbox/docs/api/v2/me/balance/post.ts> (a function with typed inputs; its response is checked against the schema)

## Headers

- `Accept` string, required
- `Content-Type` string, required
- `Authorization` string, required
- `User-Agent` string, required

## Request body

- object
  - `gateway` string, required: Ex: yapay-transparente
  - `value` string, required: Valor. Ex: 10.50
  - `slug` string, required: Ex: pix | boleto
  - `redirect_url` string: https://seuenderecoderetorno.me
  - `finger_print` string: Finger Print
  - `company_name` string: Nome Empresa
  - `cnpj` string: CNPJ Empresa

## Response `200`

200

- object
  - `payment` object
    - `id` string
    - `protocol` string
    - `value` integer
    - `status` string
    - `redirect` string
    - `response` unknown
    - `authorized_at` unknown
    - `unauthorized_at` unknown
    - `canceled_at` unknown
    - `chargeback_at` unknown
    - `created_at` string
    - `updated_at` string
    - `link` unknown
    - `payment_gateway_id` unknown
    - `gateway` object
      - `id` integer
      - `slug` string
      - `name` string
      - `status` string
      - `min_value` integer
      - `picture` string
      - `website` string
    - `method` unknown
    - `transaction` object
      - `id` string
      - `protocol` string
      - `value` integer
      - `type` string
      - `status` string
      - `description` unknown
      - `authorized_at` unknown
      - `unauthorized_at` unknown
      - `reserved_at` unknown
      - `canceled_at` unknown
      - `created_at` string
      - `description_internal` unknown
      - `reason` object
        - `id` integer
        - `label` string
        - `description` string
    - `user` object
      - `id` string
      - `protocol` integer
      - `firstname` string
      - `lastname` string
      - `email` string
      - `picture` unknown
      - `thumbnail` unknown
      - `document` string
      - `birthdate` string
      - `email_confirmed_at` string
      - `email_alternative` unknown
      - `access_at` string
      - `created_at` string
      - `updated_at` string
  - `redirect` string
  - `message` string
  - `digitable` unknown

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/melhorenvio/apis/api-melhor-envio-sandbox.md) - [All operations](https://skmtc.dev/melhorenvio/apis/api-melhor-envio-sandbox/llms.txt) - [OpenAPI document](https://skmtc.dev/melhorenvio/apis/api-melhor-envio-sandbox/revisions/ffbe3939fc36?raw)