Skip to main content

Recurring payments via FPS

You can make a transaction to bind a payer's account to the FPS for recurring payments with a recurring token.

How to make a payment​

  1. Create a payment session session/create.
  2. Send a payment request using the session/start/payment method. The payment_options.recurrent parameter contains the true value.
  3. Wait for a ready_to_confirm webhook to confirm the payment with session/confirm or cancel the payment with session/cancel.
  4. Wait for an action_required webhook. The customer_interaction.inform.qr.content parameter contains a deeplink which you can either display to the customer as QR code in a web browser, or use it to forward the customer to the issuer's mobile application.
  5. Wait for a payment_finished webhook containing the transaction result from Smart Glocal. In case of a successful transaction, the webhook will contain status=accepted (session object) and status=succeeded (payments/payout_list object) along with a recurring token within the recurrent.token parameter. If the transaction fails, the webhook will contain status=cancelled (session object), status=failed (payments/payout_list object), and no recurring token.
Webhook example
{
    "type": "payment_finished",
    "session": {
        "id": "ps_3102",
        "status": "accepted",
        "created_at": "2025-07-08T08:55:05.187838Z",
        "updated_at": "2025-07-08T08:56:34.110096Z",
        "acquiring_payments": [
            {
                "id": "pm_3100",
                "status": "succeeded",
                "created_at": "2025-07-08T08:55:05.284254Z",
                "finished_at": "2025-07-08T08:56:34.015333Z",
                "customer": {
                    "reference": "1501512",
                    "contacts": [
                        {
                            "phone": "7953*****21"
                        }
                    ]
                },
                "payment_details": {
                    "type": "faster_payment_system"
                },
                "recurrent": {
                    "token": "f8d95e0e8bfa9a573c12f69d3f858f1b37342623870cb39057676e0dbabc02c2",
                    "created_at": "2025-07-08T11:56:33+03:00",
                    "finished_at": "2035-07-08T11:56:32+03:00",
                    "is_active": true,
                    "type": "recurrent_token"
                },
                "amount_details": {
                    "amount": 199000,
                    "currency": "RUB"
                },
                "amounts": {},
                "metadata": {
                    "initiatorMetadata": {
                        "customQueryId": "644894796103676688",
                        "account": "8f082ccad1c4f69dbc678fa409924fb6cde5cc23",
                        "callback": "-1224827450_00e4d08bebca4da2ef",
                        "chargeId": "5314659081_150151268_737729",
                        "customerId": 150151268,
                        "save": false,
                        "recurrent": true,
                        "botUsername": "PremiumBot",
                        "apmPublicToken": "d4470a4280e61d5de8a76b7de9d1e2d30b24b2237c73994717566e5315608ec3",
                        "clientSession": {
                            "id": "af67818f9e82849d98f0de21619fe677fdc1f3f576071b69bd9a3c6976813e11",
                            "userTelegramId": 1100521234,
                            "apmToken": "16276dbebeceb3fb3573b06c819d0b838a0679b758fa797376d7660c659000fb",
                            "clientLocaleIso2": "ru",
                            "validationErrorsCount": 0
                        }
                    },
                    "invoicePayload": "init_premium_sub_12M-RUv1675450666",
                    "invoiceData": "{\"service_period\":31104000,\"purpose\":\"premium\",\"account_age_category\":6}"
                },
                "participant_details": {
                    "sender": {
                        "ipv4": "185.130.184.58"
                    }
                },
                "payment_options": {
                    "return_url": "https://payment.smart-glocal.com/en/session_status/5314653481/8f082ccad1c4f69dbc678fa409924fb6cde5cc10/ps_3102202245/52d9e5bf7037a189b39c89d55c9fdd4cacd19cb52582c7278de046a9df3511f6?theme=%7B%22bg_color%22:%22%23282e33%22,%22text_color%22:%22%23f5f5f5%22,%22hint_color%22:%22%2382868a%22,%22link_color%22:%22%23a6b8cd%22,%22button_color%22:%22%237b8799%22,%22button_text_color%22:%22%23ffffff%22,%22secondary_bg_color%22:%22%23313b43%22,%22header_bg_color%22:%22%23282e33%22,%22accent_text_color%22:%22%23bbc7d9%22,%22section_bg_color%22:%22%23282e33%22,%22section_header_text_color%22:%22%23a6b8cd%22,%22subtitle_text_color%22:%22%2382868a%22,%22destructive_text_color%22:%22%23f57474%22%7D",
                    "recurrent": true
                },
                "transaction_info": {
                    "fp_message_id": "A51890856297741A0000040011538701"
                }
            }
        ],
        "actions": {
            "confirm": "2025-07-08T08:55:05.349934Z",
            "capture": "2025-07-08T08:56:33.333387Z"
        }
    }
}

Diagram​