Recursos para IA

Excluir medios de pago

De forma predeterminada, todos los medios de pago están disponibles en el Checkout Pro. Puedes personalizar esta configuración a través de la order para eliminar opciones no deseadas.

Para excluir billeteras digitales en not_allowed_types, utiliza el valor digital_currency en lugar de digital_wallet. Para excluir el medio de pago Dinero en cuenta, usa el valor account_money en not_allowed_types o not_allowed_ids.

La siguiente tabla describe los atributos del objeto config.payment_method disponibles para configurar los medios de pago según las necesidades del negocio.

AtributoTipoDescripciónEjemplo
config.payment_method.not_allowed_typesArrayPermite excluir tipos de medios de pago no deseados, como pagos offline, tarjetas de crédito o débito, entre otros. Para obtener la lista completa de tipos disponibles, envía 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 > Datos de integración > Credenciales de producción. al endpoint /v1/payment_methodsAPI.["ticket"]
config.payment_method.not_allowed_idsArrayPermite excluir marcas específicas de tarjetas de crédito y débito, como Visa, Mastercard, American Express, entre otras. Para obtener la lista completa de medios disponibles, envía 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 > Datos de integración > Credenciales de producción. al endpoint /v1/payment_methodsAPI.["master"]
config.payment_method.max_installmentsIntegerDefine el número máximo de cuotas que pueden ofrecerse al comprador.10

Para configurar los medios de pago a excluir, incluye el objeto config.payment_method al enviar la solicitud al endpoint Crear 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": "Mi producto",
      "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
    }
  }
}'