Recursos para IA

Excluir meios de pagamento

Por padrão, todos os meios de pagamento estão disponíveis no Checkout Pro. Você pode personalizar essa configuração através da order para eliminar opções indesejadas.

Para excluir carteiras digitais em not_allowed_types, utilize o valor digital_currency em vez de digital_wallet. Para excluir o meio de pagamento Dinheiro em conta, use o valor account_money em not_allowed_types ou not_allowed_ids.

A tabela a seguir descreve os atributos do objeto config.payment_method disponíveis para configurar os meios de pagamento conforme as necessidades do negócio.

AtributoTipoDescriçãoExemplo
config.payment_method.not_allowed_typesArrayPermite excluir tipos de meios de pagamento indesejados, como pagamentos offline, cartões de crédito ou débito, entre outros. Para obter a lista completa de tipos disponíveis, envie um GET com seu Access TokenChave privada da aplicação criada no Mercado Pago, que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração > Credenciais de produção. ao endpoint /v1/payment_methodsAPI.["ticket"]
config.payment_method.not_allowed_idsArrayPermite excluir bandeiras específicas de cartões de crédito e débito, como Visa, Mastercard, American Express, entre outras. Para obter a lista completa de meios disponíveis, envie um GET com seu Access TokenChave privada da aplicação criada no Mercado Pago, que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração > Credenciais de produção. ao endpoint /v1/payment_methodsAPI.["master"]
config.payment_method.max_installmentsIntegerDefine o número máximo de parcelas que podem ser oferecidas ao comprador.10

Para configurar os meios de pagamento a excluir, inclua o objeto config.payment_method ao enviar a requisição ao endpoint Criar orderAPI.

curl

curl -X POST \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \
    -H 'X-Idempotency-Key: UNIQUE_KEY' \
    'https://api.mercadopago.com/v1/orders' \
    -d '{
  "type": "online",
  "processing_mode": "manual",
  "total_amount": "1000.00",
  "external_reference": "order_pro_123",
  "payer": {
    "email": "buyer@email.com"
  },
  "items": [
    {
      "title": "Meu produto",
      "unit_price": "1000.00",
      "quantity": 1,
      "unit_measure": "unit",
      "total_amount": "1000.00"
    }
  ],
  "config": {
    "payment_method": {
      "not_allowed_types": ["ticket"],
      "not_allowed_ids": ["master"],
      "max_installments": 10
    }
  }
}'