Recursos para IA
Procesar el pagohttps://api.mercadopago.com/instore/v2/external/orders/{order_id}/payments
Procesa un pago con tarjeta de crédito para un pedido usando Card Data, Brand Token o Acceptor Token. El parámetro idempotency-id debe ser único por request — cámbialo en cada retry.
POST
Request parameters
Header
Authorization
string
REQUERIDO
Bearer access token.
idempotency-id
string
REQUERIDO
Valor único por request. En caso de retry por timeout o error de red, mantén el mismo valor para evitar cobros duplicados.
trace-id
string
REQUERIDO
Identificador de trazabilidad.
Path
order_id
string
REQUERIDO
ID del pedido retornado por el endpoint Resolve QR (order.id).
Body
plan
object
Plan seleccionado de la respuesta de Consultar planes disponibles.
payment_method
object
Método de pago. Usar card.card_data para Card Data, card.brand_token para Brand Token, o card.acceptor_token para Acceptor Token.
Response parameters
payment_id
string
Identificador único del pago creado por Mercado Pago. Usar este valor para consultar el estado del pago en el endpoint Consultar pago por payment ID.
status
string
Estado inicial del pago inmediatamente después del procesamiento. El pago puede estar aún en un estado intermedio — consultar Consultar pago por payment ID para verificar el estado final.
Errores
404No encontrado
500Error interno del servidor
Request
curl -X POST \
'https://api.mercadopago.com/instore/v2/external/orders/{order_id}/payments'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-' \
-H 'idempotency-id: ' \
-H 'trace-id: ' \
-d '{
"plan": {
"type": "COMERCIO",
"description": "Plan COMERCIO - installment 1",
"installments": 1,
"total_amount": {
"currency": "ARS",
"value": 100
},
"installment_amount": {
"currency": "ARS",
"value": 100
},
"financial_info": {
"total_financial_cost": "0.00",
"nominal_annual_rate": "0.00"
},
"required_fields": [
"payment_method.card.holder.name",
"payment_method.card.holder.identification_type",
"payment_method.card.holder.identification_number"
]
},
"payment_method": {
"card": {
"card_data": {
"number": "4509953566233704",
"security_code": "123",
"expiration_month": 12,
"expiration_year": 2031,
"entry_mode": "MANUAL"
},
"brand_token": {
"original_bin": "450995",
"original_last4": "3704",
"token": "4509953566233704",
"cryptogram": "/gAAAAAC2/mj+KoAmbV0gmQAAAA=",
"security_indicator": "eci",
"par": "V0010015822051006609916940054",
"expiration_month": 12,
"expiration_year": 2031,
"token_requestor_id": "123"
},
"acceptor_token": "APP_USR-4934588586838432",
"holder": {
"name": "Test Test",
"identification_type": "DNI",
"identification_number": "33485274"
}
},
"wallet": {
"name": "galicia",
"provider": "modo",
"brand_wallet_id": "id_brand_123",
"user": {
"email": "test@example.com",
"phone": "1141234567",
"device_id": "ID_1234",
"identification_type": "DNI",
"identification_number": "33485274"
}
}
}
}'Response
{
"payment_id": "123456789",
"status": "IN_PROCESS"
}