Inicio
Documentación
Recursos
Certificaciones
Comunidad
Crear pago - Pagos - Mercado Pago Developers
¿Qué estás buscando?

¿No sabes cómo empezar la integración? 

Accede a los primeros pasos
Crear pago

POST

https://api.mercadopago.com/v1/advanced_payments
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.
Parámetros para la solicitud
HEADER
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
Parámetros de respuesta
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
Errores

400Bad Request

400

Parámetro faltante en header

500Error

500

Error

Solicitud
curl -X POST \
    'https://api.mercadopago.com/v1/advanced_payments'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'X-Meli-Session-Id: DEVICE_ID' \
       -H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
    -d '{
  "wallet_payment": {
    "transaction_amount": 125.98,
    "description": "Payment for the purchase of furniture",
    "external_reference": "Payment_seller_123",
    "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",
        "phone": {},
        "url": "www.nomedofacilitador.com.br"
      }
    },
    "discount": {
      "amount": 10,
      "description": "DESC20",
      "code": null,
      "detail": {
        "cap": 1000000,
        "type": "percentage",
        "value": 10
      }
    }
  },
  "payer": {
    "token": "abcdef1e23f4567d8e9123eb6591ff68df74c57930551ed980239f4538a7e530",
    "type_token": "wallet-tokens"
  },
  "binary_mode": false,
  "capture": false
}'
Respuesta de ejemplo
{
  "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"
}