Este endpoint permite generar un payer_token, un identificador único que representa la autorización del comprador para que el vendedor procese pagos desde su billetera. En caso de éxito, la solicitud devolverá una respuesta con el estado 201.
POST
REQUERIDO
REQUERIDO
REQUERIDO
payer_token que representa la autorización del comprador para que el vendedor procese pagos desde su billetera.400Error de solicitud.
CodeMismatch
El code proporcionado no coincide con el código de validación de esta vinculación. Utiliza el code devuelto en la return_uri o en el webhook de confirmación de la vinculación correspondiente.
AlreadyCreated
Ya se generó un payer_token para esta vinculación. Utiliza el payer_token obtenido anteriormente, ya que el mismo code no puede reutilizarse.
WindowExpired
La ventana de tiempo para generar un payer_token ha expirado. Crea una nueva vinculación y obtén una nueva aprobación del comprador.
AgreementNotConfirmedByUser
El comprador aún no ha confirmado la vinculación. Espera la conclusión del flujo de aprobación antes de solicitar el payer_token.
UserIdEqualsCollectorId
El comprador y el vendedor no pueden ser el mismo usuario de Mercado Pago. Utiliza cuentas distintas para realizar la vinculación.
InvalidCodeFormat
El formato de code es inválido. Debe ser una cadena alfanumérica de 32 caracteres en minúsculas.
403Prohibido.
forbidden
No tienes permiso para acceder al recurso solicitado. Verifica si el Access Token utilizado tiene los permisos y alcances necesarios para esta operación.
404Recurso no encontrado.
AgreementNotFound
No se encontró ninguna vinculación con el ID proporcionado. Esta misma respuesta se devuelve cuando la vinculación pertenece a otra aplicación (ClientNotOwner), a fin de evitar exponer la existencia de vinculaciones de otros clientes.
ClientNotOwner
La vinculación existe, pero no fue creada por la aplicación actual. Se devolverá la misma respuesta AgreementNotFound para evitar exponer la existencia de vinculaciones de otros clientes.
500Error genérico.
internal_error
Ocurrió un error interno en el servidor. Intenta nuevamente más tarde. Si el problema persiste, contacta al soporte y proporciona el x-request-id y detalles sobre la operación 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"
}