Recursos para IA
Buscar em assinaturashttps://api.mercadopago.com/preapproval/search
Buscar assinaturas utilizando diferentes parâmetros.
GET
Request parameters
Header
Authorization
string
OBRIGATÓRIO
Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Path
q
string
Campo de busca livre.
payer_id
number
Customer ID único para encontrar assinaturas relacionadas.
payer_email
string
Permite encontrar assinaturas registradas com este e-mail.
preapproval_plan_id
string
Especifica um plan ID para filtrar os resultados da pesquisa.
Response parameters
paging
object
Informações para paginação dos resultados da pesquisa.
results
array
Página de ítens. Caso não retorne resultados, será um array vazio.
Erros
400Erro
400
Bad request
401Erro
401
Unauthorized
500Erro
500
Error
Request
curl -X GET \
'https://api.mercadopago.com/preapproval/search'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
Response
{
"paging": {
"offset": 0,
"limit": 20,
"total": 100
},
"results": [
{
"id": "2c938084726fca480172750000000000",
"version": 0,
"application_id": 1234567812345678,
"collector_id": 100200300,
"preapproval_plan_id": "2c938084726fca480172750000000000",
"reason": "Yoga classes.",
"external_reference": 23546246234,
"back_url": "https://www.mercadopago.com.ar",
"init_point": "https://www.mercadopago.com.ar/subscriptions/checkout?preapproval_id=2c938084726fca480172750000000000",
"auto_recurring": {
"frequency": 1,
"frequency_type": "months",
"start_date": "2020-06-02T13:07:14.260Z",
"end_date": "2022-07-20T15:59:52.581Z",
"currency_id": "COP",
"transaction_amount": "24.50",
"free_trial": {
"frequency": 1,
"frequency_type": "months"
}
},
"first_invoice_offset": 7,
"payer_id": 123123123,
"payer_first_name": "Sofia",
"payer_last_name": "Rodríguez",
"card_id": 123123123,
"payment_method_id": "master",
"next_payment_date": "2022-01-01T11:12:25.892-04:00",
"date_created": "2022-01-01T11:12:25.892-04:00",
"last_modified": "2022-01-01T11:12:25.892-04:00",
"summarized": {
"quotas": 6,
"charged_quantity": 3,
"charged_amount": "24.50",
"pending_charge_quantity": 1,
"pending_charge_amount": 200,
"last_charged_date": "2022-01-01T11:12:25.892-04:00",
"last_charged_amount": 100,
"semaphore": "green"
},
"status": "pending"
}
]
}