Atualizar pagamento
PUT
Produtos relacionados:
Parâmetros de requisição
PATH
id
Identificador único de pagamento, gerado automaticamente pelo Mercado Pago.number
OBRIGATÓRIO
BODY
capture
É um campo booleano existente em pagamentos de duas etapas (como o cartão de débito). Nesse tipo de pagamento, que é realizado de modo assíncrono, primeiro é feito a reserva do valor da compra (capture = false). Esse val...Ver maisboolean
date_of_expiration
Data de expiração do pagamento. O formato válido do atributo é o seguinte - "yyyy-MM-dd'T'HH:mm:ssz". Por exemplo - 2022-11-17T09:37:52.000-04:00.string
status
É o estado atual do pagamento. Podem ser ser dos seguintes tiposstring
pending: The user has not concluded the payment process (for example, to generate a payment by boleto, this payment will be concluded at the moment in which the user makes the non-corresponding payment selected);
approved: The payment was approved and credited;
authorized: The payment was authorized, but still was not captured;
Ver maistransaction_amount
Custo do produto. Exemplo - A venda de um produto por R$100,00 terá um transactionAmount = 100.number
Parâmetros de resposta
id
Identificador único de pagamento, gerado automaticamente pelo Mercado Pago.number
date_created
Data de criação do pagamento.string
date_approved
Data de aprovação do pagamento. Um pagamento pode ser gerado em um estado intermediário e depois aprovado, portanto, a data de criação nem sempre coincidirá com a Data de Aprovação.string
date_last_updated
Data em que o último evento de pagamento foi registrado.string
Erros
400Erro
8
The name of the parameters is wrong
1004
Invalid parameters for payment_method API
2018
The action requested is not valid for the current payment state.
2078
Capture attribute must be boolean.
2079
Invalid value for capture attribute.
403Erro
4
The caller is not authorized to access this resource.
3002
The caller is not authorized to perform this action.
404Erro
2000
Payment not found.
Requisição
curl -X PUT \
'https://api.mercadopago.com/v1/payments/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
-d '{
"capture": false,
"status": "cancelled",
"transaction_amount": 58.8
}'curl -X PUT \
'https://api.mercadopago.com/v1/payments/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
-d '{
"capture": false,
"status": "cancelled",
"transaction_amount": 58.8
}'curl -X PUT \
'https://api.mercadopago.com/v1/payments/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
-d '{
"capture": false,
"status": "cancelled",
"transaction_amount": 58.8
}'curl -X PUT \
'https://api.mercadopago.com/v1/payments/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
-d '{
"capture": false,
"status": "cancelled",
"transaction_amount": 58.8
}'curl -X PUT \
'https://api.mercadopago.com/v1/payments/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
-d '{
"capture": false,
"status": "cancelled",
"transaction_amount": 58.8
}'curl -X PUT \
'https://api.mercadopago.com/v1/payments/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
-d '{
"capture": false,
"status": "cancelled",
"transaction_amount": 58.8
}'curl -X PUT \
'https://api.mercadopago.com/v1/payments/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
-d '{
"capture": false,
"status": "cancelled",
"transaction_amount": 58.8
}'Resposta de exemplo
{
"id": 20359978,
"date_created": "2019-07-10T14:47:58.000Z",
"date_approved": "2019-07-10T14:47:58.000Z",
"date_last_updated": "2019-07-10T14:47:58.000Z",
"money_release_date": "2019-07-24T14:47:58.000Z",
"issuer_id": 25,
"payment_method_id": "visa",
"payment_type_id": "credit_card",
"status": "approved",
"status_detail": "accredited",
"currency_id": "BRL",
"description": "Pago Pizza",
"taxes_amount": 0,
"shipping_amount": 0,
"collector_id": 448876418,
"payer": {
"id": 123,
"email": "test_user_80507629@testuser.com",
"identification": {
"number": 19119119100,
"type": "CPF"
},
"type": "customer"
},
"metadata": {},
"additional_info": {
"items": [
{
"id": "PR0001",
"title": "Point Mini",
"description": "Producto Point para cobros con tarjetas mediante bluetooth",
"picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
"category_id": "electronics",
"quantity": 1,
"unit_price": 58
}
],
"payer": {
"registration_date": "2019-01-01T15:01:01.000Z"
},
"shipments": {
"receiver_address": {
"street_name": "Av das Nacoes Unidas",
"street_number": "3003",
"zip_code": "12312-123",
"city_name": "Buzios",
"state_name": "Rio de Janeiro"
}
}
},
"external_reference": "MP0001",
"transaction_amount": 58.8,
"transaction_amount_refunded": 0,
"coupon_amount": 0,
"transaction_details": {
"net_received_amount": 56,
"total_paid_amount": 58,
"overpaid_amount": 0,
"installment_amount": 58
},
"fee_details": [
{
"type": "coupon_fee",
"amount": 2,
"fee_payer": "payer"
}
],
"statement_descriptor": "MercadoPago",
"installments": 1,
"card": {
"first_six_digits": 423564,
"last_four_digits": 5682,
"expiration_month": 6,
"expiration_year": 2023,
"date_created": "2019-07-10T14:47:58.000Z",
"date_last_updated": "2019-07-10T14:47:58.000Z",
"cardholder": {
"name": "APRO",
"identification": {
"number": 19119119100,
"type": "CPF"
}
}
},
"notification_url": "https://www.suaurl.com/notificacoes/",
"processing_mode": "aggregator",
"point_of_interaction": {
"type": "PIX",
"application_data": {
"name": "NAME_SDK",
"version": "VERSION_NUMBER"
},
"transaction_data": {
"qr_code_base64": "iVBORw0KGgoAAAANSUhEUgAABRQAAAUUCAYAAACu5p7oAAAABGdBTUEAALGPC/xhBQAAAAFzUkdCAK7OHOkAAAAgY0hSTQAAeiYAAICEAAD6AAAAgOgAAHUwAADqYAAAOpgAABdwnLpRPAAAIABJREFUeJzs2luO3LiWQNFmI+Y/Zd6vRt36KGNXi7ZOBtcagHD4kNLeiLX33v8DAAAAABD879sDAAAAAAA/h6AIAAAAAGSCIgAAAACQCYoAAAAAQCYoAgAAAACZoAgAAAAAZIIiAAAAAJAJigAAAABAJigCAAAAAJmgCAAAAABkgiIAAAAAkAmKAAAAAEAmKAIAAAAAmaAIAAAAAGSCIgAAAACQCYoAAAAAQCYoAgAAAACZoAgAAAAAZIIiAAAAAJAJigAAAABAJigCA...",
"qr_code": "00020126600014br.gov.bcb.pix0117test@testuser.com0217dados adicionais520400005303986540510.005802BR5913Maria Silva6008Brasilia62070503***6304E2CA",
"ticket_url": "https://www.mercadopago.com.br/payments/123456789/ticket?caller_id=123456&hash=123e4567-e89b-12d3-a456-426655440000"
}
}
}