---
title: "Cria uma cobrança PIX ou cartão B2B direto"
method: POST
path: "/v1/charges"
tags: ["Charges"]
---

# Cria uma cobrança PIX ou cartão B2B direto

`POST /v1/charges`

## Request

- Base URL: `https://api.sandbox.mupag.com.br`
- URL: `https://api.sandbox.mupag.com.br/v1/charges`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, required

## Request body

- CreateChargeRequest
  - `amount_cents` integer, required
  - `payment_method` 'pix' | 'credit_card', required
  - `installments` integer
  - `card_token` string: Token Asaas obtido pelo lojista fora do checkout público MuPag.
  - `card_token_id` string, uuid
  - `save_card` boolean
  - `customer` union, required
    - ExistingChargeCustomer
      - `id` string, uuid, required
      - `name` string, required
      - `email` string, email, required
      - `tax_id` string, required
    - NewChargeCustomer
      - `name` string, required
      - `email` string, email, required
      - `tax_id` string, required
  - `description` string
  - `soft_descriptor` string: Não suportado pelo PSP Asaas; requisições com valor são rejeitadas.
  - `payer_ip` string: IP literal do pagador, atestado pelo lojista; obrigatório para credit_card.
  - `product_max_installments` integer
  - `external_reference` string
  - `expires_in_seconds` integer
  - `metadata` object
  - `affiliate_code` string
  - `coupon_code` string
  - `split_rules` SplitRuleRequest[]
    - `recipient_id` string, uuid
    - `value_type` string
    - `value_bps` integer
    - `value_cents` integer
  - `is_mit` boolean
  - `initial_mit_reference_id` string, uuid

## Response `201`

Cobrança criada

- ChargeResponse
  - `charge_id` string, uuid, required
  - `status` 'created' | 'pending' | 'authorized' | 'under_review' | 'paid' | 'partially_refunded' | 'refunded' | 'failed' | 'expired' | 'cancelled' | 'disputed' | 'chargeback', required
  - `amount_cents` integer, required
  - `psp_charge_id` string, nullable
  - `card_token_id` string, uuid, nullable
  - `card_brand` string, nullable
  - `card_last4` string, nullable
  - `three_ds_acs_url` string, nullable: Reservado; o fluxo direto atual do Asaas não oferece 3DS exigível.
  - `failure_classification` string, nullable
  - `pix_qr_code_base64` string, nullable
  - `pix_emv_code` string, nullable
  - `expires_at` string, date-time, nullable

## Other responses

- `401`: Falha de autenticação
- `403`: Permissão insuficiente
- `409`: Conflito de idempotência ou estado
- `422`: Erro de validação
- `429`: Limite de requisições excedido
- `502`: Falha em integração externa

---

[API](https://skmtc.dev/mupag/apis/mupag-public-merchant-api.md) · [All operations](https://skmtc.dev/mupag/apis/mupag-public-merchant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mupag/apis/mupag-public-merchant-api/revisions/677904516d2d?raw)