Recursos para IA
Wallet Connect
Wallet Connect permite processar pagamentos com a carteira do Mercado Pago do comprador, que autoriza o acesso uma única vez e passa a pagar sem informar dados ou fazer login a cada compra. Esta referência descreve os endpoints disponíveis e como interagir com eles.
Está buscando o passo a passo desta integração? Ir à documentação do Wallet Connect.
Qual tipo de integração usar?
Escolha de acordo com o seu caso de uso.
- Processamento automático e manual
- Captura em duas etapas
- Notificações de pagamento e da vinculação
- Processamento automático
- Notificações da vinculação
Via Orders API (Recomendada)
Via Advanced Payments API (Legacy)
Endpoints disponíveis
Todos os endpoints que compõem a integração do Wallet Connect via Orders API.
A vinculação é a etapa obrigatória em que o comprador autoriza o vendedor a debitar pagamentos da sua carteira do Mercado Pago.
| Operação | Path | Descrição |
| Criar vinculaçãoPOST | /v2/wallet_connect/agreements | Cria um vínculo entre o integrador e a conta Mercado Pago do pagador e retorna a agreement_uri de autorização. |
| Gerar token de pagamentoPOST | /v2/wallet_connect/agreements/{agreement_id}/payer_token | Troca o código de autorização pelo payer_token, credencial utilizada para cobrar a carteira do comprador. |
| Obter vinculaçãoGET | /v2/wallet_connect/agreements/{agreement_id} | Retorna as informações e o status de uma vinculação a partir do seu identificador. |
| Cancelar vinculaçãoDELETE | /v2/wallet_connect/agreements/{agreement_id} | Cancela uma vinculação ativa e revoga o payer_token associado. |
Endpoints de processamento dos pagamentos.
| Operação | Path | Descrição |
| Criar orderPOST | /v1/orders | Cria a order com o payer_token, debitando o valor da carteira no modo automatic ou apenas autorizando no modo manual. |
| Capturar order totalmentePOST | /v1/orders/{order_id}/capture | Captura o valor autorizado de uma order criada com capture_mode igual a manual. |
| Obter order por IDGET | /v1/orders/{id} | Retorna o status e o detalhe completo da order, incluindo as tentativas de processamento. |
| Cancelar order por IDPOST | /v1/orders/{order_id}/cancel | Libera a autorização de uma order ainda não capturada, sem transferir valores. |
| Reembolsar uma orderPOST | /v1/orders/{order_id}/refund | Reembolsa uma order total ou parcialmente. |
Tudo pronto para começar?
Acesse o primeiro endpoint e comece a construir seu fluxo de pagamentos com a Orders API.