Criar pagamento
POST
Produtos relacionados:
Parâmetros de requisição
HEADER
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 gar...Ver maisstring
OBRIGATÓRIO
X-Meli-Session-Id
O Device ID é uma informação importante para garantir uma melhor segurança e, consequentemente, uma melhor taxa de aprovação de pagamentos. Ele representa um identificador único para cada dispositivo do comprador no mome...Ver maisstring
BODY
wallet_payment
Indica que é um pagamento de um vendedor com Wallet Connect previamente vinculado.object
OBRIGATÓRIO
payer
Informação obrigatória sobre o pagador para criar o pagamento.object
OBRIGATÓRIO
binary_mode
Quando o pagamento é ativado, somente pode ser aprovado ou rejeitado, caso contrário, o pagamento ficará como pendente.boolean
capture
É um campo booleano encontrado em pagamentos em duas etapas (como cartão de débito). Nesse tipo de pagamento, que é realizado de forma assíncrona, o valor da compra é reservado primeiro (capture = false). Esse valor é ca...Ver maisboolean
Parâmetros de resposta
id
ID único que identifica o pagamento.number
payments
Lista de pagamentos.array
wallet_payment
Indica que é um pagamento de um vendedor com Wallet Connect previamente vinculado.object
disbursements
array
Erros
400Bad Request
400
Parâmetro do header ausente.
500Erro
500
Error
Requisição
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-4599*********755-11221*********d497ae962*********ecf8d85-1*********' \
-d '{
"wallet_payment": {
"transaction_amount": 125.98,
"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": "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
}'Resposta de exemplo
{
"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"
}