---
title: "Editar método de pagamento"
method: PATCH
path: "/charges/{charge_id}/payment-method"
---

# Editar método de pagamento

`PATCH /charges/{charge_id}/payment-method`

## Path parameters

- `charge_id` string, required

## Request body

- object
  - `update_subscription` string — Indica se o meio de pagamento da assinatura deve ser atualizado
  - `payment_method` string, required — Meio de pagamento. Valores possíveis: **credit_card**, **boleto**, **voucher**, **bank_transfer** ou **safety_pay**
  - `credit_card` object — Dados sobre o pagamento com cartão de crédito (obrigatório caso **payment_method** seja **credit_card**).
    - `operation_type` string — Indica se a transação deve ser capturada "auth_and_capture", autorizada "auth_only", ou pré autorizada "pre_auth".
    - `installments` integer — Quantidade de parcelas. Se a transação for uma recorrência, o número de parcelas deverá ser 1.
    - `statement_descriptor` string — Texto exibido na fatura do cartão. Max: 22 caracteres para clientes Gateway; 13 para clientes PSP
    - `card` object — Cartão de crédito.
      - `number` string, required — Número do cartão. Entre 13 e 19 caracteres
      - `holder_name` string, required — Nome do portador como está impresso no cartão. Máximo de 64 caracteres (Caracteres especiais e números não são aceitos)
      - `holder_document` string — CPF ou CNPJ do portador do cartão. Obrigatório caso o tipo do cartão seja voucher (bandeiras VR ou Pluxee).
      - `exp_month` integer, required — Mês de validade do cartão. Valor entre 1 e 12 (inclusive)
      - `exp_year` integer, required — Ano de validade do cartão. Formatos yy ou yyyy. Ex: 23 ou 2023.
      - `cvv` string — Código de segurança do cartão. O campo aceita 4 ou 3 caracteres, variando por bandeira.
      - `brand` string — (Opcional) Bandeira do cartão. Para cartões de crédito, temos como valores possíveis: Elo, Mastercard, Visa, Amex, ou Hipercard. Para voucher, temos como valores possíveis: Alelo, Ticket, VR ou Pluxee.
      - `label` string — Indica a label do cartão
      - `billing_address_id` string — Código do endereço de cobrança. Max: 36 caracteres.<>Opcional, pode ser utilizado no lugar do billing_address.
      - `billing_address` object
        - `line_1` string — Linha 1 do endereço. (Número, Rua, e Bairro - Nesta ordem e separados por vírgula) Max: 256 caracteres.
        - `line_2` string — Linha 2 do endereço. (Complemento - Andar, Sala, Apto). Max: 128 caracteres.
        - `zip_code` string — CEP. Max: 16 caracteres.
        - `city` string — Cidade. Max: 64 caracteres.
        - `state` string — Código do estado no formato ISO 3166-2.
        - `country` string — Código do país no formato ISO 3166-1 alpha-2.
    - `network_token` object — Token de bandeira.
      - `number` string — Número do Network Token. Entre 13 e 19 caracteres. Ex: 4190000000000069
      - `holder_name` string — Nome do portador como está impresso no cartão. Máximo de 64 caracteres (Caracteres especiais e números não são aceitos)
      - `exp_month` integer — Mês de validade do Network Token. Valor entre 1 e 12 (inclusive)
      - `exp_year` integer — Ano de validade do Network Token. Formatos yy ou yyyy. Ex: 23 ou 2023.
      - `cryptograms` string — Criptograma de autenticação para Network Token. Pode enviar mais de um, caso queira em uma lista de strings. Formato em base64. Ex: ANfQt43bddROAAEnSAMhAAADFA====
    - `card_id` string — identificador do cartão de um cliente.
    - `card_token` string — token do cartão gerado pelo checkout transparente
    - `recurrence_cycle` string — Informa se o pedido é referente a uma recorrência externa. Possíveis valores: `first` ou `subsequent`.
    - `initiated_type` string — Identificador do tipo de transação avulsa. Valores possíveis: `partial_shipment` (Remessa Parcial), `related_or_delayed_charge` (Cobrança Atrasada), `no_show` (Multa) ou `retry` (Retentativa). Valores possíveis: `standing_order` (Ordem Permanente), `instalment` (Parcelamento) ou `subscription` (Assinatura convencional com valor e frequência fixa). [Mais detalhes](https://docs.pagar.me/page/mitcit-transa%C3%A7%C3%B5es-card-on-file-mastercard).
    - `recurrence_model` string — Identificador do tipo de recorrência. Valores possíveis: `standing_order` (Ordem Permanente), `instalment` (Parcelamento) ou `subscription` (Assinatura convencional com valor e frequência fixa). Valores possíveis: `standing_order` (Ordem Permanente), `instalment` (Parcelamento) ou `subscription` (Assinatura convencional com valor e frequência fixa). [Mais detalhes](https://docs.pagar.me/page/mitcit-transa%C3%A7%C3%B5es-card-on-file-mastercard).
    - `payment_origin` object — Identificador da primeira cobrança de uma recorrência. [Mais detalhes](https://docs.pagar.me/docs/api-v5-identificador-de-recorr%C3%AAncia-para-assinaturas-externas).
      - `charge_id` string — Identificador da cobrança
      - `brand_id` string — Identificador da bandeira
  - `voucher` object — Dados sobre o pagamento com voucher (obrigatório caso **payment_method** seja **voucher**)
    - `statement_descriptor` string — Texto exibido na fatura do cartão. Max: 22 caracteres.
    - `card` object — Cartão voucher.
      - `number` string, required — Número do cartão. Entre 13 e 19 caracteres
      - `holder_name` string, required — Nome do portador como está impresso no cartão. Máximo de 64 caracteres (Caracteres especiais e números não são aceitos)
      - `holder_document` string — CPF ou CNPJ do portador do cartão. Obrigatório caso o tipo do cartão seja voucher (bandeiras VR ou Pluxee).
      - `exp_month` integer, required — Mês de validade do cartão. Valor entre 1 e 12 (inclusive)
      - `exp_year` integer, required — Ano de validade do cartão. Formatos yy ou yyyy. Ex: 23 ou 2023.
      - `cvv` string — Código de segurança do cartão. O campo aceita 4 ou 3 caracteres, variando por bandeira.
      - `brand` string — (Opcional) Bandeira do cartão. Para cartões de crédito, temos como valores possíveis: Elo, Mastercard, Visa, Amex, ou Hipercard. Para voucher, temos como valores possíveis: Alelo, Ticket, VR ou Pluxee.
      - `label` string — Indica a label do cartão
      - `billing_address_id` string — Código do endereço de cobrança. Max: 36 caracteres.<>Opcional, pode ser utilizado no lugar do billing_address.
      - `billing_address` object
        - `line_1` string — Linha 1 do endereço. (Número, Rua, e Bairro - Nesta ordem e separados por vírgula) Max: 256 caracteres.
        - `line_2` string — Linha 2 do endereço. (Complemento - Andar, Sala, Apto). Max: 128 caracteres.
        - `zip_code` string — CEP. Max: 16 caracteres.
        - `city` string — Cidade. Max: 64 caracteres.
        - `state` string — Código do estado no formato ISO 3166-2.
        - `country` string — Código do país no formato ISO 3166-1 alpha-2.
    - `card_id` string — identificador do cartão de um cliente
    - `card_token` string — token do cartão gerado pelo checkout transparente
    - `card.holder_document` string — Número do documento do portador do cartão. Este campo deverá ser enviado dentro do objeto card e é obrigatório para voucher.
  - `boleto` object — Dados sobre o pagamento com boleto (obrigatório caso **payment_method** seja **boleto**).
    - `bank` string — Código do banco. 001 (Banco do Brasil); 033 (Santander); 237 (Bradesco); 341 (Itau); 745 (Citibank) e 104 (Caixa Econômica Federal).
    - `instructions` string — Instruções do boleto. Max: 256 caracteres.
    - `due_at` string — Data de vencimento. (Opcional)
    - `nosso_numero` string — Número que identifica unicamente um boleto para uma conta.
    - `type` string — Tipo de espécie do boleto.DM (Duplicata Mercantil) e BDP (Boleto de proposta)
    - `document_number` string — Identificador do boleto. Max: 16 caracteres.
    - `interest` object — Aplicação do juros sobre o boleto.
      - `days` integer, required — Dias após a expiração do boleto quando o juros deve ser cobrado.
      - `type` string, required — Tipo de divisão. Os valores possíveis são flat ou percentage.
      - `amount` string, required — Valor em porcentagem ou em centavos da taxa de juros que será cobrada ao mês.
    - `fine` object — Aplicação da multa sobre o boleto.
      - `days` integer, required — Dias após a expiração do boleto quando a multa deve ser cobrada.
      - `type` string, required — Tipo de divisão. Os valores possíveis são flat ou percentage.
      - `amount` integer, required — Valor em porcentagem ou em centavos que será cobrada na multa.
    - `discount` object — Objeto raiz de desconto por antecipação. Exclusivo PSP.
      - `type` string — Tipo do desconto: "percentage" (% sobre o total) ou "flat" (centavos). Aplica-se a todas as regras do array.
      - `rules` object[] — Lista de regras de desconto ordenadas por limit_date crescente.
        - `limit_date` string — Data limite da regra. Formato YYYY-MM-DD. Deve ser anterior ao due_at do boleto.
        - `amount` integer — Valor do desconto. Se type: percentage: entre 0.01 e 100 (ex: 15.00 = 15%). Se type: flat: inteiro em centavos, mín. 1 (ex: 500 = R$5,00).
  - `bank_transfer` object — Dados sobre o pagamento com transferência entre contas bancárias. (obrigatório caso **payment_method** seja **bank_transfer**).
    - `bank` string — Código do Banco. 001 (Banco do Brasil); 237 (Bradesco) e 341 (Itau).
  - `Pix` object — Dados sobre o pagamento com Pix (obrigatório caso **payment_method** seja **Pix**).
    - `expires_in` integer — Data de expiração do Pix em segundos.
    - `expires_at` string, date — Data de expiração do Pix. (Opcional | Mandatório caso não enviado o expires_in) [Formato: YYYY-MM-DDThh:mm:ss] UTC
    - `additional_information` object — Objeto chave/valor utilizado para adicionar informações sobre o pagamento. Esses dados serão visíveis para o consumidor na hora do pagamento.
      - `Name` string — Nome utilizado para adicionar informações sobre o pagamento.
      - `Value` string — Valor utilizado para adicionar informações sobre o pagamento.
  - `reuse_split` boolean — Informa se vamos repassar as regras de split para proxima transação

## 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
    - `delinquent` boolean
    - `created_at` string
    - `updated_at` string
    - `phones` object
  - `last_transaction` object
    - `id` string
    - `transaction_type` string
    - `gateway_id` string
    - `amount` integer
    - `status` string
    - `success` boolean
    - `url` string
    - `pdf` string
    - `line` string
    - `barcode` string
    - `qr_code` string
    - `nosso_numero` string
    - `bank` string
    - `document_number` string
    - `instructions` string
    - `due_at` string
    - `created_at` string
    - `updated_at` string
    - `gateway_response` object
      - `code` string
  - `metadata` object
    - `code` string

## Other responses

- `412` — 412

---

[API](https://skmtc.net/pagar/apis/pagarme-api.md) · [All operations](https://skmtc.net/pagar/apis/pagarme-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagar/pagarme-api/versions/dababf062743/schema)