Inicio
Documentação
Recursos
Certificações
Comunidade
Capturar pagamento - Fluxo de pagamentos - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Capturar pagamento

A captura do pagamento é a confirmação do valor que deseja cobrar do comprador. Nesse ponto do fluxo de pagamento, o vendedor precisa que determinado pagamento seja retirado da carteira do cliente no momento de sua criação.

Veja abaixo o diagrama que ilustra o processo de captura de pagamento por meio do endpoint de Pagamentos das APIs de Wallet Connect.

Capture-payment-flow

Enviar request

Ao enviar o request ao endpoint de Pagamentos, garanta que os seguintes atributos sejam incluídos conforme exemplos abaixo.

ParâmetroDescrição
X-Idempotency-KeyEste parâmetro deve ser inserido no header de todos os requests. Para mais informações, veja a seção Idempotência.
X-Meli-Session-IdEste parâmetro pode ser incluído no header dos requests. Representa um identificador único para o dispositivo de cada comprador no momento da compra. É obrigatório apenas para as integrações pertencentes à indústria de Gambling. Se tiver dúvidas, consulte o seu representante comercial.
wallet_paymentIndica que é um pagamento de um vendedor com Wallet Connect previamente vinculado.
transaction_amountValor total que deverá ser cobrado do comprador.
descriptionDescrição do pagamento.
external_referenceReferência de pagamento atribuída pelo vendedor.
forward_data.sub_merchantDados encaminhados do sub_merchant. Informações que os facilitadores de pagamento devem enviar obrigatoriamente para identificar os subcomerciantes durante a transação. Para mais detalhes de cada campo pertencente a forward_data.sub_merchant, acesse a documentação dos Subcomerciante.
payerInformação do pagador requerida para criação do pagamento.
tokenToken de pagamento obtido após a finalização do fluxo da vinculação.
type_tokenTipo de pagamento. Para o uso no fluxo de Wallet Connect é preciso definir o valor “wallet-token”.
binary_modeO valor deste campo é obrigatoriamente "true".

Com esses parâmetros em mãos, envie um POST ao endpoint /v1/advanced_payments e execute a requisição ou, se preferir, utilize o curl abaixo.

          
curl -X POST \
    'https://api.mercadopago.com/v1/advanced_payments' \
    -H 'X-Idempotency-Key: IDEMPOTENCY_KEY' \
    -H 'X-Meli-Session-Id: DEVICE_ID' \
    -H 'Authorization: Bearer ACCESS_TOKEN' \
    -H 'accept: application/json' \
    -H 'content-type: application/json' \
    -d '{
         "wallet_payment": {
          "transaction_amount": 700.50,
          "description": "Descrição do pagamento",
          "external_reference": "Pago_123"
          "forward_data": {
             "sub_merchant": {
                "sub_merchant_id": 123123,
                "mcc": "5462",
                "country": "BRA",
                "address_door_number": 1,
                "zip": "2222222",
                "document_number": "222222222222222",
                "city": "SÃO PAULO",
                "address_street": "RUA A",
                "legal_name": "LOJINHA DO ZÉ",
                "region_code_iso": "BR-MG",
                "region_code": "BR",
                "document_type": "CNPJ",
                "phone": "123123123",
                "url": "www.nomedofacilitador.com.br"
               }
            }
         },
         "payer": {
            "token": "PAYER_TOKEN",
              "type_token": "wallet-token"
         },
         "binary_mode": true
      }'

        

Ao executar o request você poderá receber diferentes tipos de respostas originadas por razões específicas. Veja a seção Respostas para mais informações.