go-fintech-india · v0.2.5

package main

import (
	"fmt"
	fintechin "github.com/umesh0492/go-fintech-india"
)

func main() {
	// 100 Rupees = 10,000 paise
	total := fintechin.NewMoneyFromRupees(100)

	// Split 100 rupees evenly among 3 parties
	// Standard division would drop 1 paisa (33.33 * 3 = 99.99).
	// fintechin.Split distributes remainder paise so sum == total.
	parts, _ := total.Split(3)
	for i, part := range parts {
		fmt.Printf("Party %d: %s (%d paise)\n", i+1, part.String(), part.Paise())
	}
	// Output:
	// Party 1: 33.34 (3334 paise)
	// Party 2: 33.33 (3333 paise)
	// Party 3: 33.33 (3333 paise)

	// Proportional allocation (e.g. 50%, 30%, 20%)
	allocated, _ := total.Allocate(50, 30, 20)
	fmt.Printf("Allocated 50%%: %s, 30%%: %s, 20%%: %s\n",
		allocated[0].String(), allocated[1].String(), allocated[2].String())
}

package main

import (
	"fmt"
	fintechin "github.com/umesh0492/go-fintech-india"
)

func main() {
	amount, _ := fintechin.ParseINR("₹12,34,567.89")

	// Print amount in words for cheques per Indian banking conventions
	chequeText := fintechin.InWords(amount)
	fmt.Println(chequeText)
	// Output:
	// Rupees Twelve Lakh Thirty-Four Thousand Five Hundred Sixty-Seven and Eighty-Nine Paise Only

	// Standard number to words
	fmt.Println(fintechin.NumberToIndianWords(10000000))
	// Output: One Crore
}

package main

import (
	"fmt"
	fintechin "github.com/umesh0492/go-fintech-india"
)

func main() {
	gstin := "29AACCG0527D1Z0"

	if err := fintechin.ValidateGSTIN(gstin); err != nil {
		fmt.Println("Invalid GSTIN:", err)
		return
	}

	stateName, _ := fintechin.StateName(fintechin.StateCode(gstin))
	pan := fintechin.ExtractPAN(gstin)

	fmt.Printf("Valid GSTIN for State: %s (State Code %s), Embedded PAN: %s\n",
		stateName, fintechin.StateCode(gstin), pan)
	// Output:
	// Valid GSTIN for State: Karnataka (State Code 29), Embedded PAN: AACCG0527D
}

package main

import (
	"fmt"
	fintechin "github.com/umesh0492/go-fintech-india"
)

func main() {
	aadhaar := "999941057058"

	// Validates length, non 0/1 start, and Verhoeff dihedral D5 checksum
	if err := fintechin.ValidateAadhaar(aadhaar); err != nil {
		fmt.Println("Invalid Aadhaar:", err)
		return
	}

	// Mask for storage and display (statutory compliance)
	masked := fintechin.MaskAadhaar(aadhaar)
	formatted := fintechin.FormatAadhaar(aadhaar)

	fmt.Printf("Aadhaar Valid: Masked=%s, Formatted=%s\n", masked, formatted)
	// Output:
	// Aadhaar Valid: Masked=XXXX-XXXX-7058, Formatted=9999 4105 7058
}

package main

import (
	"fmt"
	fintechin "github.com/umesh0492/go-fintech-india"
)

func main() {
	pan := "ABCDE1234F"

	if err := fintechin.ValidatePAN(pan); err != nil {
		fmt.Println("Invalid PAN:", err)
		return
	}

	entity, _ := fintechin.EntityType(pan)
	fmt.Printf("Entity Type: %s\n", entity) // Output: Entity Type: Company

	// Individual PAN example: 4th char is 'P', 5th char is first letter of surname
	indPAN := "ABCDS1234F"
	isSharma := fintechin.MatchesSurname(indPAN, "Sharma")
	fmt.Printf("Matches surname Sharma: %t\n", isSharma) // Output: true

	fmt.Printf("Masked PAN: %s\n", fintechin.MaskPAN(indPAN)) // Output: XXXXX1234X
}

package main

import (
	"fmt"
	fintechin "github.com/umesh0492/go-fintech-india"
)

func main() {
	params := fintechin.UPIParams{
		PayeeAddress: "merchant@okhdfcbank",
		PayeeName:    "SuperStore Enterprises",
		Amount:       "1499.50",
		Note:         "Order #98234",
		RefID:        "TXN98234001",
	}

	// Generate compliant NPCI upi://pay URI
	uri, err := fintechin.GenerateUPIURI(params)
	if err != nil {
		fmt.Println("Error:", err)
		return
	}
	fmt.Println("UPI Intent URI / QR Payload:")
	fmt.Println(uri)
	// Output:
	// upi://pay?am=1499.50&cu=INR&pa=merchant%40okhdfcbank&pn=SuperStore+Enterprises&tn=Order+%2398234&tr=TXN98234001
}

package main

import (
	"fmt"
	"time"
	fintechin "github.com/umesh0492/go-fintech-india"
)

func main() {
	fy := fintechin.FYFromDate(time.Date(2025, time.August, 15, 0, 0, 0, 0, time.UTC))
	fmt.Printf("Current: %s (%s)\n", fy.Label(), fy.AssessmentYear())
	// Output: Current: FY 2025-26 (AY 2026-27)

	// Statutory advance tax schedule under Section 211
	installments := fy.AdvanceTaxDueDates()
	for _, inst := range installments {
		fmt.Printf("Q%d Due: %s (Cumulative: %d%%)\n",
			inst.Quarter, inst.DueDate.Format("02 Jan 2006"), inst.PercentageCum)
	}
	// Output:
	// Q1 Due: 15 Jun 2025 (Cumulative: 15%)
	// Q2 Due: 15 Sep 2025 (Cumulative: 45%)
	// Q3 Due: 15 Dec 2025 (Cumulative: 75%)
	// Q4 Due: 15 Mar 2026 (Cumulative: 100%)
}

package main

import (
	"fmt"
	"time"
	fintechin "github.com/umesh0492/go-fintech-india"
)

func main() {
	// Razorpay HMAC-SHA256 verification (constant-time)
	if err := fintechin.ValidateRazorpayWebhook(payload, signature, secret); err != nil {
		fmt.Println("Razorpay signature invalid:", err)
	}

	// Cashfree HMAC-SHA256 with replay-attack tolerance window (e.g. 5 minutes)
	if err := fintechin.ValidateCashfreeWebhook(payload, signature, timestampHeader, secret, 5*time.Minute); err != nil {
		fmt.Println("Cashfree signature invalid or expired:", err)
	}

	// PhonePe S2S checksum verification (constant-time)
	if err := fintechin.ValidatePhonePeWebhook(responseBase64, checksum, saltKey, saltIndex); err != nil {
		fmt.Println("PhonePe checksum invalid:", err)
	}
}

package main

import (
	"context"
	"fmt"
	fintechin "github.com/umesh0492/go-fintech-india"
)

func main() {
	// Offline resolver: zero heap allocations, no network dependencies
	offline := fintechin.NewOfflineIFSCResolver()
	branch, err := offline.Resolve(context.Background(), "HDFC0000001")
	if err == nil {
		fmt.Printf("Bank: %s, Branch: %s, State: %s\n", branch.Bank, branch.Branch, branch.State)
	}

	// HTTP resolver: queries live Razorpay IFSC directory API with context & timeout
	httpResolver := fintechin.NewHTTPResolver()
	branch, err = httpResolver.Resolve(context.Background(), "SBIN0000691")
	if err == nil {
		fmt.Printf("Live Bank: %s, City: %s\n", branch.Bank, branch.City)
	}
}