Actualizar pago
PUT
Productos que lo utilizan:
Parámetros para la solicitud
PATH
id
Identificador único del pago, generado automáticamente por Mercado Pago.number
REQUERIDO
BODY
capture
Es un campo booleano que se encuentra en pagos de dos pasos (como tarjeta de débito). En este tipo de pago, que se realiza de forma asíncrona, primero se reserva el valor de la compra (capture = false). Esta cantidad se ...Ver másboolean
date_of_expiration
Fecha de vencimiento del pago. El formato válido del atributo es el siguiente - "yyyy-MM-dd'T'HH:mm:ssz". Por ejemplo - 2022-11-17T09:37:52.000-04:00.string
status
Es el estado actual de pago. Puede ser de dos tipos siguientes.string
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 mástransaction_amount
Costo del producto. Ejemplo - La venta de un producto por R$ 100,00 tendrá un transactionAmount = 100.number
Parámetros de respuesta
id
Identificador único del pago, generado automáticamente por Mercado Pago.number
date_created
Fecha de creación del pago.string
date_approved
Fecha de aprobación del Pago. Un pago puede generarse en un estado intermedio y luego ser aprobado, por tanto la fecha de creación no siempre coincidirá con la Fecha de Aprobación.string
date_last_updated
Fecha en la que se registró el ultimo evento sobre el pago.string
Errores
400Error
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.
403Error
4
The caller is not authorized to access this resource.
3002
The caller is not authorized to perform this action.
404Error
2000
Payment not found.
Solicitud
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
}'Respuesta de ejemplo
{
"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"
}
}
}