Recursos para IA
Processar o pagamentohttps://api.mercadopago.com/instore/v2/external/orders/{order_id}/payments
Processa um pagamento com cartão de crédito para um pedido usando Card Data, Brand Token ou Acceptor Token. O parâmetro idempotency-id deve ser único por request — altere-o em cada retry.
POST
Request parameters
Header
Authorization
Bearer access token.string
OBRIGATÓRIO
idempotency-id
Valor único por request. Em caso de retry por timeout ou erro de rede, mantenha o mesmo valor para evitar cobranças duplicadas.string
OBRIGATÓRIO
trace-id
Identificador de rastreabilidade.string
OBRIGATÓRIO
Path
order_id
ID do pedido retornado pelo endpoint Resolve QR (order.id).string
OBRIGATÓRIO
Body
plan
Plano selecionado da resposta de Consultar planos disponíveis.object
payment_method
Método de pagamento. Use card.card_data para Card Data, card.brand_token para Brand Token, ou card.acceptor_token para Acceptor Token.object
Response parameters
payment_id
Identificador único do pagamento criado pelo Mercado Pago. Use este valor para consultar o status do pagamento no endpoint Consultar pagamento por payment ID.string
status
Status inicial do pagamento imediatamente após o processamento. O pagamento pode ainda estar em estado intermediário — consultar Consultar pagamento por payment ID para verificar o status final.string
Erros
404Não encontrado
500Erro interno do 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"
}