Consultar un perfil de pago específico

Este endpoint permite consultar un perfil de pago asociado a un cliente específico utilizando los IDs de cada uno. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.

GET

https://api.mercadopago.com/v1/customers/{customer_id}/payment-profiles/{payment_profile_id}
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 del que se quiere consultar el perfil de pago. Puede ser obtenido en la consulta al endpoint "Buscar en clientes".
payment_profile_id
string

REQUERIDO

Identificador único del perfil de pago a consultar, asociado al cliente.
Response parameters
id
string
Identificador único del perfil de pago.
created_date
string
Fecha de creación del perfil de pago, en formato "yyyy-MM-ddTHH:mm:ss.sssZ".
last_updated_date
string
Fecha de la última actualización del perfil de pago, en formato "yyyy-MM-ddTHH:mm:ss.sssZ".
description
string
Descripción del perfil de pago del cliente, que será utilizado para facilitar la identificación de la naturaleza de los cobros vinculados a este perfil dentro del ecosistema de gestión del integrador o seller.
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/{payment_profile_id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
    
Response
{
  "id": "7036b192b541454fa9b9990660dfa1b5",
  "created_date": "2024-05-22T14:03:28.653Z",
  "last_updated_date": "2024-05-22T14:03:28.653Z",
  "description": "Payment description",
  "max_day_overdue": 5,
  "statement_descriptor": "Test Descriptor",
  "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
    }
  ]
}