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
Bearer access token.string
REQUERIDO
idempotency-id
Valor único por request. En caso de retry por timeout o error de red, mantén el mismo valor para evitar cobros duplicados.string
REQUERIDO
trace-id
Identificador de trazabilidad.string
REQUERIDO
Path
order_id
ID del pedido retornado por el endpoint Resolve QR (order.id).string
REQUERIDO
Body
plan
Plan seleccionado de la respuesta de Consultar planes disponibles.object
payment_method
Método de pago. Usar card.card_data para Card Data, card.brand_token para Brand Token, o card.acceptor_token para Acceptor Token.object
Response parameters
payment_id
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.string
status
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.string
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"
}