Recursos para IA
Wallet Connect
Wallet Connect permite procesar pagos con la billetera de Mercado Pago del comprador, quien autoriza el acceso una única vez y luego paga sin informar datos ni iniciar sesión en cada compra. Esta referencia describe los endpoints disponibles y cómo interactuar con ellos.
¿Buscas el paso a paso de esta integración? Ir a la documentación de Wallet Connect.
¿Qué tipo de integración usar?
Elige de acuerdo con tu caso de uso.
- Procesamiento automático y manual
- Captura en dos pasos
- Notificaciones de pago y de la vinculación
- Procesamiento automático
- Notificaciones de la vinculación
Vía Orders API (Recomendada)
Vía Advanced Payments API (Legacy)
Endpoints disponibles
Todos los endpoints que componen la integración de Wallet Connect vía Orders API.
La vinculación es la etapa obligatoria en la que el comprador autoriza al vendedor a debitar pagos de su billetera de Mercado Pago.
| Operación | Path | Descripción |
| Crear vinculaciónPOST | /v2/wallet_connect/agreements | Crea un vínculo entre el integrador y la cuenta de Mercado Pago del pagador y devuelve la agreement_uri de autorización. |
| Generar token de pagoPOST | /v2/wallet_connect/agreements/{agreement_id}/payer_token | Intercambia el código de autorización por el payer_token, credencial utilizada para cobrar en la billetera del comprador. |
| Obtener vinculaciónGET | /v2/wallet_connect/agreements/{agreement_id} | Devuelve la información y el status de una vinculación a partir de su identificador. |
| Cancelar vinculaciónDELETE | /v2/wallet_connect/agreements/{agreement_id} | Cancela una vinculación activa y revoca el payer_token asociado. |
Endpoints de procesamiento de pagos.
| Operación | Path | Descripción |
| Crear orderPOST | /v1/orders | Crea la order con el payer_token, debitando el monto de la billetera en modo automatic o solamente autorizándolo en modo manual. |
| Capturar order totalmentePOST | /v1/orders/{order_id}/capture | Captura el monto autorizado de una order creada con capture_mode igual a manual. |
| Obtener order por IDGET | /v1/orders/{id} | Devuelve el status y el detalle completo de la order, incluyendo los intentos de procesamiento. |
| Cancelar order por IDPOST | /v1/orders/{order_id}/cancel | Libera la autorización de una order aún no capturada, sin transferir montos. |
| Reembolsar una orderPOST | /v1/orders/{order_id}/refund | Reembolsa una order total o parcialmente. |
¿Todo listo para comenzar?
Accede al primer endpoint y comienza a construir tu flujo de pagos con la Orders API.