Consultar um perfil de pagamento específico

Este endpoint permite consultar um perfil de pagamento associado a um cliente específico utilizando os IDs. Em caso de sucesso, a requisição retornará uma resposta com status 200.

GET

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

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Path
customer_id
string

OBRIGATÓRIO

Identificador único do cliente cujo perfil de pagamento está sendo consultado. Pode ser obtido enviando uma requisição ao endpoint "Buscar em clientes".
payment_profile_id
string

OBRIGATÓRIO

Identificador único do perfil de pagamento, associado ao cliente.
Response parameters
id
string
Identificador único do perfil de pagamento.
created_date
string
Data de criação do payment profile, no formato "yyyy-MM-ddTHH:mm:ss.sssZ"
last_updated_date
string
Data da última atualização do payment profile, no formato "yyyy-MM-ddTHH:mm:ss.sssZ"
description
string
Descrição do perfil de pagamento do cliente, que será utilizado para facilitar a identificação da natureza das cobranças vinculadas a este perfil dentro do ecossistema de gestão do integrador ou seller.
Erros

400Erro

customer_id_mismatch

A requisição falhou porque o "customer_id" enviado não corresponde ao perfil de pagamento. Verifique se o valor correto foi enviado e tente novamente.

caller_id_mismatch

A requisição falhou porque o "caller_id" enviado não corresponde ao perfil de pagamento. Verifique se o valor correto foi enviado e tente novamente.

site_id_mismatch

A requisição falhou porque o "site_id" não corresponde ao perfil de pagamento. Verifique se o valor correto foi enviado e tente novamente.

unknown_error_occurred

Erro desconhecido. Entre em contato com o Suporte para mais informações.

401Erro

header_missing

A requisição falhou porque um header obrigatório não foi enviado. Certifique-se de enviar todos os headers necessários.

Unauthorized Access Token

O Access Token enviado está incorreto. Revise o valor e tente enviar a requisição novamente com a informação correta.

404Erro

resource_not_found

A requisição falhou porque o perfil de pagamento não foi encontrado. Verifique se o ID do perfil de pagamento, o ID do cliente e o ID do solicitante estão corretos.

429Erro

Too Many Requests

A requisição falhou porque se excedeu a frequência de solicitações. Reduza a frequência ou implemente um sistema de retentativas com backoff exponencial.

500Erro

internal_server_error

A requisição falhour por um erro interno do servidor. Tente novamente mais tarde e, se o problema persistir, entre em contato com o Suporte com detalhes do erro.

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
    }
  ]
}