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.

Adicionar transaçÔes à order - Pagamentos online - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Adicionar transaçÔes à order

POST

https://api.mercadopago.com/v1/orders/{order_id}/transactions
Esse endpoint permite adicionar transaçÔes de pagamento à order. Essa operação só pode ser realizada no modo manual (processando a transação em etapas que podem ser configuradas e executadas de forma incremental), com o parùmetro 'processing_mode' com valor 'manual'. Em caso de sucesso, a requisição retornarå uma resposta com o status 201.
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. Para garantir que cad...Ver mais
PATH
id
string

OBRIGATÓRIO

Identificador da order, retornado na resposta à requisição para sua criação.
BODY
payments
array
ContĂ©m informaçÔes sobre a order do pagamento. Caso deseje criar uma order com dois cartĂ”es, vocĂȘ pode adicionar um item ao array, dividindo o valor total da transação e indicando um meio de pagamento diferente em cada i...Ver mais
ParĂąmetros de resposta
payments
array
Contém informaçÔes sobre o pagamento associado à order.
Erros

400Erro.

empty_required_header

O header 'X-Idempotency-Key' é requerido e não foi enviado. Faça a requisição novamente incluindo-o.

invalid_path_param

O order_id fornecido no path da requisição não estå correto. Verifique e forneça um ID vålido para tentar novamente.

required_properties

Certas propriedades obrigatĂłrias estĂŁo ausentes. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

unsupported_properties

Foi enviada uma propriedade que nĂŁo Ă© suportada. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

minimum_properties

O nĂșmero mĂ­nimo de propriedades necessĂĄrias para executar a solicitação nĂŁo foi enviado. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

property_type

Um tipo de propriedade incorreto foi enviado. Por exemplo, um valor 'integer' para uma propriedade 'string'. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

minimum_items

O nĂșmero mĂ­nimo de itens para alguma propriedade nĂŁo foi enviado. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

maximum_items

Foi enviado um nĂșmero de itens maior do que o permitido para alguma propriedade. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

property_value

Um valor invĂĄlido foi enviado para alguma propriedade. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

json_syntax_error

Um JSON invĂĄlido foi enviado. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

invalid_properties

InformaçÔes incorretas foram enviadas. Verifique a mensagem retornada nos detahles do erro para identificar o problema e tente novamente.

exceeded_number_of_transactions

Ocorreu um erro na requisição. A order aceita, no måximo, duas transaçÔes. Remova as transaçÔes excedentes.

401Erro. Access Token nĂŁo autorizado.

401

O Access Token enviado estå incorreto. Revise o valor e tente enviar a requisição novamente com a informação correta.

404Error. Order nĂŁo encontrada.

order_not_found

Order nĂŁo encontrada. Verifique se o ID enviado estĂĄ correto.

409Alguma regra específica do sistema não permite a realização da ação devido a restriçÔes definidas.

idempotency_key_already_used

O valor enviado como header de idempotĂȘncia jĂĄ foi utilizado. Por favor, tente a solicitação novamente enviando um novo valor.

500Erro.

idempotency_validation_failed

Falha na validação. Tente enviar a solicitação novamente.

500

Erro genérico. Tente enviar a solicitação novamente.

Requisição
curl -X POST \
    'https://api.mercadopago.com/v1/orders/{order_id}/transactions'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    -d '{
  "payments": [
    {
      "amount": "24.90",
      "payment_method": {
        "id": "visa",
        "type": "credit_card",
        "token": "12345",
        "installments": 1,
        "statement_descriptor": "approved"
      }
    }
  ]
}'
Resposta de exemplo
{
  "payments": [
    {
      "id": "pay_01J67CQQH5904WDBVZEM4JMEP3",
      "amount": "24.90",
      "status": "processed",
      "status_detail": "accredited",
      "payment_method": {
        "id": "visa",
        "type": "credit_card",
        "token": "12345",
        "installments": 1,
        "statement_descriptor": "approved"
      }
    }
  ]
}