Pular para as operações

Bancário

Mercado Pago em um fluxo de decisão.

5 Mercado Pago operations a decision flow can call directly, with the credentials your own contract issued. The response is data the rest of the flow reads, branches on, and keeps in the trace.

Categoria
Bancário
Tipo
Integração
Autenticação
Chave de API
Ambiente de teste
Somente host de produção

Quem são

O braço de pagamentos do Mercado Livre, em toda a América Latina.

Mercado Pago processes card, Pix, cash and wallet payments in Brazil, Argentina, Mexico, Chile and Colombia, and lends against the sales history it sees. It began as the payment rail inside Mercado Libre's marketplace and now serves merchants who have nothing to do with it. Its reach across several countries is what distinguishes it from the Brazil-only providers.

O que um fluxo pode chamar

5 operações, cada uma um passo que você coloca no editor.

  1. GET/v1/payments/search?external_reference=$data.applicant_id

    Find a payer's payments

    Busca pagamentos pela sua própria referência, e é por isso que toda cobrança deveria levar external_reference com um id que você controla.

  2. GET/v1/payments/$data.mercadopago_payment_id

    Check a payment's status

    O estado de um pagamento, com o detalhe por trás dele.

  3. POST/v1/payments

    Gerar uma cobrança por Pix

    Cria uma cobrança por Pix que o pagador liquida pelo app do banco dele.

  4. POST/v1/payments/$data.mercadopago_payment_id/refunds

    Estornar um pagamento

    Estorna todo ou parte de um pagamento. amount é opcional — omita para um estorno total.

  5. GET/v1/identification_types

    Verificar a credencial

    Lists the document types the account's country accepts.

Onde isso entra na decisão

Banking calls have a natural place in a flow.

O dado bancário responde à pergunta que a renda declarada não responde: o que de fato entra, com que regularidade, e o que sai de novo. Normalmente é puxado uma vez por proposta e depois lido por vários nós — capacidade de pagamento, verificação de renda, qualquer regra sobre volatilidade de saldo — então vale buscá-lo cedo e derivar dele, em vez de chamá-lo repetidas vezes.

Whatever Mercado Pago returns is part of the run, so it is part of the record. When someone asks months later why an applicant was declined, the answer cites what came back at the time rather than re-fetching from a service whose answer has since changed.

  • 01Add Mercado Pago as a connection authenticating with an API key.
  • 02A Mercado Pago tem um host só para os dois ambientes, então proteja as execuções de teste com credenciais e limites seus.
  • 03Place a Connection node and pick an operation — “Find a payer's payments” is usually the first one a flow needs.
  • 04Mapeie a resposta nos campos que suas regras leem e depois teste o caminho inteiro antes de ele receber tráfego de produção.

Perguntas frequentes

Usando a Mercado Pago em um fluxo.

Como conecto a Mercado Pago a um fluxo de decisão?

Adicione a Mercado Pago como uma conexão no seu workspace, autenticando com uma chave de API, com as credenciais que o seu próprio contrato emitiu — a ArboRule chama o provedor no seu lugar e nunca assume um contrato por você. Depois que a conexão existe, qualquer fluxo do workspace pode colocar um nó de Conexão e escolher uma das operações dela. As credenciais ficam na conexão, não no fluxo, então quem cuida da política usa a Mercado Pago em uma decisão sem nunca ver o segredo.

Dá para testar a Mercado Pago sem tocar em produção?

A Mercado Pago expõe um host só para os dois ambientes, então não existe um sandbox separado para apontar. As execuções de teste continuam rodando no Sandbox e ficam registradas à parte no histórico de decisões, mas a chamada vai para o mesmo lugar que a de produção — então proteja isso com credenciais de teste, limites de taxa ou dados seus.

O que um fluxo pode chamar na Mercado Pago?

5 operations, including “Find a payer's payments”, “Check a payment's status”, “Raise a Pix charge”. Each one is a step you place on the canvas and map into the fields your rules read, and most flows start with “Find a payer's payments”. The list comes from the same manifest the engine uses to make the call, so this page cannot describe an operation the product does not have.

Em que ponto de uma decisão a Mercado Pago deve ser chamada?

O dado bancário responde à pergunta que a renda declarada não responde: o que de fato entra, com que regularidade, e o que sai de novo. Normalmente é puxado uma vez por proposta e depois lido por vários nós — capacidade de pagamento, verificação de renda, qualquer regra sobre volatilidade de saldo — então vale buscá-lo cedo e derivar dele, em vez de chamá-lo repetidas vezes.

Also in Banking

Quando você quiser

Wire Mercado Pago into a real decision.

Monte o fluxo no Sandbox, conecte sua conta e veja a decisão buscar o que precisa antes de responder.

Leia a documentação