Recursos para IA
Gerar token de pagamento

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

https://api.mercadopago.com/v2/wallet_connect/agreements/{agreement_id}/payer_token
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
agreement_id
string

OBRIGATÓRIO

Identificador único da vinculação, retornado na resposta do endpoint /v2/wallet_connect/agreements.
Body
code
string

OBRIGATÓRIO

Código de validação gerado durante o fluxo de vinculação. É um código alfanumérico de 32 caracteres em letras minúsculas, obtido no callback de confirmação do co
Response parameters
payer_token
string
payer_token que representa a autorização do comprador para que o vendedor processe pagamentos a partir de sua carteira.
Erros

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.

Request
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-1*********550113-12*********b4773884a*********e8df16347*********786' \
    -d '{
  "code": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"
}'
Response
{
  "payer_token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"
}