Recursos para IA
Capturar pagamento

Este endpoint captura ou cancela um advanced payment. Para capturar, envie os dados do pagamento com o campo "capture" como "true". Para cancelar, envie os dados do pagamento com o campo "status" como "canceled". Em caso de sucesso, a requisição retornará uma resposta com o status 200.

PUT

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

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Path
advanced_payment_id
number

OBRIGATÓRIO

Identificador único do advanced payment.
Body
capture
boolean
Envie este campo como "true" para confirmar e capturar o pagamento. Omita-o ao cancelar.
wallet_payment
object

OBRIGATÓRIO

Dados do pagamento de um vendedor com vinculação Wallet Connect prévia.
status
string
Envie este campo com o valor "canceled" para cancelar o pagamento. Omita-o ao capturar.
Response parameters
id
number
Identificador único do advanced payment.
payments
array
Lista de pagamentos gerados dentro do advanced payment.
wallet_payment
object
Dados do pagamento via carteira de um vendedor com vinculação Wallet Connect prévia.
disbursements
array
Lista de repasses distribuídos entre os vendedores.
Erros

400Erro de requisição.

400

Bad Request.

404

Not Found.

500Erro de processamento.

internal_error

Ocorreu um erro do nosso lado ao tentar processar a requisição. Por favor, tente novamente mais tarde.

Request
curl -X PUT \
    'https://api.mercadopago.com/v1/advanced_payments/{advanced_payment_id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-5*********956537-12*********ff1a3d36d*********47e7b9985*********770' \
    -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_detail": "accredited",
      "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": "collectorId"
    }
  ],
  "payer": {
    "id": 8879
  },
  "site_id": "MLU",
  "binary_mode": true,
  "date_created": "2018-10-20T09:34:20.518-04:00",
  "date_last_updated": "2018-10-20T09:34:20.518-04:00"
}