# Desativar um método de pagamento

Desativar um método de pagamento específico.

> 📘 Informações
>
> Você só pode desativar um método de pagamento quando o status estiver no estado active e não houver solicitações de pagamento pendentes (paymentRequest.status = processing).

Endpoint: POST /payment_methods/{paymentMethodId}/deactivate
Version: 1.0.0
Security: ApiKeyAuth, ApiKeySecret

## Path parameters:

  - `paymentMethodId` (string, required)
    O identificador único criado pela Belvo usado para referenciar o método de pagamento.
    Example: "d5f2e1a8-f449-4338-bd6a-df62b3fbf0b3"

## Response 201 fields (application/json):

  - `id` (string)
    O identificador único criado pela Belvo usado para referenciar o método de pagamento.
    Example: "3118128a-6792-4b06-bd61-4acf6f6ad6b5"

  - `createdDate` (string,null)
    O timestamp ISO-8601 quando o cliente foi criado no banco de dados da Belvo.
    Example: "2022-02-09T08:45:50.406032Z"

  - `lastUpdatedDate` (string,null)
    O carimbo de data e hora ISO-8601 quando as informações sobre o cliente foram atualizadas pela última vez.
    Example: "2022-02-09T08:45:50.406032Z"

  - `status` (string)
    O status do método de pagamento pode ser:

- pending_agreement_acceptance
  O método precisa ser aceito pelo proprietário da conta bancária. Isso pode ser feito enviando um Link de Configuração para o proprietário ou utilizando nosso recurso de API de Acordos.
  
- waiting_for_activation_response
  O proprietário aceitou o método de pagamento. Os arquivos de registro e cobrança foram gerados.
  A instituição financeira agora precisa enviar uma resposta sobre as informações da conta bancária (OK ou Não OK).
  
- active
  A instituição financeira confirmou com sucesso o registro da conta bancária. O método de pagamento agora pode ser usado para solicitações de pagamento.
  Nota: O status pode mudar para inactive se o proprietário cancelar ou remover o método de pagamento na instituição financeira.
  
- error
  A instituição financeira não conseguiu confirmar o registro da conta bancária (geralmente devido ao proprietário fornecer informações incorretas da conta bancária ou um erro na instituição financeira).
  
- inactive
  O método de pagamento não pode ser usado. Isso geralmente ocorre quando o proprietário cancela sua conta e a instituição financeira nos informa que o método não é mais válido.
    Enum: "pending_agreement_acceptance", "waiting_for_activation_response", "active", "error", "inactive"

  - `type` (string)
    O tipo de conta. Para o México, esse valor é definido como bank_account.
    Enum: "bank_account"

  - `customer` (object)
    Detalhes sobre o cliente associado ao método de pagamento.

  - `customer.id` (string)
    O identificador único criado pela Belvo usado para referenciar o cliente atual.
    Example: "3118128a-6792-4b06-bd61-4acf6f6ad6b5"

  - `customer.firstname` (string)
    O primeiro nome do cliente.
    Example: "Carlos"

  - `customer.lastname` (string)
    O sobrenome do cliente.
    Example: "Vives"

  - `customer.email` (string)
    O email do cliente.
    Example: "carlos-vives@musica.mx"

  - `customer.phone` (string)
    O número de telefone do cliente (incluindo o código do país).
    Example: "+523001234567"

  - `details` (object)
    Detalhes sobre a conta bancária associada ao método de pagamento.

  - `details.accountNumber` (string)
    O número da conta bancária.
    Example: "445566790"

  - `details.accountType` (string)
    O tipo de conta bancária. Pode ser:
  - savings
  - checking
  - debit_card
    Enum: "savings", "checking", "debit_card"

  - `details.bank` (string)
    O nome do banco mexicano onde a conta está mantida.

Para uma lista completa de instituições, consulte nossa página dedicada de Instituições de Pagamento.

## Response 400 fields (application/json):

  - `statusCode` (integer)
    O código de status HTTP para este erro.
    Example: 400

  - `error` (string)
    A descrição do código de status HTTP para este erro.
    Example: "Bad Request"

  - `message` (any)
    Uma breve descrição do erro, indicando o que está errado com a solicitação.
> Nota: Retornamos uma string ou um array de strings, dependendo do(s) erro(s) de validação.

A descrição pode ser (entre outras):

  - id must be a UUID
  - Not enough balance
  - amount is not a valid decimal number.
  - currency must be one of the following values: cop, mxn, usd
  - reference must be a string
  - Customer not found for merchant
  - documentType is a required field
    Example: "id must be a UUID"

## Response 401 fields (application/json):

  - `statusCode` (integer)
    O código de status HTTP para este erro.
    Example: 401

  - `error` (string)
    A descrição do código de status HTTP para este erro.
    Example: "Unauthorized"

  - `message` (string)
    Uma breve descrição do erro, indicando o que está errado com a solicitação. No caso de um erro 401 Unauthorized, a mensagem é:

  - Unauthorized credentials
    Example: "Unauthorized credentials"

## Response 404 fields (application/json):

  - `statusCode` (integer)
    O código de status HTTP para este erro.
    Example: 404

  - `error` (string)
    A descrição do código de status HTTP para este erro.
    Example: "Not Found"

  - `message` (string)
    Uma breve descrição do erro, indicando o que está errado com a solicitação. A descrição pode ser (entre outras):

  - Payout Target not found
  - Payment method not found
  - Customer not found
    Example: "Payout Target not found"