Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

Confira as atualizaçÔes das nossas soluçÔes e do funcionamento do sistema ou peça suporte técnico.

Parcerias

Conheça nosso programa para agĂȘncias ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratĂĄ-los.

Comunidade

Fique por dentro das Ășltimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Criar transação para conta bancåria - TransaçÔes - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Criar transação para conta bancåria

POST

https://api.mercadopago.com/v1/transaction-intents/process
Gera operaçÔes de saída de dinheiro desde uma conta do Mercado Pago a outras contas (internas ou externas), desde que a conta de retirada tenha fundos.
Parùmetros de requisição
HEADER
X-Idempotency-Key
string

OBRIGATÓRIO

Esta função permite repetir solicitaçÔes de forma segura, sem o risco de realizar a mesma ação mais de uma vez por engano. Isso Ă© Ăștil para evitar erros, como a criação de dois transaçÔes idĂȘnticas, por exemplo. Para gar...Ver mais
x-Signature
boolean

OBRIGATÓRIO

Assinatura da requisição com o body criptografado na base 64 com as chaves pĂșblica e privada do integrador. É obrigatĂłrio apenas no ambiente de produção.
x-enforce-signature
boolean
Booleano para indicar se o integrador irĂĄ ou nĂŁo enviar a assinatura. Deve ser "false" para ambiente de teste, "true" para ambiente produtivo, que Ă© quando Ă© obrigatĂłrio o envio da assinatura.
BODY
external_reference
string
ReferĂȘncia para identificar a transação. É gerada pelo integrador e pode ser qualquer valor que permita o rastreamento das transaçÔes, desde que nĂŁo possua caracteres especiais (“”, [ ], (), @) e nĂŁo exceda 64 caracteres...Ver mais
point_of_interaction
object

OBRIGATÓRIO

Valor fixo. Deve sempre ser preenchido como {"type":"PSP_TRANSFER"}
seller_configuration
object
Objeto contendo configuraçÔes do usuårio que realiza a transação.
transaction
object
Objeto que contém informaçÔes sobre a transação.
ParĂąmetros de resposta
created_date
string
Data de criação da transação.
external_reference
string
ReferĂȘncia externa da transação, gerada pelo integrador na hora da criação.
id
string
Identificador Ășnico da transação, gerado automaticamente
last_updated_date
string
Data de atualização do status da transação.
Erros

400Bad Request

Invalid external_reference

Valor invĂĄlido para o campo "external_reference". Verifique os valores permitidos para esse campo.

Invalid type point_of_interaction

Valor invĂĄlido para o campo "point_of_interaction.type". Lembre-se que Ă© um um valor fixo, sempre {"type":"PSP_TRANSFER"}.

Invalid amount

Valor invålido para o campo "transaction.from.accounts[0].amount". Verifique os valores permitidos para a transação.

Invalid identification number

Valor invĂĄlido para o campo "transaction.to.accounts[0].identification.number". Verifique os valores permitidos.

Invalid identification type

Valor invĂĄlido para o campo "transaction.to.accounts[0].owner.identification.type". Verifique os valores permitidos.

Account is disabled

A conta do Mercado Pago estĂĄ desativada

Participant is not available

O participante nĂŁo estĂĄ habilitado para o fluxo transacional.

Flow not specified

O header X-Flow-id suporta apenas "transfer" ou "management"

Compliance not processed

A verificação de conformidade não foi concluída para o usuårio.

Key PSP error

Tentativa de consultar uma chave PSP externa que jĂĄ estĂĄ cadastrada no MercadoPago

Invalid Body

O body da requisição tem um formato invålido

Client not allowed

O client ID associado às credenciais não tem permissão para fazer a requisição.

Financial identity not found

A instituição financeira não foi localizada. Verifique o campo "to.accounts.bank_id"

Many Requests

Muitas requisiçÔes foram feitas. Espere e tente novamente.

Rate Limit

O serviço de consulta atingiu o limite de rpm para não ultrapassar o limite permitido pelo Bacen e não receber multas.

Unauthorized

A requisição não estå autorizada.

Invalid Payload

Payload invĂĄlido.

424Failed Dependency

Resource locked

O serviço de rate limit estå processando o consumo de nossa API pelo integrador.

500Erro interno do servidor.

internal_server_error

Houve um erro na comunicação com transaction_intent

502Bad Gateway

bad_gateway

Erro de processamento na requisição

Requisição
curl -X POST \
    'https://api.mercadopago.com/v1/transaction-intents/process'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'x-Signature: true' \
       -H 'x-enforce-signature: false' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    -d '{
  "external_reference": "MP0001",
  "point_of_interaction": {},
  "seller_configuration": {
    "notification_info": {
      "notification_url": "http://example.com.br/notification"
    }
  },
  "transaction": {
    "from": {
      "accounts": [
        {
          "amount": 100
        }
      ]
    },
    "to": {
      "accounts": [
        {
          "type": "current",
          "amount": 100,
          "bank_id": "99999004",
          "branch": "0001",
          "holder": "Jonh Doe",
          "provider_id": "spi",
          "currency_id": "BRL",
          "number": "10266732",
          "owner": {
            "identification": {
              "type": "CPF",
              "number": "1234567890"
            }
          }
        }
      ]
    },
    "total_amount": 100
  }
}'
Resposta de exemplo
{
  "created_date": "2021-01-01T00:00:00.000Z",
  "external_reference": "123456",
  "id": "0d5020ed",
  "last_updated_date": "2021-01-01T00:00:00.000Z",
  "point_of_interaction": {
    "type": "{\"type\":\"PSP_TRANSFER\"}"
  },
  "seller_configuration": {
    "notification_info": {
      "notification_url": "http://example.com.br/notification"
    }
  },
  "status": "approved",
  "transaction": {
    "from": {
      "accounts": [
        {
          "amount": "100,00"
        }
      ]
    },
    "paid_amount": 100,
    "payer": {
      "id": 123456543
    },
    "refunded_amount": 1,
    "to": {
      "accounts": [
        {
          "amount": "100,00",
          "origin_id": "01AAAM001A1AY43FBR8WCM9CES",
          "status_details": [
            {}
          ],
          "owner": {
            "identification": {
              "number": "1234567890",
              "type": "CPF"
            }
          },
          "bank_id": "0000014",
          "type": "checking_account",
          "number": "123456"
        }
      ]
    },
    "total_amount": 100,
    "statement_descriptor": "test"
  }
}