Consultar lista de perfiles de pago

Este endpoint permite consultar la lista de perfiles de pago asociados a un cliente específico a partir de su ID. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.

GET

https://api.mercadopago.com/v1/customers/{customer_id}/payment-profiles
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Path
customer_id
string

REQUERIDO

Identificador único del cliente para el que se quiere consultar los perfiles de pago. Puede ser obtenido en la consulta al endpoint "Buscar en clientes".
Query
limit
integer
Límite de paginación. Especifica el número máximo de registros que deseas obtener en la respuesta. Debe ser un valor numérico, mayor o igual a 1 y menor o igual a 100. El valor por defecto es 50.
offset
integer
Offset de paginación. Determina el punto de inicio desde el cual se deben obtener los registros. Debe ser un valor numérico mayor o igual a cero (0).
status
string
Estado actual del perfil de pago. Debe enviarlo en caso de que desee filtrar los perfiles por estado.
Response parameters
paging
object
data
array
Contiene la información de los perfiles de pago asociados al cliente. Cada perfil será un objeto con su identificación e información asociada.
Errores

400Error

customer_id_mismatch

La solicitud falló porque el "customer_id" enviado no coincide con el perfil de pago. Verifica haber enviado el valor correcto y vuelve a intentarlo.

caller_id_mismatch

La solicitud falló porque el "caller_id" no coincide con el perfil de pago. Verifica que el valor enviado es correcto y vuelve a intentarlo.

site_id_mismatch

La solicitud falló porque el "site_id" no coincide con el perfil de pago. Asegúrate de que sea correcto y corresponda al perfil de pago.

unknown_error_occurred

Error desconocido. Contacta a Soporte para obtener más información.

401Error

header_missing

La solicitud falló porque hay un header obligatorio que no fue enviado. Asegúrate de enviar todos los headers necesarios.

Unauthorized Access Token

El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la requisición enviando el valor correcto.

404Error

resource_not_found

La solicitud falló porque el perfil de pago no fue encontrado. Verifica que el ID del perfil, el ID del cliente y el ID del solicitante sean correctos.

429Error

Too Many Requests

La solicitud falló porque se excedió la frecuencia de solicitudes. Reduce la frecuencia o implementa un sistema de reintentos con backoff exponencial.

500Error

internal_server_error

La solicitud falló por un error interno del servidor. Por favor, vuelve a intentar más tarde y, si el problema persiste, ponte en contacto con Soporte con los detalles del error.

Request
curl -X GET \
    'https://api.mercadopago.com/v1/customers/{customer_id}/payment-profiles?limit=50&status=READY'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
    
Response
{
  "paging": {
    "total": 10,
    "total_pages": 100,
    "offset": 1,
    "limit": 10
  },
  "data": [
    {
      "id": "7036b192b541454fa9b9990660dfa1b5",
      "created_date": "2024-05-22T14:03:28.653Z",
      "last_updated_date": "2024-05-22T15:03:28.653Z",
      "description": "Simple description",
      "max_day_overdue": 5,
      "statement_descriptor": "Statement description",
      "status": "READY",
      "sequence_control": "AUTO",
      "payment_methods": [
        {
          "payment_method_id": "64abf0f5-3e15-48a5-9be0-a8ac56bbd87a",
          "id": "visa",
          "type": "credit_card",
          "card_id": 1234567890,
          "status": "READY",
          "default_method": true
        }
      ]
    }
  ]
}