---
title: "Criar cobrança"
method: POST
path: "/charges."
---

# Criar cobrança

`POST /charges.`

## Request

- Base URL: `https://api.pagar.me/core/v5`
- URL: `https://api.pagar.me/core/v5/charges.`
- Auth: HTTP basic

## Request body

- object
  - `code` string: Código identificador da cobrança no sistema da loja.
  - `amount` integer, required: Valor da cobrança em centavos
  - `currency` string: Moeda. Valores possíveis: **BRL**, **ARS**, **BOB**, **CLP**, **COP **, **MXN**, **PYG**, **USD **, **UYU** e **EUR**.
  - `payment` object, required: Dados sobre o pagamento. [Saiba mais sobre pagamentos](https://docs.mundipagg.com/v1/reference#pagamento-overview)
  - `customer_id` string, required: Código do cliente.
  - `customer` object, required: Dados do cliente. **Obrigatório** caso o customer_id não seja informado. [Saiba mais sobre clientes](https://docs.mundipagg.com/v1/reference#clientes).
  - `metadata` string: Objeto chave/valor utilizado para armazenar informações adicionais sobre a cobrança. [Saiba mais sobre metadata](https://docs.mundipagg.com/v1/reference#metadata).

## Response `200`

200

- object
  - `id` string
  - `code` string
  - `gateway_id` string
  - `amount` integer
  - `status` string
  - `currency` string
  - `payment_method` string
  - `created_at` string
  - `updated_at` string
  - `customer` object
    - `id` string
    - `name` string
    - `email` string
    - `document` string
    - `type` string
    - `delinquent` boolean
    - `created_at` string
    - `updated_at` string
    - `phones` object
      - `home_phone` object
        - `country_code` string
        - `number` string
        - `area_code` string
      - `mobile_phone` object
        - `country_code` string
        - `number` string
        - `area_code` string
    - `metadata` object
      - `company` string
  - `last_transaction` object
    - `id` string
    - `transaction_type` string
    - `gateway_id` string
    - `amount` integer
    - `status` string
    - `success` boolean
    - `installments` integer
    - `statement_descriptor` string
    - `acquirer_name` string
    - `acquirer_affiliation_code` string
    - `acquirer_tid` string
    - `acquirer_nsu` string
    - `acquirer_auth_code` string
    - `acquirer_message` string
    - `acquirer_return_code` string
    - `operation_type` string
    - `card` object
      - `id` string
      - `first_six_digits` string
      - `last_four_digits` string
      - `brand` string
      - `holder_name` string
      - `exp_month` integer
      - `exp_year` integer
      - `status` string
      - `created_at` string
      - `updated_at` string
      - `type` string
    - `created_at` string
    - `updated_at` string
    - `gateway_response` object
      - `code` string
  - `metadata` object
    - `code` string

## Other responses

- `422`: 422

## Changes

- **2026-11-03** `ef323290c0ff`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pagar/apis/pagarme-api/changes/charges./post.md)

---

[API](https://skmtc.dev/pagar/apis/pagarme-api.md) - [All operations](https://skmtc.dev/pagar/apis/pagarme-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pagar/apis/pagarme-api/revisions/ef323290c0ff?raw)