#
Mercado Pago Agregador / Rapipago / Pago Fácil
#
1. Generar pago
El método devuelve un link que redirige al medio de pago.
POST /pagos
REQUEST
provider: (Tipo de dato: string). Nombre del Servicio de Pagos ("mp-agregador"). Campo obligatorio.
action: (Tipo de dato: string). Tipo de acción a ejecutar ("create"). Campo obligatorio.
amount: (Tipo de dato: float). Monto a cobrar con punto y dos decimales (Ejemplo: 1200.99). Campo obligatorio.
token: (Tipo de dato: float). Token de pago generado. Campo obligatorio para Mercado Pago Agregador, no para Rapipago o Pago Fácil.
reference_id: (Tipo de dato: string). Id de la orden. Campo obligatorio.
installmentss: (Tipo de dato: string). Número de cuotas. Campo obligatorio.
payment_method_id: (Tipo de dato: string). Medio de pago. En los casos de Rapipago y Pago fácil deberá ir indicado el medio en cuestión, por ejemplo, "pagofacil". Campo obligatorio.
device_unique_id: (Tipo de dato: integer). Sponsor id. Campo obligatorio.
email: (Tipo de dato: string). Email del comprador. Campo obligatorio.
secuence_number: (Tipo de dato: number). Merchand id, si lo hubiere. Campo obligatorio.
secret: (Tipo de dato: string). Token de MP. Campo obligatorio.
address: (Tipo de dato: objeto literal / hash) Datos de dirección.
- first_name: (Tipo de dato: string). Nombre del usuario. Campo obligatorio.
- last_name: (Tipo de dato: string). Apellido del usuario. Campo obligatorio.
- street1: (Tipo de dato: string). Calle del usuario. Campo obligatorio.
- number: (Tipo de dato: string). Número de dirección del usuario. Campo obligatorio.
- postal_code: (Tipo de dato: string). Código postal. Campo obligatorio.
items: (Tipo de dato: array) Productos de la compra
- id: (Tipo de dato: string) Id del producto. Campo obligatorio.
- title: (Tipo de dato: string) Título del producto. Campo obligatorio.
- picture_url: (Tipo de dato: string) Url de la imagen. Campo opcional.
- description: (Tipo de dato: string) Descripción del producto. Campo obligatorio.
- quantity: (Tipo de dato: string) Cantidad del producto. Campo obligatorio.
- unit_price: (Tipo de dato: string) Precio del producto. Campo obligatorio.
{
"provider": "mp-agregador",
"action": "create",
"secret": "TEST-5464752066894872-022314-3b8c3a637e3cac9c3c8cdca5d90555ee__LC_LD__-185117396",
"amount": 1000,
"token": "8d5561d2a33938a3317ac1bfd8624568",
"reference_id": 7232,
"installments": 2,
"payment_method_id": "visa",
"device_unique_id": 231315775,
"email": "test_user_123@testuser.com",
"secuence_number": "",
"address": {
"first_name": "Andrés",
"last_name": "Jaro",
"street1": "Vergara",
"number": "2011",
"postal_code": "1828"
}
"items":[{
"id": 1234,
"title": "Remera",
"picture_url": "",
"description": "remera",
"quantity": 1,
"unit_price": 1000
}],
}RESPONSE
El método devuelve el resultado de la transacción.
MERCADO PAGO AGREGADOR:
id: Identificador único del pago, generado automáticamente por Mercado Pago
status: Es el estado actual del pago. Puede ser de los siguientes tipos.
- pending: El usuario no ha concluido el proceso de pago (por ejemplo, al generar un pago mediante boleto, éste concluirá en el momento en que el usuario realiza el pago en el lugar seleccionado)
- approved: El pago fue aprobado y acreditado.
- authorized: El pago fue autorizado pero aún no capturado.
- in_process: El pago está en análisis.
- in_mediation: El usuario inició una disputa por el pago.
- rejected: El pago fue rechazado (el usuario puede intentar pagar nuevamente).
- cancelled: O el pago fue cancelado por una de las partes o expiró.
- refunded: El pago fue reembolsado al usuario.
- charged_back: Se realizó una devolución de cargo en la tarjeta de crédito del comprador.
{
"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_medium2x.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"
}
}
},
"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"
}
}
}PAGO FÁCIL:
id: Identificador único del pago, generado automáticamente por Mercado Pago
-external_resource_url: url para redireccionar al usuario.
{
"id": 1323314267,
"date_created": "2024-05-21T08:16:31.416-04:00",
"date_approved": null,
"date_last_updated": "2024-05-21T08:16:31.416-04:00",
"date_of_expiration": "2024-06-10T22:59:59.000-04:00",
"money_release_date": null,
"money_release_status": "pending",
"operation_type": "regular_payment",
"issuer_id": "11",
"payment_method_id": "pagofacil",
"payment_type_id": "ticket",
"payment_method": {
"id": "pagofacil",
"type": "ticket",
"issuer_id": "11",
"data": {},
"forward_data": {
"ticket_number": "",
"agreement_number": ""
}
},
"status": "pending",
"status_detail": "pending_waiting_payment",
"currency_id": "ARS",
"description": "Pedido 7244",
"live_mode": false,
"sponsor_id": 231315775,
"authorization_code": null,
"money_release_schema": null,
"taxes_amount": 0,
"counter_currency": null,
"brand_id": null,
"shipping_amount": 0,
"build_version": "3.52.2",
"pos_id": null,
"store_id": null,
"integrator_id": "dev_2ce07c31563311ed8b640242ac130004",
"platform_id": "C0457VLBCSDHCMR67IG0",
"corporation_id": null,
"payer": {
"identification": {
"number": null,
"type": null
},
"entity_type": null,
"phone": {
"number": null,
"extension": null,
"area_code": null
},
"last_name": null,
"id": "1815864003",
"type": null,
"first_name": null,
"email": null
},
"collector_id": 185117396,
"marketplace_owner": null,
"metadata": {},
"additional_info": {
"items": [
{
"id": "26",
"title": "Art test 14",
"description": "Art test 14",
"picture_url": "http://template-staging.pow.la/uploads/picture/image/640/thumb_219X287__1___1___1_.jpeg",
"category_id": null,
"quantity": "2",
"unit_price": "10000"
}
],
"payer": {
"address": {
"zip_code": "1191",
"street_name": "Valentín Gómez",
"street_number": "11111"
},
"first_name": "Andrs",
"last_name": "Jaromezuk"
},
"available_balance": null,
"nsu_processadora": null,
"authentication_code": null
},
"order": {},
"external_reference": "7244",
"transaction_amount": 10000,
"transaction_amount_refunded": 0,
"coupon_amount": 0,
"differential_pricing_id": null,
"financing_group": null,
"deduction_schema": null,
"barcode": {
"content": "3335008800000000006004331012101000000241422035",
"width": 1,
"height": 30,
"type": "Code128C"
},
"installments": 1,
"transaction_details": {
"payment_method_reference_id": "6004331012",
"acquirer_reference": "",
"barcode": {
"content": "3335008800000000006004331012101000000241422035",
"width": 1,
"height": 30,
"type": "Code128C"
},
"digitable_line": null,
"verification_code": "6004331012",
"net_received_amount": 0,
"total_paid_amount": 10000,
"overpaid_amount": 0,
"external_resource_url": "https://www.mercadopago.com.ar/sandbox/payments/1323314267/ticket?caller_id=1815864003&payment_method_id=pagofacil&payment_id=1323314267&payment_method_reference_id=6004331012&hash=1843f798-8211-435f-be96-165bb3d81c43",
"installment_amount": 0,
"financial_institution": "",
"payable_deferral_period": null
},
"fee_details": [],
"charges_details": [
{
"id": "1323314267-001",
"name": "mercadopago_fee",
"type": "fee",
"accounts": {
"from": "collector",
"to": "mp"
},
"client_id": 0,
"date_created": "2024-05-21T08:16:31.420-04:00",
"last_updated": "2024-05-21T08:16:31.420-04:00",
"amounts": {
"original": 410,
"refunded": 0
},
"metadata": {},
"reserve_id": null,
"refund_charges": []
}
],
"captured": true,
"binary_mode": false,
"call_for_authorize_id": null,
"statement_descriptor": null,
"card": {},
"notification_url": null,
"refunds": [],
"processing_mode": "aggregator",
"merchant_account_id": null,
"merchant_number": null,
"acquirer_reconciliation": [],
"point_of_interaction": {
"type": "UNSPECIFIED",
"business_info": {
"unit": "online_payments",
"sub_unit": "default",
"branch": "Merchant Services"
}
},
"accounts_info": null,
"tags": null
}