Additional endpoints

Get balance

Request address

https://cactusgino.com/api/balance/

Request parameters

Parameter	Required	Format	Description	Example
merchant_id	Yes	string	merchant_id	afsfasf3434
site_id	Yes	integer	Site ID	123
currency	No	string	Currency	USD
signature	Yes	string	request signature	afsfasf3434

Shell

{ 
    "merchant_id": "test_api_v2",
    "site_id": "101",
    "currency": "USD",
    "signature": "some"
}

Python

{ 
    "merchant_id": "test_api_v2",
    "site_id": "101",
    "currency": "USD",
    "signature": "some"
}

Response parameters

Parameter	Format	Description	Example
site_id	integer	Site ID	123
balance	array
id	integer	Balance ID	1
name	string	Balance name	Balance_USD
amount	integer	Balance amount	1000.0
available	integer	Available balance	900.0

Python

{
    "site_id": 101,
    "balances": [
        {
            "id": 1,
            "name": "Test_balance_1",
            "currency": "USD",
            "amount": 10000.0,
            "available": 10000.0
        },
        {
            "id": 3,
            "name": "bal_eur_1",
            "currency": "EUR",
            "amount": 14600.0,
            "available": 14600.0
        }
    ]
}

Get project balance

Request address

https://cactusgino.com/api/balance_project/

Request parameters

Parameter	Required	Format	Description	Example
project_id	Yes	string	Project ID	2
merchant_id	Yes	string	merchant_id	afsfasf3434
site_id	Yes	integer	Site ID	123
currency	No	string	User login on the merchant's website	USD
signature	Yes	string	request signature	si

Python

{ 
    "project_id": "2",
    "merchant_id": "test_v2",
    "site_id": "101",
    "currency": "USD",
    "signature": "some"
}

Response parameters

Parameter	Format	Description	Example
project_id	string	Project ID	2
project_balance	array
currency	string	Currency of summary in project	USD
amount	integer	Balance summary amount in project	1000.0
available	integer	Available summary balance in project	900.0

Python

{
    "project_id": 101,
    "project_balance":[
 
         {
            "currency": "USD",
            "amount": 10000.0,
            "available": 10000.0  
        },
        {
            "currency": "EUR",
            "amount": 10000.0,
            "available": 10000.0
        }
 
     ]
}

Canceling SBP and P2P invoices

Request address

https://cactusgino.com/api/close_invoice/

Request parameters

Parameter	Required	Format	Description	Example
site_login	Yes	string	site_login of the user, previously sent to create an invoice	afsfasf3434
merchant_id	Yes	string	merchant_id	afsfasf3434
signature	Yes	string	request signature	afsfasf3434
site_id	Yes	integer	Site ID	123
site_login	Yes	string	User login on the merchant's website	test_login
request_id	Yes	string	Payment ID from the merchant	kjksjf-fsdff-s

shell

Failed response

{
  "success": false,
  "message": "Invalid ContentType or json format",
  "signature": "kfnf3-njdfsd-fdsfkdsf"
}

Successful response

{
    "success": true
}

python

Failed response

{
  "success": false,
  "message": "Invalid ContentType or json format",
  "signature": "kfnf3-njdfsd-fdsfkdsf"
}

Successful response

{
    "success": true
}

Response parameters

Parameters	Required	Format	Description	Example
site_id	Yes	integer	Site ID	123
site_login	Yes	string	User login on the merchant's website	test_login
status	Yes	int	Operation status	4
success	Yes	bool	Request success	False
invoice_id	Yes	int	Unique id in the cactus system	905910
request_id	Yes	string	Payment ID from the merchant	kjksjf-fsdff-s
amount	Yes	int	Transaction amount in order currency in minor units, for example for US dollars - in cents	10000
received_amount	int	Numeric	Final payment amount (if payment is unsuccessful, returns 0) minor units	10000
currency	Yes	string	Currency	KZT
received_currency	Yes	string	Currency in which the payment will be made	KZT
signature	Yes	string	See request signature . Rules for forming a request signature
message	Yes	string	Error message if any	No card available

Checking the invoice status

Request address

https://cactusgino.com/api/check_status/

Request parameters

Parameters	Required	Format	Description	Example
merchant_id	Yes	string	Merchant ID, to be determined in the system	superkey
site_login	Yes	varchar(256)	Login of the user making the payment	jnsdf093jfsdklfndf09
site_id	Yes	integer	Your site_id	21
request_id	Yes	string	Order ID in the seller's system	uib64bc9494n9v
signature	Yes	string	See request signature . Rules for forming a request signature	f

shell

Failed response

{
  "success": false,
  "message": "Invalid ContentType or json format",
  "signature": "kfnf3-njdfsd-fdsfkdsf"
}

Successful response

{
    "success": true,
    "status": 4,
    "site_id": 701,
    "site_login": "jkaja74nfkjndsf09dsjfmdosif0-sdf,",
    "request_id": "dmnks-dfdsf-dfsdf-sfdds",
    "invoice_id": 1231314,
    "currency": "USD",
    "signature": "dasdmdkmdasdsd0dsa0kdk20d2k2d2"

}

python

Failed response

{
  "success": false,
  "message": "Invalid ContentType or json format",
  "signature": "kfnf3-njdfsd-fdsfkdsf"
}

Successful response

{
    "success": true,
    "status": 4,
    "site_id": 701,
    "site_login": "jkaja74nfkjndsf09dsjfmdosif0-sdf,",
    "request_id": "dmnks-dfdsf-dfsdf-sfdds",
    "invoice_id": 1231314,
    "currency": "USD",
    "signature": "dasdmdkmdasdsd0dsa0kdk20d2k2d2"

}

Response parameters

Parameter	Required	Format	Description	Example
site_id	Yes	integer	Site ID	123
site_login	Yes	string	User login on the merchant's website	test_login
status	Yes	Enum	Operation status	4
invoice_id	Yes	int	Unique id in the cactus system	905910
request_id	Yes	string	Payment ID from the merchant	kjksjf-fsdff-s
amount	Yes	int	Transaction amount in order currency in minor units, for example for US dollars - in cents	10000
received_amount	int	Numeric	Final payment amount (if payment is unsuccessful, returns 0) minor units	10000
success	Yes	bool	Request success	True
currency	Yes	string	Currency	KZT
received_currency	Yes	string	Currency in which the payment will be made	KZT
signature	Yes	string	See request signature . Rules for forming a request signature
message	Yes	string	Error message if any	No card available