{
  "info": {
    "name": "Pine Labs MCP Server — 56 Tools",
    "description": "Postman collection for all 56 tools exposed by the Pine Labs MCP Server.\nCovers payment links, orders, refunds, settlements, card payments, UPI, payouts, subscriptions, reporting, analytics, and utility tools.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_postman_id": "pinelabs-mcp-56-tools"
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://pluraluat.v2.pinepg.in/api",
      "type": "string",
      "description": "Base URL. UAT: https://pluraluat.v2.pinepg.in/api | PROD: https://api.pluralpay.in/api"
    },
    {
      "key": "access_token",
      "value": "",
      "type": "string",
      "description": "Bearer token from Generate Token API"
    },
    {
      "key": "merchant_id",
      "value": "",
      "type": "string",
      "description": "Merchant ID for MCP reporting APIs"
    },
    {
      "key": "order_id",
      "value": "",
      "type": "string"
    },
    {
      "key": "payment_link_id",
      "value": "",
      "type": "string"
    },
    {
      "key": "payment_id",
      "value": "",
      "type": "string"
    },
    {
      "key": "payout_id",
      "value": "",
      "type": "string"
    },
    {
      "key": "plan_id",
      "value": "",
      "type": "string"
    },
    {
      "key": "subscription_id",
      "value": "",
      "type": "string"
    },
    {
      "key": "presentation_id",
      "value": "",
      "type": "string"
    },
    {
      "key": "transaction_id",
      "value": "",
      "type": "string"
    },
    {
      "key": "utr",
      "value": "",
      "type": "string"
    }
  ],
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{access_token}}",
        "type": "string"
      }
    ]
  },
  "item": [
    {
      "name": "Payment Links",
      "description": "Create and manage payment links (5 tools)",
      "item": [
        {
          "name": "Tool 1: create_payment_link",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "Request-Timestamp", "value": "{{$isoTimestamp}}" },
              { "key": "Request-ID", "value": "{{$guid}}" }
            ],
            "url": {
              "raw": "{{base_url}}/pay/v1/paymentlink",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "paymentlink"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": {\n    \"value\": 50000,\n    \"currency\": \"INR\"\n  },\n  \"merchant_payment_link_reference\": \"ref-{{$randomInt}}\",\n  \"description\": \"Test payment link\",\n  \"allowed_payment_methods\": [\"CARD\", \"UPI\", \"NETBANKING\", \"WALLET\"],\n  \"callback_url\": \"https://example.com/callback\",\n  \"customer\": {\n    \"email_id\": \"test@example.com\",\n    \"first_name\": \"Test\",\n    \"last_name\": \"User\",\n    \"mobile_number\": \"9876543210\",\n    \"country_code\": \"+91\"\n  }\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Create a new payment link. Amount in smallest currency unit (paisa for INR). Max expiry 180 days."
          }
        },
        {
          "name": "Tool 2: get_payment_link_by_id",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/paymentlink/{{payment_link_id}}",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "paymentlink", "{{payment_link_id}}"]
            },
            "description": "Retrieve payment link details by payment link ID."
          }
        },
        {
          "name": "Tool 3: get_payment_link_by_merchant_reference",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/paymentlink/ref/:merchant_payment_link_reference",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "paymentlink", "ref", ":merchant_payment_link_reference"],
              "variable": [
                {
                  "key": "merchant_payment_link_reference",
                  "value": "",
                  "description": "Merchant payment link reference"
                }
              ]
            },
            "description": "Retrieve payment link details by merchant reference."
          }
        },
        {
          "name": "Tool 4: cancel_payment_link",
          "request": {
            "method": "PUT",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/paymentlink/{{payment_link_id}}/cancel",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "paymentlink", "{{payment_link_id}}", "cancel"]
            },
            "description": "Cancel a payment link. Only CREATED links can be cancelled."
          }
        },
        {
          "name": "Tool 5: resend_payment_link_notification",
          "request": {
            "method": "PATCH",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/paymentlink/{{payment_link_id}}/notify",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "paymentlink", "{{payment_link_id}}", "notify"]
            },
            "description": "Resend payment link notification. Only for active (CREATED) links."
          }
        }
      ]
    },
    {
      "name": "Orders",
      "description": "Create, retrieve, cancel, and capture orders (4 tools)",
      "item": [
        {
          "name": "Tool 6: create_order",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/checkout/v1/orders",
              "host": ["{{base_url}}"],
              "path": ["checkout", "v1", "orders"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"merchant_order_reference\": \"order-{{$randomInt}}\",\n  \"order_amount\": {\n    \"value\": 50000,\n    \"currency\": \"INR\"\n  },\n  \"integration_mode\": \"REDIRECT\",\n  \"pre_auth\": false,\n  \"allowed_payment_methods\": [\"CARD\", \"UPI\", \"NETBANKING\", \"WALLET\"],\n  \"callback_url\": \"https://example.com/callback\",\n  \"purchase_details\": {\n    \"customer\": {\n      \"email_id\": \"test@example.com\",\n      \"first_name\": \"Test\",\n      \"last_name\": \"User\",\n      \"mobile_number\": \"9876543210\",\n      \"country_code\": \"+91\"\n    }\n  }\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Create a hosted checkout order with redirect URL."
          }
        },
        {
          "name": "Tool 7: get_order_by_order_id",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/orders/{{order_id}}",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "orders", "{{order_id}}"]
            },
            "description": "Retrieve order details by order ID."
          }
        },
        {
          "name": "Tool 8: cancel_order",
          "request": {
            "method": "PUT",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/orders/{{order_id}}/cancel",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "orders", "{{order_id}}", "cancel"]
            },
            "description": "Cancel a pre-authorized order."
          }
        },
        {
          "name": "Tool 9: capture_order",
          "request": {
            "method": "PUT",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/pay/v1/orders/{{order_id}}/capture",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "orders", "{{order_id}}", "capture"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": {\n    \"value\": 50000,\n    \"currency\": \"INR\"\n  }\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Capture an authorized order to complete the transaction."
          }
        }
      ]
    },
    {
      "name": "Refunds",
      "description": "Initiate refunds for processed orders (1 tool)",
      "item": [
        {
          "name": "Tool 10: create_refund",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/pay/v1/orders/{{order_id}}/refund",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "orders", "{{order_id}}", "refund"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"merchant_order_reference\": \"refund-{{$randomInt}}\",\n  \"order_amount\": {\n    \"value\": 10000,\n    \"currency\": \"INR\"\n  }\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Create a full or partial refund for a processed order."
          }
        }
      ]
    },
    {
      "name": "Settlements",
      "description": "Retrieve settlement details (2 tools)",
      "item": [
        {
          "name": "Tool 11: get_all_settlements",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/settlements?start_date=2025-01-01&end_date=2025-01-31&page=1&per_page=20",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "settlements"],
              "query": [
                { "key": "start_date", "value": "2025-01-01", "description": "Start date (YYYY-MM-DD)" },
                { "key": "end_date", "value": "2025-01-31", "description": "End date (YYYY-MM-DD)" },
                { "key": "page", "value": "1" },
                { "key": "per_page", "value": "20" }
              ]
            },
            "description": "Get all settlements within a date range."
          }
        },
        {
          "name": "Tool 12: get_settlement_by_utr",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/settlements/{{utr}}",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "settlements", "{{utr}}"]
            },
            "description": "Get settlement details by UTR (Unique Transaction Reference)."
          }
        }
      ]
    },
    {
      "name": "Order Payments",
      "description": "Fetch payments for an order (1 tool)",
      "item": [
        {
          "name": "Tool 13: fetch_order_payments",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/orders/{{order_id}}/payments",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "orders", "{{order_id}}", "payments"]
            },
            "description": "Retrieve all payments associated with an order."
          }
        }
      ]
    },
    {
      "name": "Card Payments",
      "description": "Card payment creation, card details, and OTP flows (5 tools)",
      "item": [
        {
          "name": "Tool 14: create_card_payment",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/pay/v1/orders/{{order_id}}/payments/card",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "orders", "{{order_id}}", "payments", "card"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"card_number\": \"4111111111111111\",\n  \"expiry_month\": \"12\",\n  \"expiry_year\": \"2028\",\n  \"card_holder_name\": \"Test User\",\n  \"cvv\": \"123\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Create a card payment for an existing order."
          }
        },
        {
          "name": "Tool 15: get_card_details",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/pay/v1/orders/{{order_id}}/payments/card/details",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "orders", "{{order_id}}", "payments", "card", "details"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"card_number\": \"411111\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Get card BIN details for validation."
          }
        },
        {
          "name": "Tool 16: generate_otp",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/orders/{{order_id}}/payments/{{payment_id}}/otp/generate",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "orders", "{{order_id}}", "payments", "{{payment_id}}", "otp", "generate"]
            },
            "description": "Generate OTP for 3DS card payment authentication."
          }
        },
        {
          "name": "Tool 17: submit_otp",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/pay/v1/orders/{{order_id}}/payments/{{payment_id}}/otp/submit",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "orders", "{{order_id}}", "payments", "{{payment_id}}", "otp", "submit"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"otp\": \"123456\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Submit OTP to complete 3DS card payment."
          }
        },
        {
          "name": "Tool 18: resend_otp",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/orders/{{order_id}}/payments/{{payment_id}}/otp/resend",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "orders", "{{order_id}}", "payments", "{{payment_id}}", "otp", "resend"]
            },
            "description": "Resend OTP for 3DS card payment authentication."
          }
        }
      ]
    },
    {
      "name": "UPI Payments",
      "description": "UPI intent payment with QR code (1 tool)",
      "item": [
        {
          "name": "Tool 19: create_upi_intent_payment_with_qr",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/orders/{{order_id}}/payments/upi/intent/qr",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "orders", "{{order_id}}", "payments", "upi", "intent", "qr"]
            },
            "description": "Create a UPI intent payment with QR code. The MCP tool first creates an order, then calls this endpoint."
          }
        }
      ]
    },
    {
      "name": "Payouts",
      "description": "Create and manage payouts (6 tools)",
      "item": [
        {
          "name": "Tool 20: create_payout",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/pay/v1/payouts",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "payouts"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": {\n    \"value\": 100000,\n    \"currency\": \"INR\"\n  },\n  \"beneficiary\": {\n    \"name\": \"Test Beneficiary\",\n    \"account_number\": \"1234567890\",\n    \"ifsc\": \"SBIN0001234\"\n  },\n  \"merchant_payout_reference\": \"payout-{{$randomInt}}\",\n  \"payout_mode\": \"IMPS\",\n  \"narration\": \"Test payout\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Create a bank payout (IMPS/NEFT/RTGS/UPI)."
          }
        },
        {
          "name": "Tool 21: cancel_payout",
          "request": {
            "method": "PUT",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/payouts/{{payout_id}}/cancel",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "payouts", "{{payout_id}}", "cancel"]
            },
            "description": "Cancel a scheduled payout."
          }
        },
        {
          "name": "Tool 22: update_payout",
          "request": {
            "method": "PUT",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/pay/v1/payouts/{{payout_id}}/update",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "payouts", "{{payout_id}}", "update"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"scheduled_date\": \"2025-12-31\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Update the scheduled date of a payout."
          }
        },
        {
          "name": "Tool 23: get_payout_details",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/payouts?start_date=2025-01-01&end_date=2025-01-31&page=1&per_page=20",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "payouts"],
              "query": [
                { "key": "start_date", "value": "2025-01-01" },
                { "key": "end_date", "value": "2025-01-31" },
                { "key": "page", "value": "1" },
                { "key": "per_page", "value": "20" }
              ]
            },
            "description": "Get payout details within a date range."
          }
        },
        {
          "name": "Tool 24: get_payout_balance",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/payouts/balance",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "payouts", "balance"]
            },
            "description": "Retrieve the current payout account balance."
          }
        },
        {
          "name": "Tool 25: get_payout_payments",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/pay/v1/payouts/payments?start_date=2025-01-01&end_date=2025-01-31&page=1&per_page=20",
              "host": ["{{base_url}}"],
              "path": ["pay", "v1", "payouts", "payments"],
              "query": [
                { "key": "start_date", "value": "2025-01-01" },
                { "key": "end_date", "value": "2025-01-31" },
                { "key": "status", "value": "", "disabled": true },
                { "key": "page", "value": "1" },
                { "key": "per_page", "value": "20" }
              ]
            },
            "description": "List and filter payout records."
          }
        }
      ]
    },
    {
      "name": "Subscriptions — Plans",
      "description": "Create, update, delete, and retrieve subscription plans (6 tools)",
      "item": [
        {
          "name": "Tool 26: create_plan",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/v1/public/plans",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "plans"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"plan_name\": \"Monthly Plan\",\n  \"frequency\": \"MONTHLY\",\n  \"amount\": {\n    \"value\": 99900,\n    \"currency\": \"INR\"\n  },\n  \"max_limit_amount\": {\n    \"value\": 999900,\n    \"currency\": \"INR\"\n  },\n  \"end_date\": \"2026-12-31T23:59:59Z\",\n  \"merchant_plan_reference\": \"plan-{{$randomInt}}\",\n  \"plan_description\": \"Monthly subscription plan\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Create a new subscription plan."
          }
        },
        {
          "name": "Tool 27: update_plan",
          "request": {
            "method": "PATCH",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/v1/public/plans/{{plan_id}}",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "plans", "{{plan_id}}"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"plan_name\": \"Updated Plan Name\",\n  \"plan_description\": \"Updated description\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Update a subscription plan."
          }
        },
        {
          "name": "Tool 28: delete_plan",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/public/plans/{{plan_id}}",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "plans", "{{plan_id}}"]
            },
            "description": "Delete a subscription plan."
          }
        },
        {
          "name": "Tool 29: get_plans",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/public/plans?page=1&size=20",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "plans"],
              "query": [
                { "key": "plan_id", "value": "", "disabled": true },
                { "key": "start_date", "value": "", "disabled": true },
                { "key": "end_date", "value": "", "disabled": true },
                { "key": "frequency", "value": "", "disabled": true },
                { "key": "page", "value": "1" },
                { "key": "size", "value": "20" },
                { "key": "sort", "value": "", "disabled": true }
              ]
            },
            "description": "List subscription plans with optional filters."
          }
        },
        {
          "name": "Tool 30: get_plan_by_id",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/public/plans/{{plan_id}}",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "plans", "{{plan_id}}"]
            },
            "description": "Retrieve a subscription plan by plan ID."
          }
        },
        {
          "name": "Tool 31: get_plan_by_merchant_reference",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/public/plans/reference/:merchant_plan_reference",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "plans", "reference", ":merchant_plan_reference"],
              "variable": [
                {
                  "key": "merchant_plan_reference",
                  "value": "",
                  "description": "Merchant plan reference"
                }
              ]
            },
            "description": "Retrieve a plan by merchant plan reference."
          }
        }
      ]
    },
    {
      "name": "Subscriptions — Management",
      "description": "Create, pause, resume, cancel, update, and retrieve subscriptions (8 tools)",
      "item": [
        {
          "name": "Tool 32: create_subscription",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/v1/public/subscriptions",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "subscriptions"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"merchant_subscription_reference\": \"sub-{{$randomInt}}\",\n  \"plan_id\": \"{{plan_id}}\",\n  \"start_date\": \"2025-06-01T00:00:00Z\",\n  \"end_date\": \"2026-06-01T00:00:00Z\",\n  \"customer_id\": \"cust-123\",\n  \"integration_mode\": \"REDIRECT\",\n  \"callback_url\": \"https://example.com/callback\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Create a new subscription linked to a plan."
          }
        },
        {
          "name": "Tool 33: update_subscription",
          "request": {
            "method": "PATCH",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/v1/public/subscriptions/{{subscription_id}}",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "subscriptions", "{{subscription_id}}"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reason\": \"Plan upgrade\",\n  \"new_plan_id\": \"new-plan-id\",\n  \"new_end_date\": \"2027-01-01T00:00:00Z\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Update a subscription's plan or end date."
          }
        },
        {
          "name": "Tool 34: pause_subscription",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/public/subscriptions/{{subscription_id}}/pause",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "subscriptions", "{{subscription_id}}", "pause"]
            },
            "description": "Pause an active subscription."
          }
        },
        {
          "name": "Tool 35: resume_subscription",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/public/subscriptions/{{subscription_id}}/resume",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "subscriptions", "{{subscription_id}}", "resume"]
            },
            "description": "Resume a paused subscription."
          }
        },
        {
          "name": "Tool 36: cancel_subscription",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/public/subscriptions/{{subscription_id}}/cancel",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "subscriptions", "{{subscription_id}}", "cancel"]
            },
            "description": "Cancel an active or paused subscription."
          }
        },
        {
          "name": "Tool 37: get_subscriptions",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/public/subscriptions?page=1&size=20",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "subscriptions"],
              "query": [
                { "key": "plan_id", "value": "", "disabled": true },
                { "key": "status", "value": "", "disabled": true },
                { "key": "start_date", "value": "", "disabled": true },
                { "key": "end_date", "value": "", "disabled": true },
                { "key": "frequency", "value": "", "disabled": true },
                { "key": "page", "value": "1" },
                { "key": "size", "value": "20" },
                { "key": "sort", "value": "", "disabled": true }
              ]
            },
            "description": "List subscriptions with optional filters."
          }
        },
        {
          "name": "Tool 38: get_subscription_by_id",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/public/subscriptions/{{subscription_id}}",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "subscriptions", "{{subscription_id}}"]
            },
            "description": "Retrieve a subscription by ID."
          }
        },
        {
          "name": "Tool 39: get_subscription_by_merchant_reference",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/public/subscriptions/reference/:merchant_subscription_reference",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "subscriptions", "reference", ":merchant_subscription_reference"],
              "variable": [
                {
                  "key": "merchant_subscription_reference",
                  "value": "",
                  "description": "Merchant subscription reference"
                }
              ]
            },
            "description": "Retrieve a subscription by merchant reference."
          }
        }
      ]
    },
    {
      "name": "Subscriptions — Presentations",
      "description": "Manage presentation (debit) requests for subscriptions (5 tools)",
      "item": [
        {
          "name": "Tool 40: create_presentation",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/v1/public/subscriptions/{{subscription_id}}/presentations",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "subscriptions", "{{subscription_id}}", "presentations"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"due_date\": \"2025-07-01T00:00:00Z\",\n  \"amount\": {\n    \"value\": 99900,\n    \"currency\": \"INR\"\n  },\n  \"merchant_presentation_reference\": \"pres-{{$randomInt}}\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Submit a mandate debit request (presentation)."
          }
        },
        {
          "name": "Tool 41: delete_presentation",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/public/presentations/{{presentation_id}}",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "presentations", "{{presentation_id}}"]
            },
            "description": "Delete a presentation."
          }
        },
        {
          "name": "Tool 42: get_presentation",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/public/presentations/{{presentation_id}}",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "presentations", "{{presentation_id}}"]
            },
            "description": "Retrieve presentation details by ID."
          }
        },
        {
          "name": "Tool 43: get_presentations_by_subscription_id",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/public/subscriptions/{{subscription_id}}/presentations?page=1&size=20",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "subscriptions", "{{subscription_id}}", "presentations"],
              "query": [
                { "key": "page", "value": "1" },
                { "key": "size", "value": "20" },
                { "key": "sort", "value": "", "disabled": true }
              ]
            },
            "description": "List all presentations for a subscription."
          }
        },
        {
          "name": "Tool 44: get_presentation_by_merchant_reference",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/public/presentations/reference/:merchant_presentation_reference",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "presentations", "reference", ":merchant_presentation_reference"],
              "variable": [
                {
                  "key": "merchant_presentation_reference",
                  "value": "",
                  "description": "Merchant presentation reference"
                }
              ]
            },
            "description": "Retrieve presentation by merchant reference."
          }
        }
      ]
    },
    {
      "name": "Subscriptions — Debits & Notifications",
      "description": "Notifications, debits, and merchant retries (3 tools)",
      "item": [
        {
          "name": "Tool 45: send_subscription_notification",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/v1/public/subscriptions/notify",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "subscriptions", "notify"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"subscription_id\": \"{{subscription_id}}\",\n  \"due_date\": \"2025-07-01T00:00:00Z\",\n  \"amount\": {\n    \"value\": 99900,\n    \"currency\": \"INR\"\n  },\n  \"merchant_presentation_reference\": \"notif-{{$randomInt}}\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Send a pre-debit notification for a subscription."
          }
        },
        {
          "name": "Tool 46: create_debit",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/v1/public/subscriptions/execute",
              "host": ["{{base_url}}"],
              "path": ["v1", "public", "subscriptions", "execute"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"presentation_id\": \"{{presentation_id}}\",\n  \"merchant_presentation_reference\": \"debit-{{$randomInt}}\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Execute a mandate debit against a subscription."
          }
        },
        {
          "name": "Tool 47: create_merchant_retry",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/v1/mandate/merchant-retry",
              "host": ["{{base_url}}"],
              "path": ["v1", "mandate", "merchant-retry"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"presentation_id\": \"{{presentation_id}}\",\n  \"merchant_presentation_reference\": \"retry-{{$randomInt}}\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Retry mandate execution. Max 3 retries."
          }
        }
      ]
    },
    {
      "name": "MCP Reporting",
      "description": "Date-range reports for payment links, orders, refunds, and transaction search (4 tools)",
      "item": [
        {
          "name": "Tool 48: get_payment_link_details",
          "request": {
            "method": "GET",
            "header": [
              { "key": "merchant-id", "value": "{{merchant_id}}" }
            ],
            "url": {
              "raw": "{{base_url}}/mcp/v1/payment-link/details?start_date=2025-01-01T00:00:00Z&end_date=2025-01-31T23:59:59Z&page=1&per_page=20",
              "host": ["{{base_url}}"],
              "path": ["mcp", "v1", "payment-link", "details"],
              "query": [
                { "key": "start_date", "value": "2025-01-01T00:00:00Z" },
                { "key": "end_date", "value": "2025-01-31T23:59:59Z" },
                { "key": "page", "value": "1" },
                { "key": "per_page", "value": "20" }
              ]
            },
            "description": "Fetch payment link details report. Max 60-day range. Requires merchant-id header."
          }
        },
        {
          "name": "Tool 49: get_order_details",
          "request": {
            "method": "GET",
            "header": [
              { "key": "merchant-id", "value": "{{merchant_id}}" }
            ],
            "url": {
              "raw": "{{base_url}}/mcp/v1/order/details?start_date=2025-01-01T00:00:00Z&end_date=2025-01-31T23:59:59Z&page=1&per_page=20",
              "host": ["{{base_url}}"],
              "path": ["mcp", "v1", "order", "details"],
              "query": [
                { "key": "start_date", "value": "2025-01-01T00:00:00Z" },
                { "key": "end_date", "value": "2025-01-31T23:59:59Z" },
                { "key": "page", "value": "1" },
                { "key": "per_page", "value": "20" }
              ]
            },
            "description": "Fetch order details report. Max 60-day range. Requires merchant-id header."
          }
        },
        {
          "name": "Tool 50: get_refund_order_details",
          "request": {
            "method": "GET",
            "header": [
              { "key": "merchant-id", "value": "{{merchant_id}}" }
            ],
            "url": {
              "raw": "{{base_url}}/mcp/v1/refund/order/details?start_date=2025-01-01T00:00:00Z&end_date=2025-01-31T23:59:59Z&page=1&per_page=20",
              "host": ["{{base_url}}"],
              "path": ["mcp", "v1", "refund", "order", "details"],
              "query": [
                { "key": "start_date", "value": "2025-01-01T00:00:00Z" },
                { "key": "end_date", "value": "2025-01-31T23:59:59Z" },
                { "key": "page", "value": "1" },
                { "key": "per_page", "value": "20" }
              ]
            },
            "description": "Fetch refund order details report. Max 60-day range. Requires merchant-id header."
          }
        },
        {
          "name": "Tool 51: search_transaction",
          "request": {
            "method": "GET",
            "header": [
              { "key": "merchant-id", "value": "{{merchant_id}}" }
            ],
            "url": {
              "raw": "{{base_url}}/mcp/v1/search/transaction/{{transaction_id}}",
              "host": ["{{base_url}}"],
              "path": ["mcp", "v1", "search", "transaction", "{{transaction_id}}"]
            },
            "description": "Search for a transaction by transaction ID. Requires merchant-id header."
          }
        }
      ]
    },
    {
      "name": "Analytics",
      "description": "Merchant transaction success rate (1 tool)",
      "item": [
        {
          "name": "Tool 52: get_merchant_success_rate",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/mcp/v1/merchant/transactions/success-rate?start_date=5 hours ago&end_date=now",
              "host": ["{{base_url}}"],
              "path": ["mcp", "v1", "merchant", "transactions", "success-rate"],
              "query": [
                { "key": "start_date", "value": "5 hours ago", "description": "Natural language or YYYY-MM-DD HH:MM:SS" },
                { "key": "end_date", "value": "now", "description": "Natural language or YYYY-MM-DD HH:MM:SS. Default: now" }
              ]
            },
            "description": "Fetch transaction success rate. Max 7-day range. Supports natural-language dates."
          }
        }
      ]
    },
    {
      "name": "MCP Utility",
      "description": "Documentation, API listing, stack detection, and checkout integration (4 tools). These are MCP-internal tools.",
      "item": [
        {
          "name": "Tool 53: get_api_documentation",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/mcp/internal/get-api-documentation",
              "host": ["{{base_url}}"],
              "path": ["mcp", "internal", "get-api-documentation"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"api_name\": \"payment-link-create\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Fetch Pine Labs API documentation for a specific API. MCP-internal tool."
          }
        },
        {
          "name": "Tool 54: list_pinelabs_apis",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/mcp/internal/list-pinelabs-apis",
              "host": ["{{base_url}}"],
              "path": ["mcp", "internal", "list-pinelabs-apis"]
            },
            "description": "List all available Pine Labs APIs. MCP-internal tool."
          }
        },
        {
          "name": "Tool 55: detect_stack",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/mcp/internal/detect-stack",
              "host": ["{{base_url}}"],
              "path": ["mcp", "internal", "detect-stack"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"project_path\": \"/path/to/project\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Detect the technology stack of a project. MCP-internal tool."
          }
        },
        {
          "name": "Tool 56: integrate_pinelabs_checkout",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" }
            ],
            "url": {
              "raw": "{{base_url}}/mcp/internal/integrate-pinelabs-checkout",
              "host": ["{{base_url}}"],
              "path": ["mcp", "internal", "integrate-pinelabs-checkout"]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"stack\": \"React\",\n  \"integration_mode\": \"REDIRECT\"\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Generate checkout integration code tailored to your tech stack. MCP-internal tool."
          }
        }
      ]
    }
  ]
}