Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

Confira as atualizaçÔes das nossas soluçÔes e do funcionamento do sistema ou peça suporte técnico.

Parcerias

Conheça nosso programa para agĂȘncias ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratĂĄ-los.

Comunidade

Fique por dentro das Ășltimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Criar pagamento - Pagamentos - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Criar pagamento

POST

https://api.mercadopago.com/v1/advanced_payments
São pagamentos específicos para Wallet Connect. Durante o processo de vinculação, o integrador recebe um "token de pagamento" do pagador. Esse token permite que o integrador efetue o pagamento diretamente da carteira do pagador. Se desejar aplicar descontos, é necessårio criar uma promessa de desconto antes de utilizå-los.
Parùmetros de requisição
HEADER
X-Idempotency-Key
string

OBRIGATÓRIO

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 mais
X-Meli-Session-Id
string
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 mais
BODY
wallet_payment
object

OBRIGATÓRIO

Indica que Ă© um pagamento de um vendedor com Wallet Connect previamente vinculado.
payer
object

OBRIGATÓRIO

Informação obrigatória sobre o pagador para criar o pagamento.
binary_mode
boolean
Quando o pagamento Ă© ativado, somente pode ser aprovado ou rejeitado, caso contrĂĄrio, o pagamento ficarĂĄ como pendente.
capture
boolean
É 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 mais
ParĂąmetros de resposta
id
number
ID Ășnico que identifica o pagamento.
payments
array
Lista de pagamentos.
wallet_payment
object
Indica que Ă© um pagamento de um vendedor com Wallet Connect previamente vinculado.
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-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    -d '{
  "wallet_payment": {
    "transaction_amount": 125.98,
    "description": "Payment for the purchase of furniture",
    "external_reference": "Payment_seller_123",
    "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"
}