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 wallet 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 utilizada no backend para autenticar as solicitações às APIs do Mercado Pago. Nunca deve ser compartilhada nem exposta no frontend. 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 utilizada no backend para autenticar as solicitações às APIs do Mercado Pago. Nunca deve ser compartilhada nem exposta no frontend. 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
    }
  ],
  "config": {
    "payment_method": {
      "not_allowed_types": ["ticket"],
      "not_allowed_ids": ["master"],
      "max_installments": 10
    }
  }
}'