Crear pago/v1/paymentsRealiza la creación de un pago y agrega toda la información que necesites. Ten en cuenta de sumar el detalle del pago y los datos del pagador.
POST
Productos que lo utilizan:
Parámetros para la solicitud
additional_info
Localización: bodyInformación que puede mejorar el análisis de prevención de fraude y la tasa de conversión. Trata de enviarnos toda la infomación posibleobject
application_fee
Localización: bodyComisión recolectada por el marketplace o por Mercado Pagonumber
binary_mode
Localización: bodyCuando se configura como TRUE los pagos sólo pueden resultar aprobados o rechazados. Caso contrario también pueden resultar in_process.boolean
callback_url
Localización: bodyURL a la cual Mercado Pago hace la redirección final (sólo para transferencia bancaria)string
Parámetros de respuesta
id
Localización: bodyIdentificador único del pago, generado automáticamente por Mercado Pagonumber
date_created
Localización: bodyFecha de creación del Pago.string
date_approved
Localización: bodyFecha 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
Localización: bodyFecha en la que se registró el ultimo evento sobre el pago.string
Solicitud
curl
curl -X POST \
'https://api.mercadopago.com/v1/payments' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"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_medium@2x.png",
"category_id": "electronics",
"quantity": 1,
"unit_price": 58.8
}
],
"payer": {
"first_name": "Test",
"last_name": "Test",
"phone": {
"area_code": 11,
"number": "987654321"
},
"address": {}
},
"shipments": {
"receiver_address": {
"zip_code": "12312-123",
"state_name": "Rio de Janeiro",
"city_name": "Buzios",
"street_name": "Av das Nacoes Unidas",
"street_number": 3003
}
},
"barcode": {}
},
"description": "Payment for product",
"external_reference": "MP0001",
"installments": 1,
"metadata": {},
"order": {
"type": "mercadolibre"
},
"payer": {
"entity_type": "individual",
"type": "customer",
"identification": {}
},
"payment_method_id": "visa",
"transaction_amount": 58.8
}'Respuesta
json
{
"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": "Point Mini a maquininha que dá o dinheiro de suas vendas na hora",
"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_medium@2x.png",
"category_id": "electronics",
"quantity": 1,
"unit_price": 58.8
}
],
"payer": {
"registration_date": "2019-01-01T15:01:01.000Z"
},
"shipments": {
"receiver_address": {
"street_name": "Av das Nacoes Unidas",
"street_number": 3003,
"zip_code": 6233200,
"city_name": "Buzios",
"state_name": "Rio de Janeiro"
}
}
},
"order": {},
"external_reference": "MP0001",
"transaction_amount": 58.8,
"transaction_amount_refunded": 0,
"coupon_amount": 0,
"transaction_details": {
"net_received_amount": 56.16,
"total_paid_amount": 58.8,
"overpaid_amount": 0,
"installment_amount": 58.8
},
"fee_details": [
{
"type": "coupon_fee",
"amount": 2.64,
"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"
}
}
}Errores
400bad_request
1
3El token debe ser para test.
5Debes proveer tu access_token para proceder.
23El siguiente parámetro debe ser una fecha válida en formato (yyyy-MM-dd'T'HH:mm:ssz) date_of_expiration.
1000El número de filas excede los límites.
1001El formato de fecha debe ser yyyy-MM-dd'T'HH:mm:ss.SSSZ.
2001Ya se posteó el mismo request en el último minuto.
2002Cliente no encontrado.
2004Falló el POST a Gateway Transactions API.
2006Card Token no encontrado.
2007Falló la conexión a Card Token API.
2009Card token issuer no puede ser nulo.
2060El cliente no puede ser igual al vendedor.
3000Debes proveer el parámetro cardholder_name en card data.
3001Debes proveer el parámetro cardholder_name en card data.
3003card_token_id inválido.
3004parameter site_id inválido.
3005Acción inválida, el recurso esta en un estado que no permite esta operación. Para más información consulta el estado del recurso.
3006cardtoken_id inválido.
3007El parámetro client_id no puede ser nulo ni vacío.
3008Cardtoken no encontrado.
3009client_id no autorizado.
3010La tarjeta no se encuentra en la lista blanca.
3011payment_method no encontrado.
3012security_code_length inválido.
3013El parámetro security_code es requerido y no puede ser nulo ni vacío.
3014payment_method inválido.
3015card_number_length inválido.
3016card_number inválido.
3017El parámetro card_number_id no puede ser nulo ni vacío.
3018El parámetro expiration_month no puede ser nulo ni vacío.
3019El parámetro expiration_year no puede ser nulo ni vacío.
3020El parámetro cardholder.name no puede ser nulo ni vacío.
3021El parámetro cardholder.document.number no puede ser nulo ni vacío.
3022El parámetro cardholder.document.type no puede ser nulo ni vacío.
3023El parámetro cardholder.document.subtype no puede ser nulo ni vacío.
3024Acción inválida, reembolsos parciales no soportados para esta transacción.
3025Código de autorización inválido.
3026card_id inválido para este payment_method_id.
3027payment_type_id inválido.
3028payment_method_id inválido.
3029Mes de expiración de tarjeta inválido.
3030Año de expiración de tarjeta inválido.
4000El parámetro card no puede ser nulo.
4001payment_method_id no puede ser nulo.
4002transaction_amount no puede ser nulo.
4003transaction_amount debe ser numérico
4004installments no puede ser nulo.
4005installments debe ser numérico.
4006payer está mal formado.
4007site_id no puede ser nulo.
4012payer.id no puede ser nulo.
4013payer.type no puede ser nulo.
4015payment_method_reference_id no puede ser nulo.
4016payment_method_reference_id debe ser numérico.
4017status no puede ser nulo.
4018payment_id no puede ser nulo.
4019payment_id debe ser numérico.
4020notificaction_url debe ser una url válida.
4021notificaction_url debe tener una longitud menor a 500 caracteres.
4022metadata debe ser un JSON válido.
4023transaction_amount no puede ser nulo.
4024transaction_amount debe ser numérico.
4025refund_id no puede ser nulo.
4026coupon_amount inválido.
4027campaign_id debe ser numérico.
4028coupon_amount atributte debe ser numérico.
4029Tipo de payer inválido.
4037transaction_amount inválido.
4038application_fee no puede ser mayor que transaction_amount.
4039application_fee no puede ser un valor negativo.
4050payer.email debe ser un email válido.
4051La longitud de payer.email debe ser menor que 254 caracteres.
7523Fecha de expiración inválida.
403bad_request
4El usuario no esta autorizado a acceder a este recurso.
3002El usuario no está autorizado a realizar esta acción.
404bad_request
2000No se ha encontrado el pago.