Recursos para IA
Capturar pagamento

Este endpoint captura ou cancela um pagamento ("advanced_payment"). Para capturar, envie os dados do pagamento com o campo "capture=true". Para cancelar, envie os dados do pagamento com o campo "status=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 pagamento.
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 pagamento.
payments
array
Lista de pagamentos que foram gerados.
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.

invalid_path_param

O "advanced_payment_id" fornecido no path não é válido. Verifique e forneça um id válido para tentar novamente.

404Recurso não encontrado.

payment_not_found

Pagamento não encontrado. Verifique se o "advanced_payment_id" enviado está correto.

500Erro genérico.

internal_error

Ocorreu um erro interno no servidor. Tente novamente mais tarde. Se o problema persistir, entre em contato com o suporte e forneça o x-request-id e detalhes sobre a operação 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-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": "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": "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"
}