Cashfree Upgrade Advisor (SDK & API Version Migration)

Plans Cashfree SDK and x-api-version upgrades with breaking-change analysis and migration diffs.

Updated Sep 8, 2026
One-click install
npx skills add https://github.com/dasara-varun/orange --skill cashfree-upgrade-advisor-sdk-api-version-migration-dasara-varun
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Cashfree Upgrade Advisor (SDK & API Version Migration)
Source: https://github.com/dasara-varun/orange/tree/main/.cursor/cashfree-skills/upgrade-advisor
Command: npx skills add https://github.com/dasara-varun/orange --skill cashfree-upgrade-advisor-sdk-api-version-migration-dasara-varun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Upgrading a Cashfree SDK or REST API version without knowing what breaks between versions leads to failed payments, broken webhook handling, and runtime errors. This Skill detects your current Cashfree version from project manifests, reads the changelog skill's version timelines, and produces an ordered migration plan covering both the SDK version and the x-api-version axes. ## Core Features & Use Cases - Automatic Version Detection: Reads package.json, requirements.txt, pom.xml, go.mod, composer.json, .csproj, Podfile, and pubspec.yaml to identify the installed Cashfree SDK and call style without asking the user. - Dual-Axis Breaking Change Analysis: Collects every breaking change between current and target versions across both the SDK version axis and the x-api-version axis, ordered oldest to newest. - Structured Migration Report: Outputs a summary, ordered breaking changes with sources, before/after code diffs, a test checklist, backward-compatibility warnings, and undocumented gaps requiring manual validation. - Use Case: A developer on cashfree-pg 4.0.0 (Node) asks to upgrade to the latest. The Skill detects the legacy static call style, walks through the 5.0.0 constructor change and the 6.0.x spec bump, flags that the SDK default x-api-version 2026-01-01 is ahead of the published REST version 2025-01-01, and delivers a step-by-step plan with diffs. ## Quick Start Ask the assistant to plan an upgrade of your Cashfree integration, for example: upgrade cashfree-pg from 4.x to the latest version and tell me what will break.

Frequently Asked Questions about Cashfree Upgrade Advisor (SDK & API Version Migration)

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade cashfree-pg from 4.x to 6.x?▼

Bump the dependency with npm i cashfree-pg@^6, then migrate from the legacy static call style to the instance client new Cashfree(env, id, secret) introduced in 5.0.0, dropping the version argument from calls. Also decide your x-api-version, since the v6 SDK defaults to 2026-01-01, ahead of the published REST version 2025-01-01.

How do I migrate my Cashfree x-api-version to a newer date?▼

Identify the x-api-version string passed to the SDK or sent on requests, then review the pg-api-versions changelog for breaking changes between your current and target versions. Pin the version explicitly, for example cashfree.XApiVersion = "2025-01-01", and validate response shapes against your own contract.

Does upgrading the Cashfree SDK change the API version automatically?▼

No, SDK version and x-api-version are independent axes. Bumping the SDK does not change the API version your requests use, though newer SDKs ship a default x-api-version that may be ahead of the published REST version, so you should pin it explicitly.

Why can't I install Cashfree SDK 6.x for .NET?▼

The .NET cashfree_pg package has no 6.x release on NuGet and tops out at 5.0.6. The upgrade plan must respect this registry ceiling and recommend the highest actually published version instead of an uninstallable target.

When should I not use the Cashfree upgrade advisor?▼

Do not use it for first-time Cashfree integrations, which belong to the product skills, or for switching from another gateway like Razorpay, Juspay, or PayU, which is handled by the migrate-from-* skills. It is strictly for intra-Cashfree version migration.