# Criar um método de pagamento

Criar um novo método de pagamento para um cliente

Endpoint: POST /payment_methods/bank_accounts
Version: 1.0.0
Security: ApiKeyAuth, ApiKeySecret

## Request fields (application/json):

  - `accountNumber` (string, required)
    O número da conta bancária ou do cartão de débito.
    Example: "445566790"

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

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

  - `bank` (string, required)
    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.

  - `reference` (string)
    Uma descrição de referência opcional para a conta bancária.
    Example: "SAVINGS_445566790"

## Response 201 fields (application/json):

  - `paymentMethodId` (string)
    O identificador único criado pela Belvo usado para referenciar o método de pagamento.
    Example: "0d1a377b-b4c5-4a94-9e2e-83e59d1f6a9c"

## 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"