Faster Payments System (SBP)

Payment flow

The Faster Payments System payment flow contains the following steps:

You initiate a payment request.
The system submits a request to the payment method provider. The Faster Payments System generates a QR-code used to complete a payment.
You get a response and redirect your customer to the received URL.
Your customer gets the payment QR-code and completes the payment.
You get a webhook notification about a payment status, if you send notification_url in the payment request.

This alternative payment method supports the following operations:

Payment

Request

Send a payment request with the following additional data:

Parameter	Type	Description
method	object	A section of the payment method information.
type required	string	`sbp`

Response

The payment response additionally contains the form section with the URL of a page with the QR-code. Redirect your customer to the URL received as a value of the form.action parameter.

Payment status query

Request

To check a status of the payment, send a transaction status query.

Response

The response contains the transaction status, a section of the payment method as well as other details related to the transaction according to the description of a transaction status query.

Refund

Request

To pay money back to the customer, send a refund request with the UID of the payment transaction.

Response

The response contains the status of the refund transaction as well as other relevant transaction details according to the description of a refund transaction.

BK Integration option

Info

This integration option only supports RUB currency.

Payment

Payment flow

The customer initiates the payment on the merchant's website.
The merchant sends the payment request to Palladium.
Palladium returns a URL to the page to which the customer needs to be redirected.
The merchant redirects the customer to the received payment page URL. The lifespan of the payment link is 20 minutes.
On desktop: the link displays the QR-code. The customer scans the code with their mobile device, selects the bank from the displayed list of the available banks, gets redirected to the corresponding bank application and completes the payment. Alternatively the customer scans the QR-code in their bank application and completes the payment. On mobile: the link displays the list of the available banks. The customer is redirected to the bank selection page to complete the payment. The customer selects the bank from the displayed list of the available banks, gets redirected to the corresponding bank application and completes the payment.
Palladium sends a webhook notification to the merchant.
The merchant displays the payment status to the customer.

Request

Send a payment request with the following additional data:

Parameter	Type	Description
request	object
return_url * required	string	A URL to return the customer to when the transaction is completed.
method	object	A section of the payment method information.
type * required	string	`sbp`
customer	object	A section of information about the customer.
external_id	string	The customer's identifier in the merchant's system.

Request example

{
  "request": {
    "amount": 100,
    "currency": "RUB",
    "description": "test description",
    "test": false,
    "tracking_id": "your_uniq_number",    
    "ip": "127.0.0.1",
    "language": "en",
    "return_url": "https://example.com",
    "customer": {
      "email": ""
    },
    "method": {
      "type": "sbp"
    }
  }
}

Response

Redirect your customer to the URL received as the value of the form.action parameter.

Response example

{
  "transaction": {
    "uid": "ece369f7-bcca-47ba-bf5c-a428950ad43a",
    "type": "payment",
    "status": "pending",
    "amount": 100,
    "currency": "RUB",
    "description": "description",
    "created_at": "2025-06-18T13:28:39Z",
    "updated_at": "2025-06-18T13:28:40Z",
    "method_type": "sbp",
    "receipt_url": "https://backoffice.pall-psp.com/customer/transactions/ece369f7-bcca-47ba-bf5c-a428950ad43a/3d33c91f6a27d171f1ce6c69c9c41f29c0a9ee75f298daf1c6dd1fea44edb39c?language=en",
    "payment": {
      "status": "pending",
      "gateway_id": 5493,
      "ref_id": "ps_542996944",
      "message": "Transaction was initialized.",
      "rrn": "pm_479867115"
    },
    "sbp": {
      "type": "sbp"
    },
    "customer": {
      "email": null,
      "ip": "127.0.0.1"
    },
    "manually_corrected_at": null,
    "version": 3,
    "message": "Transaction was initialized.",      
    "tracking_id": "your_uniq_number",
    "test": false,
    "language": "en",
    "billing_address": {
      "email": null
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "payment-link",
      "fields": [],
      "method": "GET"
    }
  }
}

Refund

Request

Send a standard refund request. The amount value must not exceed the amount of the parent transaction. It is possible to make multiple refunds for the same payment transaction, in this case the sum of refund amounts must not exceed the amount of the corresponding payment transaction.