Robokassa

https://docs.robokassa.kz
Admin
Robokassa is a comprehensive payment platform that enables merchants to accept payments through...
Tokens:63,788
Snippets:298
Trust Score:8.4
Update:7 months ago
Show doc for...
Tokens:
Raw
### Example Signature Calculation for Saved Card Payment

Source: https://docs.robokassa.kz/payment

An example demonstrating the calculation of the signature for a saved card payment, showing the specific string that would be hashed.

```text
marsbuketskz:50::%7B%22items%22%3A%5B%7B%22name%22%3A%22%22%2C%22quantity%22%3A%22%22%2C%22sum%22%3A%22%22%2C%22tax%22%3A%22none%22%7D%5D%7D:603A885C-C5B2-4D1E-B7A0-B45F61FB8D20-ZVLbWAc4u3:pass1
```

--------------------------------

### OpStateExt Request Example (HTTP GET)

Source: https://docs.robokassa.kz/xml-interfaces

An example of an HTTP GET request to retrieve extended information about a payment operation and its current state. This requires the MerchantLogin, InvoiceID, and a calculated Signature.

```http
https://auth.robokassa.kz/Merchant/WebService/Service.asmx/OpStateExt?MerchantLogin=demo&InvoiceID=1932809606&Signature=9e2bf657364d25acf5905b4ac4f50e39
```

--------------------------------

### Get Currencies Request Example (HTTP GET)

Source: https://docs.robokassa.kz/xml-interfaces

An example of how to request a list of currencies available for a specific merchant using an HTTP GET request. This method helps in displaying available payment options to customers.

```http
https://auth.robokassa.kz/Merchant/WebService/Service.asmx/GetCurrencies?MerchantLogin=demo&Language=ru
```

--------------------------------

### Robokassa KZ Split Payment GET Request Example

Source: https://docs.robokassa.kz/split

This example demonstrates how to construct a GET request URL for initiating a split payment in Robokassa KZ. It includes parameters for the master merchant, split merchants, invoice details, and receipt information. The `invoice` parameter is a JSON string containing all payment details, and `signature` is required for authentication.

```http
https://auth.robokassa.kz/Merchant/Payment/CreateV2?invoice=%7B%22outAmount%22%3A300%2C%22shop_params%22%3A+%5B%7B%22name%22%3A+%22user_param_1%22%2C%22value%22%3A+%22%D0%9F%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80+%D0%BD%D0%BE%D0%BC%D0%B5%D1%80+%D0%BE%D0%B4%D0%B8%D0%BD%22%7D%2C%7B%22name%22%3A+%22user_param_2%22%2C+%22value%22%3A+%22%D0%9F%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80+%D0%BD%D0%BE%D0%BC%D0%B5%D1%80+%D0%B4%D0%B2%D0%B0%22%7D%5D%2C%22email%22%3A+%22testlab%40test.ru%22%2C%22incCurr%22%3A%22BankCard%22%2C%22language%22%3A%22ru%22%2C%22isTest%22%3Afalse%2C%22expirationDate%22%3A%222024-08-23T12%3A53Z%22%2C+%22merchant%22%3A%7B%22id%22%3A%22kz_split_01_shop_01%22%2C%22comment%22%3A+%22%D0%9E%D0%B1%D1%89%D0%B5%D0%B5+%D0%BE%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5+%D0%B7%D0%B0%D0%BA%D0%B0%D0%B7%D0%B0%22%7D%2C%22splitMerchants%22%3A%5B%7B%22id%22%3A%22kz_split_01_shop_01%22%2C%22InvoiceId%22%3A66%2C%22amount%22%3A150%2C%22receipt%22%3A+%7B%22items%22%3A+%5B%7B%22name%22%3A%22%D1%82%D0%BE%D0%B2%D0%B0%D1%80+1%22%2C%22quantity%22%3A2%2C%22sum%22%3A150%2C%22tax%22%3A+%22none%22%7D%5D%7D%7D%2C%7B%22id%22%3A%22kz_split_02_shop_01%22%2C%22InvoiceId%22%3A66%2C%22amount%22%3A150%2C%22receipt%22%3A%7B%22items%22%3A%5B%7B%22name%22%3A+%22%D1%82%D0%BE%D0%B2%D0%B0%D1%80+2%22%2C%22quantity%22%3A1%2C%22sum%22%3A150%2C%22tax%22%3A%22none%22%7D%5D%7D%7D%5D%7D&signature=6e170078c2bf5517dd77f7b5024662f8
```

--------------------------------

### Example Request for Saved Card Payment (CoFPayment)

Source: https://docs.robokassa.kz/payment

An example GET/POST request URL for initiating a payment using a saved card via Robokassa's CoFPayment endpoint. It includes parameters like MerchantLogin, OutSum, Receipt, Token, and SignatureValue.

```url
https://auth.robokassa.kz/Merchant/Payment/CoFPayment?MerchantLogin=marsbuketskz&OutSum=50&Receipt=%257B%2522items%2522%253A%255B%257B%2522name%2522%253A%2522%2522%252C%2522quantity%2522%253A%2522%2522%252C%2522sum%2522%253A%2522%2522%252C%2522tax%2522%253A%2522none%2522%257D%255D%257D&Token=603A885C-C5B2-4D1E-B7A0-B45F61FB8D20-ZVLbWAc4u3&SignatureValue=f481a6ed904de15404597a2f85740481
```

--------------------------------

### Full Payment Form Integration (Index.aspx)

Source: https://docs.robokassa.kz/payment

This example demonstrates a comprehensive integration using a POST request to the Index.aspx endpoint, allowing for detailed order information, including product nomenclature and custom parameters.

```APIDOC
## POST /Merchant/Index.aspx

### Description
This endpoint facilitates a full payment form integration by submitting payment details via a POST request. It supports detailed order information, including product receipts, custom parameters, and currency settings.

### Method
POST

### Endpoint
`https://auth.robokassa.kz/Merchant/Index.aspx`

### Parameters
#### Request Body (Form Data)
- **MerchantLogin** (string) - Required - Your merchant login ID.
- **OutSum** (string) - Required - The total sum of the order.
- **InvId** (integer) - Required - A unique identifier for the invoice in your system (1 to 2147483647).
- **Description** (string) - Required - A description of the payment.
- **SignatureValue** (string) - Required - An MD5 hash generated from `MerchantLogin:OutSum:InvId:Receipt:password_1:Shp_item=Shp_item_value`.
- **Shp_item** (string) - Optional - Additional custom parameters for the order (e.g., `Shp_oplata=1`).
- **IncCurrLabel** (string) - Optional - The preferred currency for the payment (e.g., `BANKOCEAN2R`).
- **Culture** (string) - Optional - The language for the payment interface (e.g., `ru`).
- **Email** (string) - Optional - The buyer's email address.
- **ExpirationDate** (string) - Optional - The expiration date for the payment (ISO 8601 format, e.g., `2029-01-16T12:00`).
- **Receipt** (string) - Optional - URL-encoded JSON string representing the product nomenclature (e.g., `{"items":[{"name":"product","quantity":1,"sum":1,"tax":"none"}]}`).

### Request Example
```php
<?php
  // registration info (Merchant ID, password #1)
  $merchant_login = "demo";
  $password_1 = "password_1";
  // number of order
  $invid = 12345;
  // order description
  $description = "Техническая документация по ROBOKASSA";
  // sum of order
  $out_sum = "8.96";
  // Product Nomenclature (Receipt) in url encode
  // Before url encode - {"items":[{"name":"product","quantity":1,"sum":1,"tax":"none"}]}
  $receipt = "%7B%22items%22%3A%5B%7B%22name%22%3A%22product%22%2C%22quantity%22%3A1%2C%22sum%22%3A1%2C%22tax%22%3A%22none%22%7D%5D%7D";
  // default payment e-currency
  $incurrlabel = "BANKOCEAN2R";
  // language
  $culture = "ru";
  // encoding
  $encoding = "utf-8";
  // E-mail
  $Email = "test@test.ru";
  // Expiration Date
  $ExpirationDate = "2029-01-16T12:00";
  // Shp_item
  $Shp_item = "Shp_oplata=1";
  // generate signature
  $signature_value = md5("$merchant_login:$out_sum:$invid:$receipt:$password_1:Shp_item=$Shp_item");
  // payment form
  print
    "<html>".
      "<form action='https://auth.robokassa.kz/Merchant/Index.aspx' method=POST>".
        "<input type=hidden name=MerchantLogin value=$merchant_login>".
        "<input type=hidden name=OutSum value=$out_sum>".
        "<input type=hidden name=InvId value=$invid>".
        "<input type=hidden name=Description value='$description'>".
        "<input type=hidden name=SignatureValue value=$signature_value>".
        "<input type=hidden name=Shp_item value='$Shp_item'>".
        "<input type=hidden name=IncCurrLabel value=$incurrlabel>".
        "<input type=hidden name=Culture value=$culture>".
        "<input type=hidden name=Email value=$Email>".
        "<input type=hidden name=ExpirationDate value=$ExpirationDate>".
        "<input type=hidden name=Receipt value=$receipt>".
        "<input type=submit value='Оплатить'>".
    "</form></html>";
?>
```

### Response
#### Success Response (200)
Redirects the user to the Robokassa payment page or processes the payment based on the provided parameters.

#### Response Example
(HTML form submission leading to payment processing)
```

--------------------------------

### Widget Integration with Fixed Sum (FormFLS.js)

Source: https://docs.robokassa.kz/pay-interface

This example shows how to integrate the Robokassa KZ payment widget for a form with a pre-defined sum. It utilizes the `FormFLS.js` script and assumes MD5 hash calculation.

```APIDOC
## POST /Merchant/PaymentForm/FormFLS.js

### Description
Integrates the Robokassa KZ payment widget for a form with a fixed, pre-defined payment amount. This method is suitable when the amount is determined by your system. It uses the `FormFLS.js` script and assumes MD5 hash calculation.

### Method
GET (for script source)

### Endpoint
`https://auth.robokassa.kz/Merchant/PaymentForm/FormFLS.js`

### Parameters
#### Query Parameters
- **MerchantLogin** (string) - Required - Your unique merchant login ID.
- **DefaultSum** (string) - Required - The fixed amount to be paid.
- **InvoiceID** (integer) - Required - A unique identifier for the transaction within your system. Must be unique for each payment.
- **Description** (string) - Required - A description of the payment or order.
- **SignatureValue** (string) - Required - An MD5 hash generated to ensure the integrity of the payment request. Format: `md5("MerchantLogin::InvoiceID:password_1")` (Note: OutSum is omitted in the signature for this method).

### Request Example
```php
<?php
  $merchant_login = "demo";
  $password_1 = "password_1";
  $invid = 0;
  $description = "Техническая документация по ROBOKASSA";
  $default_sum = "10";
  $signature_value = md5("$merchant_login::$invid:$password_1");
  print "<html><script language=JavaScript " +
    "src='https://auth.robokassa.kz/Merchant/PaymentForm/FormFLS.js?" +
    "MerchantLogin=$merchant_login&DefaultSum=$default_sum&InvoiceID=$invid" +
    "&Description=$description&SignatureValue=$signature_value'></script></html>";
?>
```

### Response
#### Success Response (200)
- The widget is displayed on the user's screen with the pre-defined amount, allowing them to proceed with the payment.

#### Response Example
(No direct response body, as this integrates a JavaScript widget)
```

--------------------------------

### Full Payment Form Integration (Index.aspx)

Source: https://docs.robokassa.kz/pay-interface

This example demonstrates how to create a full payment form using POST to the Robokassa KZ payment gateway. It includes various parameters like product details, currency, language, and email, assuming MD5 hash calculation.

```APIDOC
## POST /Merchant/Index.aspx

### Description
Submits a payment request to the Robokassa KZ gateway using an HTML form with POST method. This provides a comprehensive way to send detailed payment information, including product nomenclature, currency, language, and customer email. It assumes MD5 hash calculation for security.

### Method
POST

### Endpoint
`https://auth.robokassa.kz/Merchant/Index.aspx`

### Parameters
#### Request Body
- **MerchantLogin** (string) - Required - Your unique merchant login ID.
- **OutSum** (string) - Required - The total amount of the order.
- **InvId** (integer) - Required - A unique identifier for the transaction within your system. Must be unique for each payment (1 to 2147483647).
- **Description** (string) - Required - A description of the order.
- **SignatureValue** (string) - Required - An MD5 hash generated to ensure the integrity of the payment request. Format: `md5("MerchantLogin:OutSum:InvId:Receipt:password_1:Shp_item=...")`
- **Shp_item** (string) - Optional - Additional custom parameters, often used for item details or tracking. Format: `key=value`
- **IncCurrLabel** (string) - Optional - The preferred currency for the payment (e.g., "BANKOCEAN2R").
- **Culture** (string) - Optional - The language for the payment interface (e.g., "ru").
- **Email** (string) - Optional - The customer's email address.
- **ExpirationDate** (string) - Optional - The expiration date for the payment request in ISO 8601 format (e.g., "2029-01-16T12:00").
- **Receipt** (string) - Optional - Product nomenclature details, URL-encoded JSON string. Example: `{"items":[{"name":"product","quantity":1,"sum":1,"tax":"none"}]}`

### Request Example
```php
<?php
  // registration info (Merchant ID, password #1)
  $merchant_login = "demo";
  $password_1 = "password_1";
  // number of order
  $invid = 12345;
  // order description
  $description = "Техническая документация по ROBOKASSA";
  // sum of order
  $out_sum = "8.96";
  // Product Nomenclature (Receipt) in url encode
  // Before url encode - {"items":[{"name":"product","quantity":1,"sum":1,"tax":"none"}]}
  $receipt = "%7B%22items%22%3A%5B%7B%22name%22%3A%22product%22%2C%22quantity%22%3A1%2C%22sum%22%3A1%2C%22tax%22%3A%22none%22%7D%5D%7D";
  // default payment e-currency
  $incurrlabel = "BANKOCEAN2R";
  // language
  $culture = "ru";
  // encoding
  $encoding = "utf-8";
  // E-mail
  $Email = "test@test.ru";
  // Expiration Date
  $ExpirationDate = "2029-01-16T12:00";
  // Shp_item
  $Shp_item = "Shp_oplata=1";
  // generate signature
  $signature_value = md5("$merchant_login:$out_sum:$invid:$receipt:$password_1:Shp_item=$shp_item");
  // payment form
  print
    "<html>".
      "<form action='https://auth.robokassa.kz/Merchant/Index.aspx' method=POST>"+
        "<input type=hidden name=MerchantLogin value=$merchant_login>"+
        "<input type=hidden name=OutSum value=$out_sum>"+
        "<input type=hidden name=InvId value=$invid>"+
        "<input type=hidden name=Description value='$description'>"+
        "<input type=hidden name=SignatureValue value=$signature_value>"+
        "<input type=hidden name=Shp_item value='$shp_item'>"+
        "<input type=hidden name=IncCurrLabel value=$incurrlabel>"+
        "<input type=hidden name=Culture value=$culture>"+
        "<input type=hidden name=Email value=$Email>"+
        "<input type=hidden name=ExpirationDate value=$ExpirationDate>"+
        "<input type=hidden name=Receipt value=$receipt>"+
        "<input type=submit value='Оплатить'>"+
    "</form></html>";
?>
```

### Response
#### Success Response (200)
- The user is redirected to the Robokassa payment page to complete the transaction.

#### Response Example
(No direct response body, as this initiates a form submission and redirection)
```

--------------------------------

### Widget Integration with Custom Sum (FormMS.js)

Source: https://docs.robokassa.kz/pay-interface

This example demonstrates how to integrate the Robokassa KZ payment widget for a form with a custom sum. It uses the `FormMS.js` script and assumes MD5 hash calculation.

```APIDOC
## POST /Merchant/PaymentForm/FormMS.js

### Description
Integrates the Robokassa KZ payment widget for a form allowing customers to enter a custom payment amount. This example assumes the MD5 hash calculation method is used for security.

### Method
GET (for script source)

### Endpoint
`https://auth.robokassa.kz/Merchant/PaymentForm/FormMS.js`

### Parameters
#### Query Parameters
- **MerchantLogin** (string) - Required - Your unique merchant login ID.
- **OutSum** (string) - Required - The amount to be paid by the customer.
- **InvoiceID** (integer) - Required - A unique identifier for the transaction within your system. Must be unique for each payment.
- **Description** (string) - Required - A description of the payment or order.
- **SignatureValue** (string) - Required - An MD5 hash generated to ensure the integrity of the payment request. Format: `md5("MerchantLogin:OutSum:InvoiceID:password_1")`

### Request Example
```php
<?php
  $merchant_login = "demo";
  $password_1 = "password_1";
  $invid = 0;
  $description = "Техническая документация по ROBOKASSA";
  $out_sum = "8.96";
  $signature_value = md5("$merchant_login:$out_sum:$invid:$password_1");
  print "<html><script language=JavaScript " +
    "src='https://auth.robokassa.kz/Merchant/PaymentForm/FormMS.js?" +
    "MerchantLogin=$merchant_login&OutSum=$out_sum&InvoiceID=$invid" +
    "&Description=$description&SignatureValue=$signature_value'></script></html>";
?>
```

### Response
#### Success Response (200)
- The widget is displayed on the user's screen, allowing them to proceed with the payment.

#### Response Example
(No direct response body, as this integrates a JavaScript widget)
```

--------------------------------

### Robokassa ResultUrl2 Notification Example

Source: https://docs.robokassa.kz/pay-interface

An example of a payment request URL that includes the ResultUrl2 parameter for additional notifications. This demonstrates how to specify an alternative URL for payment confirmations.

```url
https://auth.robokassa.kz/merchant/Index.aspx?Merchant_login=robokassa&OutSum=10&InvID=1234829&ResultUrl2=https%3A%2F%2Ftest.test%2Frobokassa&Signature=8e8596d1219ff89cbb98d5f3f37bcfc5
```

--------------------------------

### Robokassa KZ Fiscalization Receipt JSON Example

Source: https://docs.robokassa.kz/online

Example JSON structure for transmitting product nomenclature in a receipt for Robokassa KZ fiscalization. This format is used with the 'Kassovoe' - 'Uchet.Kassa-Online' scheme and must be included in the payment initialization parameters and the control sum calculation. The 'items' array contains details for each product or service.

```json
{
  "items": [
    {
      "name": "Название товара 1",
      "quantity": 1,
      "sum": 100,
      "tax": "vat12"
    },
    {
      "name": "Название товара 2",
      "quantity": 3,
      "sum": 450,
      "tax": "vat12"
    }
  ]
}
```

--------------------------------

### Robokassa ResultUrl2 Signature Calculation String

Source: https://docs.robokassa.kz/pay-interface

This example shows the string format used for calculating the signature when the ResultUrl2 parameter is included in the payment request. It highlights the position of ResultUrl2 in the signature base string.

```text
MerchantLogin:OutSum:InvId:Receipt:StepByStep:ResultUrl2:Пароль#1
```

```text
robokassa:10:1234829:https%3A%2F%2Ftest.test%2Frobokassa:password1
```

--------------------------------

### Payment Form with Arbitrary Sum (FormMS.js)

Source: https://docs.robokassa.kz/payment

This example demonstrates how to generate a payment form with an arbitrary sum using the FormMS.js script. It is suitable for scenarios where the payment amount can vary.

```APIDOC
## POST /Merchant/PaymentForm/FormMS.js

### Description
Generates a payment form with a user-defined sum using the FormMS.js script. This endpoint is used for integrating a payment button or form where the customer can specify the amount.

### Method
GET (for script inclusion)

### Endpoint
`https://auth.robokassa.kz/Merchant/PaymentForm/FormMS.js`

### Parameters
#### Query Parameters
- **MerchantLogin** (string) - Required - Your merchant login ID.
- **OutSum** (string) - Required - The total sum of the order.
- **InvoiceID** (integer) - Required - A unique identifier for the invoice in your system.
- **Description** (string) - Required - A description of the payment.
- **SignatureValue** (string) - Required - An MD5 hash generated from `MerchantLogin:OutSum:InvoiceID:password_1`.

### Request Example
```php
<?php
  $merchant_login = "demo";
  $password_1 = "password_1";
  $invid = 0;
  $description = "Техническая документация по ROBOKASSA";
  $out_sum = "8.96";
  $signature_value = md5("$merchant_login:$out_sum:$invid:$password_1");
  print "<html><script language=JavaScript " +
    "src='https://auth.robokassa.kz/Merchant/PaymentForm/FormMS.js?" +
    "MerchantLogin=$merchant_login&OutSum=$out_sum&InvoiceID=$invid" +
    "&Description=$description&SignatureValue=$signature_value'></script></html>";
?>
```

### Response
#### Success Response (200)
Returns an HTML script that renders the payment form.

#### Response Example
(HTML output rendering the payment form)
```

--------------------------------

### Payment Form with Default Sum (FormFLS.js)

Source: https://docs.robokassa.kz/payment

This example shows how to create a payment form with a predefined default sum using the FormFLS.js script. This is useful for fixed-price items or services.

```APIDOC
## POST /Merchant/PaymentForm/FormFLS.js

### Description
Generates a payment form with a default sum using the FormFLS.js script. This endpoint is used for integrating a payment button or form where the amount is fixed.

### Method
GET (for script inclusion)

### Endpoint
`https://auth.robokassa.kz/Merchant/PaymentForm/FormFLS.js`

### Parameters
#### Query Parameters
- **MerchantLogin** (string) - Required - Your merchant login ID.
- **DefaultSum** (string) - Required - The default sum for the payment.
- **InvoiceID** (integer) - Required - A unique identifier for the invoice in your system.
- **Description** (string) - Required - A description of the payment.
- **SignatureValue** (string) - Required - An MD5 hash generated from `MerchantLogin::InvoiceID:password_1`.

### Request Example
```php
<?php
  $merchant_login = "demo";
  $password_1 = "password_1";
  $invid = 0;
  $description = "Техническая документация по ROBOKASSA";
  $default_sum = "10";
  $signature_value = md5("$merchant_login::$invid:$password_1");
  print "<html><script language=JavaScript " +
    "src='https://auth.robokassa.kz/Merchant/PaymentForm/FormFLS.js?" +
    "MerchantLogin=$merchant_login&DefaultSum=$default_sum&InvoiceID=$invid" +
    "&Description=$description&SignatureValue=$signature_value'></script></html>";
?>
```

### Response
#### Success Response (200)
Returns an HTML script that renders the payment form.

#### Response Example
(HTML output rendering the payment form)
```

--------------------------------

### Robokassa Signature Calculation Example

Source: https://docs.robokassa.kz/payment

Demonstrates the calculation of the signature for Robokassa payment requests. It outlines the base string format including MerchantLogin, OutSum, InvId, Receipt, StepByStep, ResultUrl2, and Password#1. This is crucial for verifying the integrity of payment transactions.

```text
robokassa:10:1234829:https%3A%2F%2Ftest.test%2Frobokassa:password1
```

--------------------------------

### Robokassa ResultUrl2 Notification Example

Source: https://docs.robokassa.kz/payment

Shows an example of a JWS (JSON Web Signature) notification sent to the ResultUrl2 address upon successful payment. This notification is base64 encoded and contains payment details for verification.

```json
eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJoZWFkZXIiOnsidHlwZSI6IlBheW1lbnRTdGF0ZU5vdGlmaWNhdGlvbiIsInZlcnNpb24iOiIxLjAuMCIsInRpbWVzdGFtcCI6IjE2OTA0NTQ5ODAifSwiZGF0YSI6eyJzaG9wIjoicm9iby1kZW1vLXRlc3QiLCJvcEtleSI6IjE0RDJCNTIxLTRFQUItNDkyQS05RDkxLTAwRDEyRkYyNEQ1Ny0xTnZIRU5Md2dwIiwiaW52SWQiOiIxMjM0ODI5IiwicGF5bWVudE1ldGhvZCI6IkJhbmtDYXJkIiwiaW5jU3VtIjoiMTAuMDAiLCJzdGF0ZSI6Ik9LIn19.DaanjJ4A2yaGOppIVEj929MGNWU4jHcjAh4_DnFRJzkqvESbVpN5trGg8OlaftyQEldxeQaTF9ykrS7O1BmhPow0ZRv4GwjJQSwHzCGJUOcyVw507PMnRSAIT4oXq_PtKjqjuHQL_bxQxyGxZORoKhzsDwBYl_nMXsY-R_SCXPfvYRDPeJRRlC-HwQscOzyGN1cBHStuh5-w8qHytpaysVlif_XYK1-Lfa3ZsFjNz-2LENGL4CRmKMA2KhUfhNfNWXSA4J2KykfWznAvaY37T__QQHhDyHuIjsUtstG5Jf2aK2CuJY-i9mBTRkXD0U3Y5Lh7lnJQrkXAMBySRvYigQ
```

--------------------------------

### Initiate Robokassa iFrame Payment with MD5 Hash

Source: https://docs.robokassa.kz/iframe

This snippet demonstrates how to initiate a payment using Robokassa's iFrame by calling the `Robokassa.StartPayment` method. It includes essential parameters like MerchantLogin, OutSum, InvId, Description, and the MD5-calculated SignatureValue. Ensure the script is placed within the body tag and note that Apple Pay is not supported with iFrame.

```html
<script type="text/javascript" src="https://auth.robokassa.kz/Merchant/bundle/robokassa_iframe.js"></script>
      <input type="submit" value="Оплатить" onclick="Robokassa.StartPayment({
             MerchantLogin: 'demo',
             OutSum: '40.00',
             InvId: 10,
             Description: 'Оплата заказа в Тестовом магазине ROBOKASSA',
             Shp_Item: '1',
             Culture: 'ru',
             Encoding: 'utf-8',
             SignatureValue: '3925b771e47d405cbcbb492daa936824'})">
```

--------------------------------

### Render Robokassa iFrame Payment with Settings

Source: https://docs.robokassa.kz/iframe

This example shows how to use the `Robokassa.Render` method to initiate an iFrame payment with custom settings. The `Settings` parameter, stringified JSON, allows specifying payment methods (e.g., 'BankCard', 'GooglePay', 'SBP') and the display mode ('Modal' or 'Widget'). This method also requires a `SignatureValue` for security.

```html
<script type="text/javascript" src="https://auth.robokassa.kz/Merchant/bundle/robokassa_iframe.js"></script>
      <input type="submit" value="Оплатить" onclick="Robokassa.Render({
             MerchantLogin: 'demo',
             OutSum: '50',
             InvId: '',
             Description: 'Оплата заказа в Тестовом магазине ROBOKASSA',
             Culture: 'ru',
             Encoding: 'utf-8',
             Settings: JSON.stringify ({PaymentMethods:['BankCard','GooglePay'], Mode:'modal' Р'}),
             SignatureValue: '00c6675e103f387ae5a3c0ba80695b98'})">
```

--------------------------------

### Robokassa KZ Invoice JSON Example

Source: https://docs.robokassa.kz/split

This snippet demonstrates the structure of the 'Invoice' parameter for a Robokassa KZ payment request. It includes details about the transaction amount, custom shop parameters, customer email, currency, language, test mode, expiration date, and merchant split information.

```json
{
  "outAmount": 300,
  "shop_params": [
    {
      "name": "user_param_1",
      "value": "Параметр номер один"
    },
    {
      "name": "user_param_2",
      "value": "Параметр номер два"
    }
  ],
  "email": "testlab@test.ru",
  "incCurr": "BankCard",
  "language": "ru",
  "isTest": false,
  "expirationDate": "2024-08-23T12:53Z",
  "merchant": {
     "id": "kz_split_01_shop_01",
     "comment": "Общее описание заказа"
  },
  "splitMerchants": [
    {
      "id": "kz_split_01_shop_01",
      "InvoiceId": 123,
      "amount": "150",
      "receipt": {
        "items": [
          {
          "name": "товар 1",
          "quantity": 2,
          "sum": 150,
          "tax": "none"
          }
        ]
      }
    },
    {
      "id": "kz_split_02_shop_01",
      "amount": 150,
      "receipt": {
        "sno": "usn_income",
        "items": [
          {
            "name": "товар 2",
            "quantity": 1,
            "sum": 150,
            "tax": "none"
          }
        ]
      }
    }
  ]
}
```

--------------------------------

### Generate Payment Link

Source: https://docs.robokassa.kz/script-pay

Learn how to construct a payment link by substituting variables with your store's specific data and calculating the necessary signature value.

```APIDOC
## Generate Payment Link

### Description
Construct a payment link by substituting variables with your store's specific data and calculating the necessary signature value.

### Method
GET

### Endpoint
`https://auth.robokassa.kz/Merchant/Index.aspx`

### Parameters
#### Query Parameters
- **MerchantLogin** (string) - Required - Your store ID.
- **OutSum** (number) - Required - The total cost of the order.
- **InvoiceID** (string) - Required - A unique identifier for the order in your store. Use '0' for initial setup.
- **Description** (string) - Required - A description of the purchase.
- **SignatureValue** (string) - Required - The calculated signature value (MD5 hash).

### Request Example (Constructing the link)
1. **Base URL**: `https://auth.robokassa.kz/Merchant/Index.aspx`
2. **Parameters**: 
   - `MerchantLogin`: `demo`
   - `OutSum`: `11`
   - `InvoiceID`: `0`
   - `Description`: `Покупка в демо магазине`
3. **Signature Calculation String**: `$mrh_login:$out_summ:$inv_id:$mrh_pass1`
   - Example: `demo:11:0:YourPassword#1`
4. **Calculate SignatureValue**: Use an MD5 calculator with the string from step 3.
   - Example Result: `56f978e24d1b51fa7b5ace90a4f4ba53`
5. **Final URL**: `https://auth.robokassa.kz/Merchant/Index.aspx?MerchantLogin=demo&OutSum=11&InvoiceID=0&Description=Покупка в демо магазине&SignatureValue=56f978e24d1b51fa7b5ace90a4f4ba53`

### Response
#### Success Response (302 Redirect)
Redirects the user to the payment gateway.

#### Response Example
(HTTP 302 Found)
Location: [Payment Gateway URL]
```

--------------------------------

### Get Currencies XML Response Structure

Source: https://docs.robokassa.kz/xml-interfaces

The structure of the XML response when requesting a list of currencies. It includes a Result element and a CurrenciesList containing groups of currencies with their labels, aliases, and names.

```xml
<CurrenciesList xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://merchant.roboxchange.com/WebService/">
  <Result>
    <Code>integer</Code>
    </Result>
  <Groups>
    <Group Code=string Description=string>
      <Items>
       <Currency Label=string; Alias=string; Name=string>
         ...
          </Items> 
    </Group>
    ...
  </Groups>
 </CurrenciesList>
```

--------------------------------

### GetCurrencies - Get List of Currencies

Source: https://docs.robokassa.kz/xml-interfaces

Retrieves a list of currencies available for paying orders for a specified store (website). This is used for setting the IncCurrLabel parameter and displaying available payment options on your website.

```APIDOC
## GetCurrencies - Get List of Currencies

### Description
Returns a list of currencies available for paying orders for the specified store (website). It is used to specify values for the IncCurrLabel parameter, and also to display available payment options directly on your website if you wish to provide more information to your clients.

### Method
GET or POST

### Endpoint
`https://auth.robokassa.kz/Merchant/WebService/Service.asmx/GetCurrencies`

### Parameters
#### Query Parameters
- **MerchantLogin** (string) - Required - Identifier of the store.
- **Language** (string) - Optional - Language for localized values in the response (currency names, payment methods, etc.). Possible values: `en` (English), `ru` (Russian).

### Request Example (GET)
`https://auth.robokassa.kz/Merchant/WebService/Service.asmx/GetCurrencies?MerchantLogin=demo&Language=ru`

### Response
#### Success Response (200)
Returns an XML document with currency information.

#### Response Structure
```xml
<CurrenciesList xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://merchant.roboxchange.com/WebService/">
  <Result>
    <Code>integer</Code>
    <Description>string</Description>
  </Result>
  <Groups>
    <Group Code=string Description=string>
      <Items>
        <Currency Label=string Alias=string Name=string>
          ...
        </Currency>
      </Items>
    </Group>
    ...
  </Groups>
</CurrenciesList>
```

### Response Fields
- **Groups**: Currency groups. Can be used for more convenient display of currencies in the user interface.
  - **Code** (string) - Group code.
  - **Description** (string) - Text description of the group.
  - **Items**: Currencies within the group.
    - **Currency**:
      - **Label** (string) - Currency code.
      - **Alias** (string) - Currency alias.
      - **Name** (string) - Currency name.
```
Tokens:
Raw