Relatórios de pagamentos

Permite obter o detalhe das notas fiscais do vendedor abonadas em um determinado período.

Parâmetros:

• expiration_date: período em que deseja obter detalhe. (Formato: YYYY-mm-dd)
• sort_by: Valores possíveis: DATE,ID. Valor padrão: DATE.
• order_by: Permite ordenar as buscas. Valores possíveis: ASC, DESC. Valor padrão: ASC.
• offset: permite buscar desde um número de resultado adiante. O valor mínimo permitido é 0 e o valor máximo permitido é 10000. Por padrão o valor é 0.
• limit: limita a quantidade de resultado, O valor mínimo permitido é 1 e o valor máximo permitido é 1000. Por padrão o valor é 150.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/periods/key/$KEY/group/ML/payment/details

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/periods/key/2023-08-01/group/ML/payment/details?limit=1

Resposta:

"payment_info": {
               "payment_id": "11111111111",
               "credit_note_number": null,
               "payment_date": "2023-12-06T19:43:32",
               "payment_type": "collections_forced",
               "payment_type_description": "Pagos con débito automático",
               "payment_method": "account_money",
               "payment_method_description": "Mercado Pago",
               "payment_status": "approved",
               "payment_status_description": "Aplicado",
               "payment_amount": 30000.5,
               "amount_in_this_period": 500.32,
               "amount_in_other_period": 300.18,
               "remaining_amount": 0,
               "return_amount": 200
           }

Campos de resposta

• payment_id: número de pagamento.
• credit_note_number: número de nota de crédito (se corresponde).
• payment_date: data do pagamento.
• payment_type_description: Descrição do tipo de pagamento.
• payment_type: tipo de pagamento.
• payment_method_description: descrição do método de pagamento.
• payment_method: método de pagamento.
• payment_status_description: descrição do estado do pagamento.
• payment_status: estado do pagamento.
• payment_amount: importe total do pagamento.
• amount_in_this_period: importe aplicado neste período.
• amount_in_other_period: importe aplicado em outro período.
• remaining_amount: saldo a favor para próximas notas fiscais.
• return_amount: saldo a favor que o vendedor possui. Só será exibido quando o valor for maior que zero.

Detalhes do pagamento

Acesse os detalhes das cobranças e recebimentos correspondentes a um pagamento específico.

Parâmetros opcionais:
sort_by: permite que você selecione por qual campo classificar. Valores possíveis: DATE
order_by: permite que você classifique a pesquisa.
asc: classifica os resultados em ordem crescente (valor padrão)
desc: classifica os resultados em ordem decrescente. Ex: date_sort=asc
offset: permite pesquisar a partir de um número de resultado Ex: offset=100 (retorna a partir do número de resultado 100).
limit: limita o número de resultados. Por padrão o mínimo é 150. Valor máximo permitido: 1000. Ex: limite=300 (retorna até 300 resultados).

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/payment/$PAYMENT_ID/charges

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/payment/11111111111/charges

Resposta:

"payment_details": [
              {
	"payment_info": {
               "payment_id": "11111111111",
               "payment_date": "aaaa-mm-ddThh:mm:ss",
               "association_amount": 4500,
               "payment_amount": 999999,99
           },
       "charge_info": {
               "detail_id": 999999999,
               "detail_description": "xxxxxxxxxxx",               
               "detail_date": "aaaa-mm-ddThh:mm:ss"
           }
                }
]

Campos de resposta

payment_id: identificador de pagamento.
payment_date: data de pagamento.
association_amount: parte do pagamento aplicada a cobranças ou impostos.
payment_amount: valor do pagamento aplicado a taxas ou impostos.
detail_id: Id da cobrança.
detail_description: descrição das cobranças.
detail_date: data da cobrança.

Seguinte: Baixar documento legal.