Este endpoint permite gerar um payer_token, um identificador único que representa a autorização do comprador para que o vendedor processe pagamentos a partir de sua carteira. Em caso de sucesso, a requisição retornará uma resposta com o status 201.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
payer_token que representa a autorização do comprador para que o vendedor processe pagamentos a partir de sua carteira.400Erro de requisição.
CodeMismatch
O code informado não corresponde ao código de validação desta vinculação. Utilize o code retornado na return_uri ou no webhook de confirmação da vinculação correspondente.
AlreadyCreated
Um payer_token para esta vinculação já foi gerado. Utilize o payer_token obtido anteriormente, pois o mesmo code não pode ser reutilizado.
WindowExpired
A janela de tempo para gerar um payer_token expirou. Crie uma nova vinculação e obtenha uma nova aprovação do comprador.
AgreementNotConfirmedByUser
A vinculação ainda não foi confirmada pelo comprador. Aguarde a conclusão do fluxo de aprovação antes de solicitar o payer_token.
UserIdEqualsCollectorId
O comprador e o vendedor não podem ser o mesmo usuário do Mercado Pago. Utilize contas distintas para realizar a vinculação.
InvalidCodeFormat
O formato de code é inválido. Deve ser uma string alfanumérica de 32 caracteres em letras minúsculas.
403Proibido.
forbidden
Você não tem permissão para acessar o recurso solicitado. Verifique se o Access Token utilizado tem as permissões e escopos necessários para esta operação.
404Recurso não encontrado.
AgreementNotFound
Nenhuma vinculação foi encontrada com o ID informado. Essa mesma resposta é retornada quando a vinculação pertence a outra aplicação (ClientNotOwner), a fim de evitar expor a existência de vinculações de outros clientes.
ClientNotOwner
A vinculação existe, mas não foi criada pela aplicação atual. A mesma resposta de AgreementNotFound será retornada para evitar expor a existência de vinculações de outros clientes.
500Erro genérico.
internal_error
Ocorreu um erro interno no servidor. Tente novamente mais tarde. Se o problema persistir, entre em contato com o suporte e forneça o x-request-id e detalhes sobre a operação realizada.
curl -X POST \
'https://api.mercadopago.com/v2/wallet_connect/agreements/{agreement_id}/payer_token'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
-d '{
"code": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"
}'{
"payer_token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"
}