Inicio
DocumentaciĂłn
Recursos
Partners
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integraciĂłn y vendedores que quieren contratarlos.

Comunidad

Recibe las Ășltimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Crear transacciĂłn para cuenta bancaria - Transacciones - Mercado Pago Developers

BĂșsqueda inteligente powered by OpenAI 

Crear transacciĂłn para cuenta bancaria

POST

https://api.mercadopago.com/v1/transaction-intents/process
Genera operaciones de salida de dinero desde una cuenta de Mercado Pago a otras cuentas (internas o externas), siempre que la cuenta de retiro tenga fondos.
ParĂĄmetros para la solicitud
HEADER
X-Idempotency-Key
string

REQUERIDO

Esta funciĂłn permite repetir solicitudes de manera segura, sin el riesgo de realizar la misma acciĂłn mĂĄs de una vez por error. Esto es Ăștil para evitar errores, como la creaciĂłn de dos transacciones idĂ©nticas, por ejempl...Ver mĂĄs
x-Signature
boolean

REQUERIDO

Firma de la solicitud con el cuerpo cifrado en base 64 con las claves pĂșblica y privada del integrador. Es obligatorio sĂłlo en el ambiente de producciĂłn.
x-enforce-signature
boolean
Booleano para indicar si el integrador enviarĂĄ o no la firma. Debe ser "false" en ambiente de pruebas y "true" en ambiente productivo, que es cuando es obligatorio enviar la firma.
BODY
external_reference
string
Referencia para identificar la transacción. Es generada por el integrador y puede ser cualquier valor que permita hacer un seguimiento de las transacciones siempre que no tenga caracteres especiales (“”, [ ], (), @) y no...Ver más
point_of_interaction
object

REQUERIDO

Valor fijo. Siempre debe ser {"type":"PSP_TRANSFER"}
seller_configuration
object
Objeto que contiene configuraciones del usuario que realiza la transacciĂłn.
transaction
object
Objeto que contiene la informaciĂłn sobre la transacciĂłn.
ParĂĄmetros de respuesta
created_date
string
Fecha de creaciĂłn de la transacciĂłn.
external_reference
string
Referencia externa de la transacciĂłn, que fue generada por el integrador al momento de crearla.
id
string
Identificador Ășnico de la transacciĂłn, generado automĂĄticamente.
last_updated_date
string
Fecha de actualizaciĂłn del estado de la transacciĂłn.
Errores

400Bad Request

Invalid external_reference

Valor invĂĄlido para el campo "external_reference". Verifica los valores permitidos para este campo.

Invalid type point_of_interaction

Valor invĂĄlido para el campo "point_of_interaction.type". Recuerda que es un valor fijo y siempre debe ser {"type":"PSP_TRANSFER"}.

Invalid amount

Valor invĂĄlido para el campo "transaction.from.accounts[0].amount". Verifica los montos permitidos para la transacciĂłn.

Invalid identification number

Valor invĂĄlido para el campo "transaction.to.accounts[0].identification.number". Verifica los valores permitidos.

Invalid identification type

Valor invĂĄlido para el campo "transaction.to.accounts[0].owner.identification.type". Verifica los valores permitidos

Account is disabled

La cuenta de Mercado Pago estĂĄ desactivada

Participant is not available

El participante no estĂĄ habilitado para realizar esta transacciĂłn.

Flow not specified

El header X-Flow-id acepta solo "transfer" o "management"

Compliance not processed

La verificaciĂłn de conformidad no fue concluĂ­da para el usuario.

Key PSP error

Intento de consultar una clave PSP externa que ya estĂĄ registrada en Mercado Pago

Invalid Body

El cuerpo de la llamada tiene un formato invĂĄlido.

Client not allowed

El client ID asociado con las credenciales no tiene permitido realizar la llamada.

Financial identity not found

La instituciĂłn financiera no fue encontrada. Revisa el campo "to.accounts.bank_id".

Many Requests

Se realizaron demasiadas llamadas. Espera y vuelve a intentarlo.

Rate Limit

El servicio de consulta alcanzĂł el lĂ­mite de rpm para no exceder el lĂ­mite permitido por el Bacen y no recibir multas.

Unauthorized

La llamada no estĂĄ autorizada.

Invalid Payload

Payload invĂĄlido.

424Failed Dependency

Resource locked

El servicio de rate limit estĂĄ procesando el consumo que el integrador hace de nuestra API.

500Error interno del servidor.

internal_server_error

Hubo un error en la comunicaciĂłn con transaction_intent

502Bad Gateway

bad_gateway

Error procesando la llamada

Solicitud
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
  }
}'
Respuesta de ejemplo
{
  "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"
  }
}