Changelog

[1.0.0] — 2026-04-06

Added

Core infrastructure

• SetuClient.Config — typed struct, environment-aware URL resolution, KYC headers, validate!/1
• SetuClient.Error — 6 typed errors (:api, :auth, :rate_limit, :network, :validation, :decode)
• SetuClient.Validation — shared client-side validators (require_param/2, require_positive/2, require_id/2, require_merchant/1)
• SetuClient.HTTP — Finch client with full-jitter backoff retry, rate limiting, telemetry spans
• SetuClient.TokenManager — GenServer with ETS caching, singleflight deduplication, proactive refresh
• SetuClient.RateLimiter — token-bucket GenServer per {client_id, environment}
• SetuClient.Telemetry — :telemetry events for all requests, token refreshes, rate-limit waits

Payments — UPI Setu

• Flash: create_dqr/3, get_dqr/3, create_sqr/3, get_sqr/3
• Payment status: get_last_payment/3, get_payment_history/3
• TPV: create_tpv/3, get_tpv/3
• Collect: verify_vpa/3, create_collect/3, get_collect/3
• Mandates: create_mandate/3, get_mandate/3, update_mandate/4, revoke_mandate/4, get_mandate_operation/3
• Pre-debit: pre_debit_notify/4, get_pre_debit_notification/3
• Execution: execute_mandate/4, get_mandate_execution/3
• Refunds: create_refund/3, get_refund/3
• Disputes: get_dispute/3, accept_dispute/3, reject_dispute/4
• Merchant onboarding: create_merchant/2, get_merchant/2, check_vpa_availability/2, create_vpa/3

Payments — BBPS / BillPay / WhatsApp

• SetuClient.Payments.BBPS: get_transaction/2, build_bill_fetch_response/2, build_bill/1, build_settlement/2
• SetuClient.Payments.BillPay: fetch_bill/2, pay_bill/2
• SetuClient.Payments.WhatsApp: send_reminder/2, get_reminder_status/2

Data — Account Aggregator

• create_consent/2, get_consent/3, revoke_consent/2, create_multi_consent/2
• get_last_fetch_status/2, list_data_sessions/2
• create_data_session/2, get_data_session/2, fetch_fi_data/2
• Context helpers: with_account_type/1, with_fip_filter/1, with_exclude_fips/1, with_account_selection_mode/1, with_transaction_type/1, with_purpose_description/1

Data — KYC

• SetuClient.Data.KYC.PAN: verify/2, valid?/1
• SetuClient.Data.KYC.BAV: verify_sync/2, verify_async/2, get_async_status/2
• SetuClient.Data.KYC.GST: verify/2, active?/1
• SetuClient.Data.KYC.NameMatch: match/2, match?/2, strict_match?/2
• SetuClient.Data.KYC.EKYC: create/2, get/2, complete?/1
• SetuClient.Data.KYC.DigiLocker: create_session/2, get_session/2, get_document/3

Data — eSign

• SetuClient.Data.ESign: create/2, get/2, download/2, complete?/1

Webhooks

• SetuClient.Webhook.Handler: dispatch/2, dispatch_raw/2, optional Plug integration
• SetuClient.Webhook.Callbacks: behaviour + use macro with default no-op implementations
• Event helpers: event_type/1, payment_successful?/1, consent_active?/1, session_completed?/1, consent_id/1, session_id/1, consent_status/1, session_status/1