# Smart Glocal API
> Smart Glocal provides a collection of API methods that enable you to manage payouts and payments. Requests and responses are made in JSON format.

## Getting started
- [Quick start](/docs/before): Complete steps to get API access — apply, exchange keys, set up webhooks, test, and go live.
- [API interaction](/docs/reference/format): Endpoints, request format, authentication with RSA signatures, and idempotency key usage.
- [Testing](/docs/reference/testing): How to test API calls in the demo environment without involving live data.

## Payments
- [Payments overview](/docs/payments/payment-intro): Supported countries, currencies, card types, PCI DSS compliance, and Merchant of Record model.
- [Payment parameters](/docs/payments/params): Required sender fields for payments with and without the payment widget.
- [One-time payments](/docs/payments/one-time-payment): Step-by-step flow for single card payments with open parameters or payment widget.
- [Delayed capture payments](/docs/payments/payment-capture): Two-phase authorization-then-capture flow with hold period and sequence diagrams.
- [Local card payments](/docs/payments/local-cards): Country-specific card payments with required payer parameters (document, msisdn, address).
- [Instant bank-to-bank transfers in India](/docs/payments/india-accounts): UPI-based payments via QR codes or UPI IDs in INR and USD.
- [Local APMs](/docs/payments/payment-pix): Local alternative payment methods (e.g. Pix in Brazil).
- [Recurring payments](/docs/payments/payment-recurring): Setup and flow for recurring (subscription) payments.
- [Payment refunds](/docs/payments/payment-refund): Full and partial refund flows with session/refund endpoint and payment_refunded webhook.

## Telegram
- [Connect our Telegram bot](/docs/payments/payment-telegram-bot-connect): Link your Telegram bot to Smart Glocal via BotFather for test and live payments.
- [Use your Telegram bot](/docs/payments/payment-telegram-bot-use): Accept payments in Telegram using the connected bot and provider token.

## Reports
- [Daily payouts report](/docs/finance/payouts-daily-report): Retrieve daily payout summaries via API.
- [Daily payments report](/docs/finance/payment-daily-report): Retrieve daily payment summaries via API.

## API Reference
- [Objects](/docs/reference/objects): All API object schemas — payment session, payment details, amount details, customer, payment method, error, and more.
- [Methods](/docs/reference/methods/session-create): Complete API method reference — session/create, session/start/payment, session/confirm, session/capture, session/refund, session/status, and more.
- [Webhooks](/docs/reference/webhooks): Webhook notifications — action_required, ready_to_capture, ready_to_confirm, payment_finished, payment_refunded.
- [Error codes](/docs/reference/errors): Full list of API error codes with descriptions.

## Versioning note
> Smart Glocal supports API v1 and v2. All links above default to the current version. Key naming difference: `payment_method` (v1) → `payout_details` (v2), `acquiring_payments` (v1) → `payment_list` (v2). See [API interaction](/docs/reference/format#api-version) for details.