Crear transacción para cuenta bancaria - Transacciones - Mercado Pago Developers
¿Qué estás buscando?

¿No sabes cómo empezar la integración? 

Accede a los primeros pasos
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.

Invalid identity source

El header X-Identity-Source acepta solo "dict" o "ted".

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-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
    -d '{
  "external_reference": "MP0001",
  "point_of_interaction": {},
  "seller_configuration": {
    "notification_info": {
      "notification_url": "http://example.cl/notification"
    }
  },
  "transaction": {
    "from": {
      "accounts": [
        {
          "amount": 100
        }
      ]
    },
    "to": {
      "accounts": [
        {
          "amount": 100,
          "bank_id": "99999004",
          "type": "current",
          "number": "10266732",
          "owner": {
            "identification": {
              "type": "RUT",
              "number": "111111111111"
            }
          }
        }
      ]
    },
    "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.cl/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": "RUT"
            }
          },
          "bank_id": "0000014",
          "type": "checking_account",
          "number": "123456"
        }
      ]
    },
    "total_amount": 100,
    "statement_descriptor": "test"
  }
}