Excluir medios de pago
De forma predeterminada, todos los medios de pago están disponibles en el Checkout Pro. Esta configuración se puede personalizar a través de la preferencia de pago, permitiendo eliminar opciones no deseadas.
El medio de pago Dinero en cuenta no puede ser excluido.
La siguiente tabla detalla los atributos disponibles en las preferencias de pago y la aplicación de cada uno para configurarlos según las necesidades del negocio.
| Atributo de preferencia | Descripción | Valores posibles |
payment_methods | Clase que describe los atributos y métodos de los medios de pago del Checkout Pro. | - |
excluded_payment_types | Permite excluir tipos de medios de pago no deseados, como pagos offline, tarjetas de crédito o débito, entre otros. Es posible obtener una lista detallada con todos los tipos de pago disponibles para integración enviando un GET con tu Access TokenClave privada de la aplicación creada en Mercado Pago, que es utilizada en el backend. Puedes acceder a ella a través de Tus integraciones > Detalles de aplicación > Pruebas > Credenciales de prueba o Producción > Credenciales de producción. al endpoint /v1/payment_methodsAPI. | ticket |
excluded_payment_methods | Permite excluir marcas específicas de tarjetas de crédito y débito, como Visa, Mastercard, American Express, entre otras. Es posible obtener una lista detallada con todos los medios de pago disponibles para integración enviando un GET con tu Access TokenClave privada de la aplicación creada en Mercado Pago, que es utilizada en el backend. Puedes acceder a ella a través de Tus integraciones > Detalles de aplicación > Pruebas > Credenciales de prueba o Producción > Credenciales de producción. al endpoint /v1/payment_methodsAPI. | master |
installments | Define el número máximo de cuotas que pueden ofrecerse al comprador. | 10 |
purpose | Al asignar el valor wallet_purchase, el Checkout Pro solo aceptará pagos realizados por usuarios registrados en Mercado Pago, utilizando tarjeta o saldo en cuenta. | wallet_purchase |
Con esta información, utiliza uno de los SDKs disponibles a continuación para configurar los medios de pago.
<?php
$preference = new MercadoPago\Preference();
// ...
$preference->payment_methods = array(
"excluded_payment_methods" => array(
array("id" => "master")
),
"excluded_payment_types" => array(
array("id" => "ticket")
),
"installments" => 12
);
// ...
?>
const preference = new Preference(client);
preference.create({
body: {
// ...
payment_methods: {
excluded_payment_methods: [
{
id: "master"
}
],
excluded_payment_types: [
{
id: "ticket"
}
],
installments: 12
}
}
})
// ...
PreferenceClient client = new PreferenceClient();
//...
List<PreferencePaymentMethodRequest> excludedPaymentMethods = new ArrayList<>();
excludedPaymentMethods.add(PreferencePaymentMethodRequest.builder().id("master").build());
excludedPaymentMethods.add(PreferencePaymentMethodRequest.builder().id("amex").build());
List<PreferencePaymentTypeRequest> excludedPaymentTypes = new ArrayList<>();
excludedPaymentTypes.add(PreferencePaymentTypeRequest.builder().id("ticket").build());
PreferencePaymentMethodsRequest paymentMethods =
PreferencePaymentMethodsRequest.builder()
.excludedPaymentMethods(excludedPaymentMethods)
.excludedPaymentTypes(excludedPaymentTypes)
.installments(12)
.build();
PreferenceRequest request = PreferenceRequest.builder().paymentMethods(paymentMethods).build();
client.create(request);
//...
#...
preference_data = {
# ...
payment_methods: {
excluded_payment_methods: [
{ id: 'master' }
],
excluded_payment_types: [
{ id: 'ticket' }
],
installments: 12
}
# ...
}
#...
var paymentMethods = new PreferencePaymentMethodsRequest
{
ExcludedPaymentMethods = new List<PreferencePaymentMethodRequest>
{
new PreferencePaymentMethodRequest
{
Id = "master",
},
},
ExcludedPaymentTypes = new List<PreferencePaymentTypeRequest>
{
new PreferencePaymentTypeRequest
{
Id = "ticket",
},
},
Installments = 12,
};
var request = new PreferenceRequest
{
// ...
PaymentMethods = paymentMethods,
};
#...
preference_data = {
"excluded_payment_methods": [
{ "id": "master" }
],
"excluded_payment_types": [
{ "id": "ticket" }
],
"installments": 12
}
#...