SberPay

You can receive payments via SberPay. These payments, one-time and recurring, do not require card details from customers. To select a recurring payment method, inform your manager in Smart Glocal during boarding.

Payment scenarios

The payment scenario depends on the customer's channel of payment: mobile application (app), mobile browser (mobile_web), or desktop browser (web).

Mobile application (app)

1. Create a session using the session/create method.

2. Start the payment using the session/start/payment method.
   Specify the following data:

   • sber_pay in the type parameter
   • app in the channel parameter
   • a URL in the return_url parameter to forward the customer to.
   Request example

   curl -X POST \
     https://demo.smart-glocal.com/api/v1/session/start/payment \
     -H 'Content-Type: application/json' \
     -H 'X-PARTNER-PROJECT: your_project_name' \
     -H 'X-PARTNER-SIGN: signature' \
     -d '{
       "session_id": "ps_3230",
       "payment_details": {
         "type": "internet_banking",
         "internet_banking": {
           "type": "sber_pay",
           "sber_pay": {
             "channel": "app"
           }
         }
       },
       "amount_details": {
         "amount": 1000,
         "currency": "RUB"
       },
       "metadata": "app",
       "customer": {
         "reference": "user-ebf7-4815-af0a-b1f77e6de7e7"
       },
       "payment_options": {
         "return_url": "https://t.me/smartglocal"
       }
     }'

   Response example

   {
     "status": "ok",
     "session": {
       "id": "ps_3230",
       "status": "in_progress",
       "created_at": "2023-09-29T05:42:10.549869Z",
       "updated_at": "2023-09-29T05:42:10.948457Z",
       "acquiring_payments": [{
         "id": "pm_1313",
         "status": "in_progress",
         "created_at": "2023-09-29T05:42:10.973559Z",
         "customer": {
           "reference": "user-ebf7-4815-af0a-b1f77e6de7e7"
         },
         "payment_details": {
           "type": "internet_banking",
           "internet_banking": {
             "type": "sber_pay",
             "sber_pay": {
               "channel": "app"
             }
           }
         },
         "amount_details": {
           "amount": 1000,
           "currency": "RUB"
         },
         "amounts": {
           "gross": {
             "amount": 1000,
             "currency": "RUB"
           }
         },
         "metadata": "order123",
         "payment_options": {
           "return_url": "https://t.me/smartglocal",
           "recurrent": false
         }
       }]
     }
   }

3. When you receive a ready_to_confirm webhook from Smart Glocal, confirm your payment by sending a session/confirm request, or cancel it by sending a session/cancel request.

You should confirm a payment within 20 minutes by sending a session/confirm request. Otherwise, the session terminates within 20 minutes with the canceled status.

We do not recommend to use the sberpay/push method to additionally send PUSH or SMS notifications to customers as in this case Smart Glocal cannot guarantee a successful payment.

4. When you receive an action_required webhook containing a URL within redirect.url, forward the customer to the Sber mobile application.

   4.1 For iOS devices, to select the proper mobile application to forward the customer to, use the deeplink from the redirect.url parameter and follow the algorithm below:

   1. Open the onlineappmobile://sbolpay/... deeplink.
   2. Wait 50ms.
   3. Reload the page to hide a possible alert if the deeplink could not open properly.
   4. Redirect back to your page with the new request settings.
   5. Open the onlineios-app://sbolpay/... deeplink.
   6. Wait 50ms.
   7. Reload the page to hide a possible alert if the deeplink could not open properly.
   8. Redirect back to your page with the new request settings.
   9. Open the btripsexpenses://sbolpay/... deeplink.
   10. Wait 50ms.
   11. Reload the page to hide a possible alert if the deeplink could not open properly.
   12. Redirect back to your page with the new request settings.
   13. Open the budgetonline-ios://sbolpay/... deeplink.
   14. Wait 50ms.
   15. Reload the page to hide a possible alert if the deeplink could not open properly.
   16. Redirect back to your page with the new request settings.
   17. Open the ios-app-smartonline://sbolpay/... deeplink.
   18. Wait 50ms.
   19. Reload the page.
   20. Follow the deeplink to the Sber landing page.
       
       
   Code example

    const openAppOnline = () => {
      window.location.href = "onlineappmobile://sbolpay/invoicing/v2?bankInvoiceId=1961101c8c524c7fa15a9f101e965c58&orderNumber=d76d899c-6ffb-7116-ae89-afc802a92bb0";
    };
   
    const openOnlineiosApp = () => {
      window.location.href = "onlineios-app://sbolpay/invoicing/v2?bankInvoiceId=1961101c8c524c7fa15a9f101e965c58&orderNumber=d76d899c-6ffb-7116-ae89-afc802a92bb0";
    };
   
    const openBtripEx = () => {
      window.location.href = "btripsexpenses://sbolpay/invoicing/v2?bankInvoiceId=1961101c8c524c7fa15a9f101e965c58&orderNumber=d76d899c-6ffb-7116-ae89-afc802a92bb0";
    };
   
    const openBuget = () => {
      window.location.href = "budgetonline-ios://sbolpay/invoicing/v2?bankInvoiceId=1961101c8c524c7fa15a9f101e965c58&orderNumber=d76d899c-6ffb-7116-ae89-afc802a92bb0";
    };
   
    const openAppSmart = () => {
      window.location.href = "ios-app-smartonline://sbolpay/invoicing/v2?bankInvoiceId=1961101c8c524c7fa15a9f101e965c58&orderNumber=d76d899c-6ffb-7116-ae89-afc802a92bb0";
    };
   
    const openLandingpage = () => {
      window.location.href = "https://www.sberbank.ru/ru/person/payments/online_sberpay";
    };
   
    const clearMessage = () => {
      window.location.href = "./same_page.html";
    };
   
    if (platform == "android") {
      setTimeout(openSberpay, 100);
      clearMessage();
      setTimeout(openLandingpage, 800);
    } else if (platform == "iPhone") {
      setTimeout(openAppOnline, 50);
      clearMessage();
      setTimeout(openOnlineiosApp, 50);
      clearMessage();
      setTimeout(openBtripEx, 50);
      clearMessage();
      setTimeout(openBuget, 50);
      clearMessage();
      setTimeout(openAppSmart, 50);
      clearMessage();
      setTimeout(openLandingpage, 800);
    }

5. Wait until the customer approves or cancels the payment. After that, Sber takes the customer back to the URL or deeplink passed within the return_url parameter.

The transaction will automatically move to the Canceled status after 20 minutes.

6. Wait for a payment_finished webhook from Smart Glocal with the transaction results. Or, you can use the session/status method to check the transaction status (no more than once in 5 seconds).

7. Pass the transaction status to the customer.

Mobile browser (mobile_web)

1. Create a session using the session/create method.

2. Start the payment using the session/start/payment method.
   Specify the following data:

   • sber_pay in the type parameter
   • mobile_web in the channel parameter
   • a URL in the return_url parameter to forward the customer to.
   Request example

   curl -X POST \
     https://demo.smart-glocal.com/api/v1/session/start/payment \
     -H 'Content-Type: application/json' \
     -H 'X-PARTNER-PROJECT: your_project_name' \
     -H 'X-PARTNER-SIGN: signature' \
     -d '{
       "session_id": "ps_3230",
       "payment_details": {
         "type": "internet_banking",
         "internet_banking": {
           "type": "sber_pay",
           "sber_pay": {
             "channel": "mobile_web"
           }
         }
       },
       "amount_details": {
         "amount": 1000,
         "currency": "RUB"
       },
       "metadata": "mobile_web",
         "customer": {
           "reference": "user-ebf7-4815-af0a-b1f77e6de7e7"
        },
       "payment_options": {
         "return_url": "https://t.me/smartglocal"
       }
     }'

   Response example

   {
     "status": "ok",
     "session": {
       "id": "ps_3230",
       "status": "in_progress",
       "created_at": "2023-09-29T05:42:10.549869Z",
       "updated_at": "2023-09-29T05:42:10.948457Z",
       "acquiring_payments": [{
         "id": "pm_1313",
         "status": "in_progress",
         "created_at": "2023-09-29T05:42:10.973559Z",
         "customer": {
           "reference": "user-ebf7-4815-af0a-b1f77e6de7e7"
         },
         "payment_details": {
           "type": "internet_banking",
           "internet_banking": {
             "type": "sber_pay",
             "sber_pay": {
               "channel": "mobile_web"
             }
           }
         },
         "amount_details": {
           "amount": 1000,
           "currency": "RUB"
         },
         "amounts": {
           "gross": {
             "amount": 1000,
             "currency": "RUB"
           }
         },
         "metadata": "order123",
         "payment_options": {
           "return_url": "https://t.me/smartglocal",
           "recurrent": false
         }
       }]
     }
   }

3. When you receive a ready_to_confirm webhook from Smart Glocal, confirm your payment by sending a session/confirm request, or cancel it by sending a session/cancel request.

You should confirm a payment within 20 minutes by sending a session/confirm request. Otherwise, the session terminates within 20 minutes with the canceled status.

You can also use the sberpay/push method to additionally send PUSH or SMS notifications to customers (PUSH/SMS notification channel is set by Sber).

4. When you receive an action_required webhook containing a URL within redirect.url, forward the customer to the Sber mobile application.

   4.1 For iOS devices, to select the proper mobile application to forward the customer to, use the deeplink from the redirect.url parameter and follow the algorithm below:

   1. Open the onlineappmobile://sbolpay/... deeplink.
   2. Wait 50ms.
   3. Reload the page to hide a possible alert if the deeplink could not open properly.
   4. Redirect back to your page with the new request settings.
   5. Open the onlineios-app://sbolpay/... deeplink.
   6. Wait 50ms.
   7. Reload the page to hide a possible alert if the deeplink could not open properly.
   8. Redirect back to your page with the new request settings.
   9. Open the btripsexpenses://sbolpay/... deeplink.
   10. Wait 50ms.
   11. Reload the page to hide a possible alert if the deeplink could not open properly.
   12. Redirect back to your page with the new request settings.
   13. Open the budgetonline-ios://sbolpay/... deeplink.
   14. Wait 50ms.
   15. Reload the page to hide a possible alert if the deeplink could not open properly.
   16. Redirect back to your page with the new request settings.
   17. Open the ios-app-smartonline://sbolpay/... deeplink.
   18. Wait 50ms.
   19. Reload the page.
   20. Follow the deeplink to the Sber landing page.
       
       
   Code example

   const openAppOnline = () => {
     window.location.href = "onlineappmobile://sbolpay/invoicing/v2?bankInvoiceId=1961101c8c524c7fa15a9f101e965c58&orderNumber=d76d899c-6ffb-7116-ae89-afc802a92bb0";
   };
   
   const openOnlineiosApp = () => {
     window.location.href = "onlineios-app://sbolpay/invoicing/v2?bankInvoiceId=1961101c8c524c7fa15a9f101e965c58&orderNumber=d76d899c-6ffb-7116-ae89-afc802a92bb0";
   };
   
   const openBtripEx = () => {
     window.location.href = "btripsexpenses://sbolpay/invoicing/v2?bankInvoiceId=1961101c8c524c7fa15a9f101e965c58&orderNumber=d76d899c-6ffb-7116-ae89-afc802a92bb0";
   };
   
   const openBuget = () => {
     window.location.href = "budgetonline-ios://sbolpay/invoicing/v2?bankInvoiceId=1961101c8c524c7fa15a9f101e965c58&orderNumber=d76d899c-6ffb-7116-ae89-afc802a92bb0";
   };
   
   const openAppSmart = () => {
     window.location.href = "ios-app-smartonline://sbolpay/invoicing/v2?bankInvoiceId=1961101c8c524c7fa15a9f101e965c58&orderNumber=d76d899c-6ffb-7116-ae89-afc802a92bb0";
   };
   
   const openLandingpage = () => {
     window.location.href = "https://www.sberbank.ru/ru/person/payments/online_sberpay";
   };
   
   const clearMessage = () => {
     window.location.href = "./same_page.html";
   };
   
   if (platform == "android") {
     setTimeout(openSberpay, 100);
     clearMessage();
     setTimeout(openLandingpage, 800);
   } else if (platform == "iPhone") {
     setTimeout(openAppOnline, 50);
     clearMessage();
     setTimeout(openOnlineiosApp, 50);
     clearMessage();
     setTimeout(openBtripEx, 50);
     clearMessage();
     setTimeout(openBuget, 50);
     clearMessage();
     setTimeout(openAppSmart, 50);
     clearMessage();
     setTimeout(openLandingpage, 800);
   }

5. Wait until the customer approves or cancels the payment. After that, Sber takes the customer back to the URL or deeplink passed within the return_url parameter.

The transaction will automatically move to the Canceled status after 20 minutes.

6. Wait for a payment_finished webhook from Smart Glocal with the transaction results. Or, you can use the session/status method to check the transaction status (no more than once in 5 seconds).

7. Pass the transaction status to the customer.

Desktop browser (web)

1. Create a session using the session/create method.
2. Start the payment using the session/start/payment method.
   Specify the following data:

• sber_pay in the type parameter

• web in the channel parameter

• the customer's phone number in the phone parameter

• a URL in the return_url parameter (the parameter is mandatory but the customer is not redirected anywhere).

  Request example

  curl -X POST \
    https://demo.smart-glocal.com/api/v1/session/start/payment \
    -H 'Content-Type: application/json' \
    -H 'X-PARTNER-PROJECT: your_project_name' \
    -H 'X-PARTNER-SIGN: signature' \
    -d '{
      "session_id": "ps_3230",
      "payment_details": {
        "type": "internet_banking",
        "internet_banking": {
          "type": "sber_pay",
          "sber_pay": {
            "phone": "71234567890",
            "channel": "web"
          }
        }
      },
      "amount_details": {
        "amount": 1000,
        "currency": "RUB"
      },
      "metadata": "web",
      "customer": {
        "reference": "user-ebf7-4815-af0a-b1f77e6de7e7"
      },
      "payment_options": {
        "return_url": "https://smart-glocal.com"
      }
    }'

  Response example

  {
    "status": "ok",
    "session": {
      "id": "ps_3230",
      "status": "in_progress",
      "created_at": "2023-09-29T05:42:10.549869Z",
      "updated_at": "2023-09-29T05:42:10.948457Z",
      "acquiring_payments": [{
        "id": "pm_1313",
        "status": "in_progress",
        "created_at": "2023-09-29T05:42:10.973559Z",
        "customer": {
          "reference": "user-ebf7-4815-af0a-b1f77e6de7e7"
        },
        "payment_details": {
          "type": "internet_banking",
          "internet_banking": {
            "type": "sber_pay",
            "sber_pay": {
              "phone": "71234567890",
              "channel": "web"
            }
          }
        },
        "amount_details": {
          "amount": 1000,
          "currency": "RUB"
        },
        "amounts": {
          "gross": {
            "amount": 1000,
            "currency": "RUB"
          }
        },
        "metadata": "order123",
        "payment_options": {
          "return_url": "https://t.me/smartglocal",
          "recurrent": false
        }
      }]
    }
  }

3. When you receive a ready_to_confirm webhook from Smart Glocal, confirm your payment by sending a session/confirm request, or cancel it by sending a session/cancel request.

You should confirm a payment within 20 minutes by sending a session/confirm request. Otherwise, the session terminates within 20 minutes with the canceled status.

You can also use the sberpay/push method to additionally send PUSH or SMS notifications to customers (PUSH/SMS notification channel is set by Sber).

If for any reason the customer does not receive the payment link, the customer can find the invoice in the Sber application and pay it there.

5. Wait for a payment_finished webhook from Smart Glocal with the transaction results. Or, you can use the session/status method to check the transaction status (no more than once in 5 seconds).

6. Pass the transaction status to the customer.

Recurring payments

CIT recurring payments via SberPay are not supported.

To make MIT recurring payments via SberPay:

1. Get a token by sending recurrent=true (in the payment_options object) in the request.

   Example

   curl -X \
     https://demo.smart-glocal.com/api/v1/session/init/payment \
     -H 'Content-Type: application/json' \
     -H 'X-PARTNER-PROJECT: your_project_name' \
     -H 'X-PARTNER-SIGN: signature' \
     -d '{
       "payment_details": {
         "type": "internet_banking",
         "internet_banking": {
           "type": "sber_pay",
           "sber_pay": {
             "phone": "71234567890",
             "channel": "app"
           }
         }
       },
       "amount_details": {
         "amount": 1000,
         "currency": "RUB"
       },
       "metadata": "app",
       "customer": {
         "reference": "user-ebf7-4815-af0a-b1f77e6de7e7"
       },
       "payment_options": {
         "return_url": "https://t.me/smartglocal",
         "recurrent": "true"
       }
     }'

2. Use the token to make recurring payments.

   Example

   curl -X \
     https://demo.smart-glocal.com/api/v1/session/init/payment \
     -H 'Content-Type: application/json' \
     -H 'X-PARTNER-PROJECT: your_project_name' \
     -H 'X-PARTNER-SIGN: signature' \
     -d '{
       "payment_details": {
         "type": "recurrent",
         "recurrent": {
           "token": "e9876f32bcd947f79c324cf2da5726304a894f6ae2037de7705fdb3e0a134d39"
         }
       },
       "amount_details": {
         "amount": 1000,
         "currency": "RUB"
       },
       "metadata": "app",
       "customer": {
         "reference": "user-ebf7-4815-af0a-b1f77e6de7e7"
       }
     }'