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.

Transaction scenario​

  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 Bank 131. In case of a successful transaction, the webhook will contain session.status=accepted and payments.status=succeeded along with a recurring token within the recurrent.token parameter. If the transaction fails, the webhook will contain session.status=cancelled, payments.status=failed, and no recurring token.
The payment_finished webhook
{
  "type": "payment_finished",
  "session": {
    "id": "ps_713610",
    "status": "accepted",
    "created_at": "2024-08-08T08:06:51.841432Z",
    "updated_at": "2024-08-08T08:14:56.168219Z",
    "acquiring_payments": [
      {
        "id": "pm_308906",
        "status": "succeeded",
        "created_at": "2024-08-08T08:06:51.931193Z",
        "finished_at": "2024-08-08T08:14:55.996273Z",
        "customer": {
          "reference": "user123",
          "contacts": [
            {
              "phone": "7123*****45"
            }
          ]
        },
        "payment_details": {
          "type": "faster_payment_system"
        },
        "recurrent": {
          "token": "6a6a29c4193a8e1049231e1497a3c5f180e120b20db81b39f53ec478029b53cf",
          "created_at": "2024-08-08T10:10:27+03:00",
          "finished_at": "2034-08-08T10:10:27+03:00",
          "is_active": true,
          "type": "recurrent_token"
        },
        "amount_details": {
          "amount": 1000,
          "currency": "RUB"
        },
        "amounts": {
          "net": {
            "amount": 1000,
            "currency": "RUB"
          },
          "gross": {
            "amount": 1000,
            "currency": "RUB"
          }
        }
      }
    ],
    "actions": {
      "confirm": "2024-08-08T08:06:52.184593Z",
      "capture": "2024-08-08T08:14:55.699095Z"
    }
  }
}

Scheme​