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.
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.
| Atributo | Tipo | Descrição | Exemplo |
config.payment_method.not_allowed_types | Array | Permite 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 Token ao endpoint /v1/payment_methodsAPI. | ["ticket"] |
config.payment_method.not_allowed_ids | Array | Permite 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 Token ao endpoint /v1/payment_methodsAPI. | ["master"] |
config.payment_method.max_installments | Integer | Define 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 } } }'