Integración para aplicaciones móviles

El método Obtener medios de pago devuelve la lista de medios de pago disponibles a partir del BIN de la tarjeta informada, considerando las reglas e instituciones financieras válidas para el país configurado. A través de este método podrás identificar la marca de la tarjeta, definir correctamente los siguientes pasos del checkout y validar la aceptación de la tarjeta.

kotlin
val coreMethods = MercadoPagoSDK.getInstance().coreMethods
coroutineScope {
   // Se debe usar el bin retornado del CardNumberTextFieldEvent.OnBinChanged
   val result = coreMethods.getPaymentMethods(bin = bin)
   when (result) {
       is Result.Success -> {
           // Éxito de la llamada
           print("Éxito de la request: ${result.data}")
       }

       is Result.Error -> {
           when (result.error) {
               is ResultError.Request -> {
                   // Error de la llamada de tipo request
                   print("Error de request: ${result.error}")
               }

               is ResultError.Validation -> {
                   // Error de la llamada de tipo validation
                   print("Error de validación: ${result.error}")
               }
           }
       }
   }
}

Los parámetros están listados en la tabla a continuación.

Para más información sobre la respuesta de la llamada, consulta la documentación del método en GitHub.

Este método te permite realizar la búsqueda de todas las opciones de cuotas disponibles para una tarjeta y un monto de transacción determinados. Considera las reglas del emisor, del método de pago y del valor de la compra, devolviendo todas las opciones válidas de cuotas, incluyendo cantidad de cuotas, intereses, valor de cada cuota, valor total, entre otros.

La llamada al método getInstallments debe hacerse para todos los tipos de tarjeta (débito y crédito) para verificar si el pago puede completarse por ese medio.

kotlin
val coreMethods = MercadoPagoSDK.getInstance().coreMethods
coroutineScope { 
   // Se debe usar el bin retornado del CardNumberTextFieldEvent.OnBinChanged
   val result = coreMethods.getInstallments(
       bin = bin,
       amount = BigDecimal("100.00")
   )
   when (result) {
       is Result.Success -> {
           // Éxito de la llamada
           print("Éxito de la request: ${result.data}")
       }

       is Result.Error -> {
           when (result.error) {
               is ResultError.Request -> {
                   // Error de la llamada de tipo request
                   print("Error de request: ${result.error}")
               }

               is ResultError.Validation -> {
                   // Error de la llamada de tipo validation
                   print("Error de validación: ${result.error}")
               }
           }
       }
   }
}

Los parámetros están listados en la tabla a continuación.

Para más información sobre la respuesta de la llamada, consulta la documentación del método en GitHub.

En determinados medios de pago y marcas, Mercado Pago exige la identificación del emisor de la tarjeta (issuer). Este método devuelve la lista de emisores disponibles para el BIN informado, permitiendo al usuario seleccionar el emisor correcto cuando sea necesario.

kotlin
val coreMethods = MercadoPagoSDK.getInstance().coreMethods
coroutineScope {
   // Se debe usar el bin retornado del CardNumberTextFieldEvent.OnBinChanged
   // Se debe usar el paymentMethodId retornado de la request de PaymentMethods
   val result = coreMethods.getCardIssuers(
       bin = bin,
       paymentMethodId = paymentMethodId,
   )
   when (result) {
       is Result.Success -> {
           // Éxito de la llamada
           print("Éxito de la request: ${result.data}")
       }

       is Result.Error -> {
           when (result.error) {
               is ResultError.Request -> {
                   // Error de la llamada de tipo request
                   print("Error de request: ${result.error}")
               }

               is ResultError.Validation -> {
                   // Error de la llamada de tipo validation
                   print("Error de validación: ${result.error}")
               }
           }
       }
   }
}

Los parámetros están listados en la tabla a continuación.

Para más información sobre la respuesta de la llamada, consulta la documentación del método en GitHub.

Mercado Pago exige la validación de un documento de identificación del titular de la tarjeta. Utiliza este método para recibir todos los tipos de documentos aceptados, como CPF, RG, DNI, para el país configurado en la integración.

kotlin
val coreMethods = MercadoPagoSDK.getInstance().coreMethods
coroutineScope {
   val result = coreMethods.getIdentificationTypes()
   when (result) {
       is Result.Success -> {
           // Éxito de la llamada
           print("Éxito de la request: ${result.data}")
       }

       is Result.Error -> {
           when (result.error) {
               is ResultError.Request -> {
                   // Error de la llamada de tipo request
                   print("Error de request: ${result.error}")
               }

               is ResultError.Validation -> {
                   // Error de la llamada de tipo validation
                   print("Error de validación: ${result.error}")
               }
           }
       }
   }
}

Para más información sobre la respuesta de la llamada, consulta la documentación del método en GitHub.

Este método genera un token temporal a partir de los datos de la tarjeta informada. El uso del token generado es obligatorio para realizar la transacción de pago mediante la API de Mercado Pago, ya que reemplaza los datos sensibles de la tarjeta, garantizando mayor seguridad en el proceso.

Crear un token para una nueva tarjeta

Para generar un token para una nueva tarjeta de forma segura, utiliza la clase que protege los datos ingresados y pásala al método generateCardToken. Antes de ejecutar el método, verifica que todos los campos obligatorios estén correctamente completados.

kotlin
val coreMethods = MercadoPagoSDK.getInstance().coreMethods
coroutineScope {
   val result = coreMethods.generateCardToken(
      cardNumberState = cardNumberPCIFieldState,
      expirationDateState = expirationDatePCIFieldState,
      securityCodeState = securityCodePCIFieldState,
      buyerIdentification = BuyerIdentification(
          name = "APRO",
          number = "12345678909",
          type = "CPF"
      )
   )
   when (result) {
       is Result.Success -> {
           // Éxito de la llamada
           print("Éxito de la request: ${result.data}")
       }

       is Result.Error -> {
           when (result.error) {
               is ResultError.Request -> {
                   // Error de la llamada de tipo request
                   print("Error de request: ${result.error}")
               }

               is ResultError.Validation -> {
                   // Error de la llamada de tipo validation
                   print("Error de validación: ${result.error}")
               }
           }
       }
   }
}

Los parámetros están listados en la tabla a continuación.

Para más información sobre la respuesta de la llamada, consulta la documentación del método en GitHub.

Crear un token para una tarjeta existente

En las transacciones con Mercado Pago, los datos de las tarjetas registradas por el comprador se almacenan de forma segura y no son accesibles desde tu backend. Sólo se proporciona el ID de la tarjeta a la aplicación, que deberás utilizar para generar un token temporal. Esto protege la información sensible, ya que sólo se maneja el ID, mientras que el número de tarjeta, CVV y fecha de vencimiento no se exponen y se mantienen seguros.

kotlin
val coreMethods = MercadoPagoSDK.getInstance().coreMethods
coroutineScope {
   val result = coreMethods.generateCardToken(
      cardId = cardId,
      expirationDateState = expirationDatePCIFieldState,
      securityCodeState = securityCodePCIFieldState,
      buyerIdentification = BuyerIdentification(
          name = "APRO",
          number = "12345678909",
          type = "CPF"
      )
   )
   when (result) {
       is Result.Success -> {
           // Éxito de la llamada
           print("Éxito de la request: ${result.data}")
       }

       is Result.Error -> {
           when (result.error) {
               is ResultError.Request -> {
                   // Error de la llamada de tipo request
                   print("Error de request: ${result.error}")
               }

               is ResultError.Validation -> {
                   // Error de la llamada de tipo validation
                   print("Error de validación: ${result.error}")
               }
           }
       }
   }
}

Los parámetros están listados en la tabla a continuación.

Para más información sobre la respuesta de la llamada, consulta la documentación del método en GitHub.

El envío debe realizarse mediante la creación de un pago que contenga la transacción asociada.
Para ello, envía un POST con tu Access Token productivoClave privada de la aplicación creada en Mercado Pago y que se utiliza en el backend en ambientes de desarrollo y para recibir pagos reales. Puedes acceder a ella a través de Tus integraciones > Detalles de aplicación > Producción > Credenciales de producción. y los parámetros requeridos listados abajo al endpoint /v1/paymentsAPI y ejecuta la solicitud.

curl
curl -X POST \
    'https://api.mercadopago.com/v1/payments' \
    -H 'Content-Type: application/json' \
    -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
    -H 'Authorization: Bearer TEST-774********25348-05********b89beeed********f053e824********0424235' \
    -d '{
  "additional_info": {
    "items": [
      {
        "id": "MLB2907679857",
        "title": "Point Mini",
        "description": "Point product for card payments via Bluetooth.",
        "picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
        "category_id": "electronics",
        "quantity": 1,
        "unit_price": 58,
        "type": "electronics",
        "event_date": "2023-12-31T09:37:52.000-04:00",
        "warranty": false,
        "category_descriptor": {
          "passenger": {},
          "route": {}
        }
      }
    ],
    "payer": {
      "first_name": "Test",
      "last_name": "Test",
      "phone": {
        "area_code": 11,
        "number": "987654321"
      },
      "address": {
        "zip_code": "12312-123",
        "street_name": "Av das Nacoes Unidas",
        "street_number": 3003,
        "neighborhood": null,
        "city": 3003,
        "federal_unit": 3003
      }
    },
    "shipments": {
      "receiver_address": {
        "zip_code": "12312-123",
        "state_name": "Rio de Janeiro",
        "city_name": "Buzios",
        "street_name": "Av das Nacoes Unidas",
        "street_number": 3003
      },
      "width": null,
      "height": null
    }
  },
  "application_fee": null,
  "binary_mode": false,
  "campaign_id": null,
  "capture": false,
  "coupon_amount": null,
  "description": "Payment for product",
  "differential_pricing_id": null,
  "external_reference": "MP0001",
  "installments": 1,
  "metadata": null,
  "payer": {
    "entity_type": "individual",
    "type": "customer",
    "id": null,
    "email": "test_payer@example.com",
    "identification": {
      "type": "CPF",
      "number": "95749019047"
    }
  },
  "payment_method_id": "master",
  "token": "ff8080814c11e237014c1ff593b57b4d",
  "transaction_amount": 58
}'

Consulta en la siguiente tabla las descripciones de los parámetros que tienen alguna particularidad importante a destacar: