Overview

Authorization

Authorization of the request occurs by generating and transmitting the JWS token of the request in the X-JWS-Signature header. JWS is the part of the JWT token that contains only header and signature.
Format of the transmitted data is application/json.

Example of signature formation

Request body

{
    "request_id": "828cf71d-a447-4a67-a149-c1df8bc197ca",
    "country": "KAZ",
    "currency": "KZT"
}

JWT token header

{
    "uri": "/v5/partner/wallet/add",
    "auth_id": "123456",
    "method": "POST",
    "params": "",
    "alg": "HS256"
}

The partner's key can be secret_key. In this case, the following JWT token can be generated:

eyJ1cmkiOiIvdjUvcGFydG5lci93YWxsZXQvYWRkIiwiYXV0aF9pZCI6IjEyMzQ1NiIsIm1ldGhvZCI6IlBPU1QiLCJwYXJhbXMiOiIiLCJhbGciOiJIUzI1NiJ9.eyJyZXF1ZXN0X2lkIjoiODI4Y2Y3MWQtYTQ0Ny00YTY3LWExNDktYzFkZjhiYzE5N2NhIiwiY291bnRyeSI6IktBWiIsImN1cnJlbmN5IjoiS1pUIn0.5xVbhml5y1Uw1TYQ_djwwefFz8y_CnX-ajzNvOBCcmE

This line is the signature of the request and must be passed in the request header parameter X-JWS-Signature.

eyJ1cmkiOiIvdjUvcGFydG5lci93YWxsZXQvYWRkIiwiYXV0aF9pZCI6IjEyMzQ1NiIsIm1ldGhvZCI6IlBPU1QiLCJwYXJhbXMiOiIiLCJhbGciOiJIUzI1NiJ9..5xVbhml5y1Uw1TYQ_djwwefFz8y_CnX-ajzNvOBCcmE

Supported HS256 signature encryption algorithm.

Request

Code	Description
`0`	Successfully processed.
`1`	In processing.
`2`	Processing error.

Operation

Code	Description
`emoney_sale`	Realization of electronic money.
`emoney_buy`	Purchase of electronic money.
`emoney_emission`	Emission of electronic money.
`emoney_transfer`	Transfer of electronic money.
`emoney_pay`	Repayment of electronic money.
`emoney_servicepay`	Payment for services.

Error codes

Code	Description
`1001`	Incorrectly provided input parameters.
`1002`	Non-unique request identifier.
`1003`	A wallet with the specified identifier has already been created.
`1004`	A wallet with the specified identifier was not found.
`1005`	Failed to close the wallet.
`1006`	A request with the specified identifier was not found.
`1007`	The wallet is already closed.
`1008`	Failed to block the wallet.
`1009`	The wallet is already blocked.
`9999`	System error, please try again later.
`1000`	Service unavailable.

Authorization#

Example of signature formation#

Request body#

JWT token header#

Request#

Operation#