Info

Use this method to provide payment details to the payer after they are redirected from the merchant platform to the payment app. This method is called when an invoice is paid.

Request Header block

Request headers

Name	Value	Description
X-Request-Id	uuid v7	Unique request Id
Content-type	application/json	Request body format
X-JWS-Signature	string	Request signature
Accept	application/json	Request body format

Response Header block

Response headers

Name	Value	Description
X-Request-Id	uuid v7	Unique request Id
X-Datetime	datetime	Date and time of request processing
X-Request-Status	string	Request body format

Generating the X-JWS-Signature

To send any request, a request signature must be generated using JWS technology.
The JWS format must include the mandatory blocks header and signature and should be passed in the request header X-JWS-Signature.

Header structure

{
    "uri": "/v5/partner/invoices/info",
    "auth_id": "12345", 
    "method": "POST",
    "params": "" 
    "alg": "HS256"
}

Header description:

Name	Description	Field requirement
uri	The path to the API endpoint being called	Required
auth_id	User ID for signature verification	Required
method	Request method	Required
params	Reserved field	Required
alg	Encryption algorithm	Required

Payload structure

The payload for generating JWS includes the HTTP request body.
The supported signature encryption algorithm is HS256, and the merchant's secret_key should be used as the signing key.

{
  "id": "b4c5c7de-99f2-4c1d-b61d-7a8e9df22f7b"
}

Generated JWS:

eyJwYXRoIjoiL3Y1L21lcmNoYW50L2ludm9pY2UvaW5pdCIsIm1lcmNoYW50X2lkIjoxMjM0NTYsIm1ldGhvZCI6IlBPU1QiLCJwYXJhbXMiOiIiLCJhbGciOiJIUzUxMiJ9..wCwFCAmxN0nbTm6mad8GxowIjgkCwfF7IAy2ijO9thLjsZFXnS4K_I4NPnXjkTFTMnEzqjk8rtIVmtf7NbGyvg

Responses

🟢200Success

application/json

Body

Example

{
    "status": "new",
    "amount": 500.00,
    "currency": "KZT",
    "merchant_id": 12345,
    "merchant_name": "SHOP NAME",
    "description": "invoice description",
    "expires_at": "2026-01-23T11:00:00Z",
    "back_url": "https://back.url",
    "refunds": [
        {
            "id": "019d0652-4e2f-7f54-a179-007c80c48cef",
        }
    ],
    "tax": [
        {
            "name": "Position",
            "price": 500.00,
            "type": "standard",
            "count": 1
        }
    ],
    "device": {
        "id": "device-abc-123",
        "browser_version": "Chrome/121.0.0.0",
        "ip": "85.116.189.120"
    },
    "created_at": "2026-01-22T11:00:00Z"
}

Request Header block#

Response Header block#

Generating the X-JWS-Signature#

Header structure#