Consultar lista de perfis de pagamento

Este endpoint permite consultar a lista de perfis de pagamento associados a um cliente específico a partir de seu ID. Em caso de sucesso, a requisição retornará uma resposta com status 200.

GET

https://api.mercadopago.com/v1/customers/{customer_id}/payment-profiles
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 para o qual os perfis de pagamento estão sendo consultados. Pode ser obtido enviando uma requisição ao endpoint "Buscar em clientes".
Query
limit
integer
Limite de paginação. Especifica o número máximo de registros que você deseja obter na resposta. Deve ser um valor numérico maior ou igual a 1 e menor ou igual a 100. O valor padrão é 50.
offset
integer
Offset de paginação. Determina o ponto inicial a partir do qual os registros devem ser obtidos. Deve ser um valor numérico maior ou igual a zero (0).
status
string
Status atual do perfil de pagamento. Deve enviá-lo caso deseje filtrar os perfis pelo status.
Response parameters
paging
object
data
array
Contém as informações sobre os perfis de pagamento associados ao cliente. Cada perfil será um objeto com sua identificação e informações associadas.
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 o limite de chamadas foi excedido. Diminua a frequência ou utilize backoff exponencial para novas tentativas.

500Erro

internal_server_error

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

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