Este endpoint permite adicionar um método de pagamento para o perfil de pagamento associado a um cliente. Um perfil de pagamento pode conter como máximo dois meios de pagamento, e não poderá recever um novo se seu status for "CANCELLED". Em caso de sucesso, a requisição retornará uma resposta com status 201.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
400Erro
payment_methods_cannot_be_null
A requisição falhou porque não foi enviado nenhum meio de pagamento. Em "details" é possível obter mais detalhes sobre o erro. Verifique se os dados enviados são corretos e tente novamente.
payment_methods_required
A requisição falhou porque não foi enviado nenhum objeto com informações sobre o meio de pagamento. Em "details" é possível obter mais detalhes sobre o erro. Verifique se os dados enviados são corretos e tente novamente.
html_insertion_not_allowed
A requisição falhou porque se enviaram tags HTML em campos que no lo permiten. Em "details" é possível obter mais detalhes sobre o erro. Verifique se os dados enviados são válidos e tente novamente.
validation_error
A requisição falhou por um erro de validação nos campos enviados. Em "details" é possível obter mais detalhes sobre o erro. Verifique se os dados enviados são corretos e tente novamente.
payload_failed
A requisição falhou, possivelmente devido a erros de formatação ou dados inválidos. Em "details" é possível obter mais detalhes sobre o erro. Verifique se os dados enviados são corretos e tente novamente.
more_than_two_payment_methods_not_allowed
A requisição falhou porque foram enviados mais de dois objetos contendo informações sobre o meio de pagamento, o que é o máximo permitido para a criação do perfil. Revise a requisição e verifique se enviou esse nó corretamente.
two_cards_with_token_not_allowed
A requisição falhou porque não está permitido criar um perfil de pagamento com dois cartões com seu "card_token" como meio de pagamento. Revise a requisição para enviar ambos objetos de forma correta.
duplicate_payment_method_not_allowed
A requisição falhou porque há um meio de pagamento duplicado. Não é permitido adicionar novamente um meio de pagamento já existente no perfil de pagamento.
invalid_site_id_for_fintoc
A requisição falhou porque o site_id associado ao usuário que está criando o perfil de pagamento não é válido para o meio de pagamento "fintoc", meio de pagamento que é apenas disponível para Chile. Verifique se está enviando as credenciais corretas ou crie um perfil utilizando um meio de pagamento válido para seu país.
profile_modification_not_allowed
A requisição falhou porque se está querindo alterar um perfil com status cancelado, o que não é permitido. Verifique se o status do perfil de pagamento está correto antes de tentar realizar mudanças.
payment_method_validation_failed
A requisição falhou porque a validação do meio de pagamento não foi realizada. Tente novamente mais tarde e, se o problema persistir, entre em contato com o Suporte com detalhes do erro.
payment_method_id_cannot_be_blank
A requisição falhou porque não foi enviado nenhum valor para o campo "payment_method_id". Em "details" é possível obter mais detalhes sobre o erro. Verifique se os dados enviados são corretos e tente novamente.
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.
402Erro de processamento
payment_method_not_approved
A requisição falhou porque o pagamento para a verificação do meio de pagamento não foi aprovado. Verifique se as informações de pagamento são válidas e suficientes para completar a transação ou utiliza um meio de pagamento diferente.
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.
curl -X POST \
'https://api.mercadopago.com/v1/customers/{customer_id}/payment-profiles/{payment_profile_id}/payment-methods'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
-H 'X-Idempotency-Key: ef263819-9c28-4a4d-b4a7-dac4602ae0c7' \
-d '{
"id": "visa",
"type": "credit_card",
"token": "12345",
"default_method": false
}'{
"payment_method_id": "64abf0f5-3e15-48a5-9be0-a8ac56bbd87a",
"id": "visa",
"type": "credit_card",
"card_id": 1234567890,
"status": "READY",
"default_method": true
}