Recursos para IA
Criar pagamentohttps://api.mercadopago.com/v1/advanced_payments
Este endpoint cria um advanced payment para o Wallet Connect. Durante o processo de vinculação, o integrador recebe um token de pagamento do comprador. Esse token permite que o integrador efetue o pagamento diretamente da carteira do comprador. Para aplicar descontos, crie uma promessa de desconto antes de usar este endpoint. Em caso de sucesso, a requisição retornará uma resposta com o status 201.
POST
Request parameters
Header
Authorization
Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.string
OBRIGATÓRIO
X-Idempotency-Key
Esta função permite repetir solicitações de forma segura, sem o risco de realizar a mesma ação mais de uma vez por engano. Isso é útil para evitar erros, como a criação de dois pagamentos idênticos, por exemplo. Para garstring
OBRIGATÓRIO
X-Meli-Session-Id
Identificador do dispositivo utilizado para melhorar a segurança e aumentar a taxa de aprovação do pagamento. Representa um identificador único para o dispositivo do comprador no momento da compra.string
Body
wallet_payment
Dados do pagamento de um vendedor com vinculação Wallet Connect prévia.object
OBRIGATÓRIO
payer
Informações do comprador necessárias para processar o pagamento.object
OBRIGATÓRIO
binary_mode
Quando ativado, o pagamento somente pode ser aprovado ou rejeitado. Caso contrário, o pagamento poderá ficar pendente.boolean
capture
Indica se o pagamento deve ser capturado imediatamente. Em pagamentos em duas etapas, envie "false" para reservar o valor primeiro e, em seguida, capture-o enviando "true" em uma requisição separada.boolean
Response parameters
id
Identificador único do advanced payment.number
payments
Lista de pagamentos gerados dentro do advanced payment.array
wallet_payment
Dados do pagamento via carteira de um vendedor com vinculação Wallet Connect prévia.object
disbursements
Lista de repasses distribuídos entre os vendedores.array
Erros
400Erro de requisição.
empty_required_header
O header "X-Idempotency-Key" é obrigatório e não foi enviado. Faça a requisição novamente incluindo-o.
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 POST \
'https://api.mercadopago.com/v1/advanced_payments'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
-H 'X-Idempotency-Key: 10522d04-5e19-4eb1-af24-e53e30976621' \
-H 'X-Meli-Session-Id: DEVICE_ID' \
-d '{
"wallet_payment": {
"transaction_amount": 24.5,
"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": "CO",
"address_door_number": 93,
"zip": "110221",
"document_number": "222222222222222",
"city": "Bogotá",
"address_street": "RUA A",
"legal_name": "LOJINHA DO ZÉ",
"region_code_iso": "BR-MG",
"region_code": "BR",
"document_type": "NIT",
"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": "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": "MCO",
"binary_mode": true,
"date_created": "2018-10-20T09:34:20.518-04:00",
"date_last_updated": "2018-10-20T09:34:20.518-04:00"
}