Crear pago - Pagos - Mercado Pago Developers
Crear pago

Pagos específicos para Wallet Connect. Durante el proceso de la vinculación, el integrador recibe un "token de pago" del pagador. Este token permite que el integrador realice el pago directamente desde la billetera del pagador. Si desea aplicar descuentos, primero es necesario crear una promesa de descuento antes de utilizarlos.

POST

https://api.mercadopago.com/v1/advanced_payments
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
X-Idempotency-Key
string

REQUERIDO

Esta función permite repetir solicitudes de manera segura, sin el riesgo de realizar la misma acción más de una vez por error. Esto es útil para evitar errores, como la creación de dos pagos idénticos, por ejemplo. Para ...Ver más
X-Meli-Session-Id
string
El Device ID es una información importante para lograr una mejor seguridad y, en consecuencia, una mejor tasa de aprobación de pagos. Representa un identificador único para el dispositivo de cada comprador en el momento ...Ver más
Body
wallet_payment
object

REQUERIDO

Indica que es un pago de un vendedor con una vinculación previa de Wallet Connect.
payer
object

REQUERIDO

Información del pagador requerida para crear el pago.
binary_mode
boolean
Cuando el pago está activado, solo puede ser aprobado o rechazado. De lo contrario, el pago puede estar pendiente.
capture
boolean
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ás
Response parameters
id
number
ID único que identifica el pago.
payments
array
Listado de pagos.
wallet_payment
object
Indica que es un pago de un vendedor con una vinculación previa de Wallet Connect.
disbursements
array
Errors

400Bad Request

400

Parámetro faltante en header

500Error

500

Error

Request
curl -X POST \
    'https://api.mercadopago.com/v1/advanced_payments'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
       -H 'X-Idempotency-Key: fdabf39a-1137-4ecc-9edc-fb68009fb457' \
       -H 'X-Meli-Session-Id: DEVICE_ID' \
    -d '{
  "wallet_payment": {
    "transaction_amount": 125.98,
    "description": "Payment for the purchase of furniture",
    "external_reference": "Payment_seller_123",
    "statement_descriptor": "descriptor",
    "forward_data": {
      "sub_merchant": {
        "sub_merchant_id": 123123,
        "mcc": "5462",
        "country": "BRA",
        "address_door_number": 1,
        "zip": "2222222",
        "document_number": "222222222222222",
        "city": "SÃO PAULO",
        "address_street": "RUA A",
        "legal_name": "LOJINHA DO ZÉ",
        "region_code_iso": "BR-MG",
        "region_code": "BR",
        "document_type": "CNPJ",
        "url": "www.nomedofacilitador.com.br"
      }
    },
    "discount": {
      "amount": 10,
      "description": "DESC20",
      "detail": {
        "cap": 1000000,
        "type": "percentage",
        "value": 10
      }
    }
  },
  "payer": {
    "token": "abcdef1e23f4567d8e9123eb6591ff68df74c57930551ed980239f4538a7e530",
    "type_token": "wallet-tokens"
  },
  "binary_mode": false,
  "capture": false
}'
Response
{
  "id": 10267812,
  "payments": [
    {
      "id": 3870106238,
      "status_detail": "approved_id",
      "payment_method_id": "credit_card_id",
      "transaction_amount": 700.5,
      "installments": 1,
      "description": "Payment for the purchase of furniture",
      "capture": true,
      "external_reference": "payment_123"
    }
  ],
  "wallet_payment": {
    "transaction_amount": 125.98,
    "description": "payment of a bussines trip",
    "external_reference": "Payment_seller_123",
    "discount": {
      "amount": 10,
      "code": "WALLET10"
    }
  },
  "disbursements": [
    {
      "collector_id": "collectorId"
    }
  ],
  "payer": {
    "id": 8879
  },
  "site_id": "MLA",
  "binary_mode": true,
  "date_created": "2018-10-20T09:34:20.518-04:00",
  "date_last_updated": "2018-10-20T09:34:20.518-04:00"
}