Recursos para IA
Consultar planos disponíveis

Retorna os planos de parcelamento disponíveis para os BINs de cartão e o valor do pedido informados.

PATCH

https://api.mercadopago.com/instore/v2/external/orders/{order_id}/plans
Request parameters
Header
Authorization
string

OBRIGATÓRIO

Bearer access token.
trace-id
string

OBRIGATÓRIO

Identificador de rastreabilidade.
Path
order_id
string

OBRIGATÓRIO

ID do pedido retornado pelo endpoint Resolve QR (order.id).
Body
bins
array
Lista de BINs de cartão a consultar.
amount
object
additional_info
object
Informações adicionais. Envie um objeto vazio {}.
Response parameters
supported_bins
array
unsupported_bins
array
Erros

404Não encontrado

500Erro interno do servidor

Request
curl -X PATCH \
    'https://api.mercadopago.com/instore/v2/external/orders/{order_id}/plans'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-' \
       -H 'trace-id: ' \
    -d '{
  "bins": [
    {
      "original_bin": "400103",
      "issuer_id": "310",
      "type": "CREDIT",
      "brand_id": "VISA"
    }
  ],
  "amount": {
    "value": 300.5,
    "currency": "ARS"
  }
}'
Response
{
  "supported_bins": [
    {
      "brand_id": "VISA",
      "type": "CREDIT",
      "original_bins": [
        "400103"
      ],
      "plans": [
        {
          "id": "000000",
          "type": "ahora",
          "description": "3 cuotas sin interés",
          "installments": 3,
          "total_amount": {
            "value": 300.5,
            "currency": "ARS"
          },
          "installment_amount": {
            "value": 100.17,
            "currency": "ARS"
          },
          "financial_info": {
            "total_financial_cost": "0.00",
            "nominal_annual_rate": "0.00"
          },
          "required_fields": []
        }
      ]
    }
  ],
  "unsupported_bins": [],
  "additional_info": null
}