Recursos para IA
Capturar pago

Este endpoint captura o cancela un pago ("advanced_payment"). Para capturar, envía los datos del pago con el campo "capture=true". Para cancelar, envía los datos del pago con el campo "status=canceled". En caso de éxito, la solicitud devolverá una respuesta con el estado 200.

PUT

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

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Path
advanced_payment_id
number

REQUERIDO

Identificador único del pago.
Body
capture
boolean
Envía este campo en "true" para confirmar y capturar el pago. Omítelo al cancelar.
wallet_payment
object

REQUERIDO

Datos del pago de un vendedor con una vinculación previa de Wallet Connect.
status
string
Envía este campo con el valor "canceled" para cancelar el pago. Omítelo al capturar.
Response parameters
id
number
Identificador único del pago.
payments
array
Lista de pagos que fueron generados.
wallet_payment
object
Datos del pago de billetera de un vendedor con vinculación previa de Wallet Connect.
disbursements
array
Lista de desembolsos distribuidos entre los vendedores.
Errors

400Error de solicitud.

invalid_path_param

El "advanced_payment_id" proporcionado en el path no es válido. Compruébalo y proporciona un id válido para volver a intentarlo.

404Recurso no encontrado.

payment_not_found

Pago no encontrado. Comprueba si enviaste el "advanced_payment_id" correcto.

500Error genérico.

internal_error

Ocurrió un error interno en el servidor. Intenta nuevamente más tarde. Si el problema persiste, contacta al soporte y proporciona el x-request-id y detalles sobre la operación realizada.

Request
curl -X PUT \
    'https://api.mercadopago.com/v1/advanced_payments/{advanced_payment_id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
    -d '{
  "capture": false,
  "wallet_payment": {
    "transaction_amount": 24.5,
    "description": "Payment for the purchase of furniture",
    "external_reference": "Payment_seller_123"
  },
  "status": "canceled"
}'
Response
{
  "id": 10234567,
  "payments": [
    {
      "id": 3870106238,
      "status": "approved",
      "status_detail": "accredited",
      "payment_type_id": "credit_card",
      "payment_method_id": "credit_card",
      "transaction_amount": "24.50",
      "installments": 1,
      "description": "Payment for the purchase of furniture",
      "capture": true,
      "external_reference": "payment_123"
    }
  ],
  "wallet_payment": {
    "transaction_amount": "24.50",
    "description": "Payment for the purchase of furniture",
    "external_reference": "Payment_seller_123",
    "discount": {
      "amount": 10,
      "code": "WALLET10"
    }
  },
  "disbursements": [
    {
      "collector_id": "987654"
    }
  ],
  "payer": {
    "id": 8879
  },
  "site_id": "MLM",
  "binary_mode": true,
  "date_created": "2018-10-20T09:34:20.518-04:00",
  "date_last_updated": "2018-10-20T09:34:20.518-04:00"
}