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

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
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
    "amount": 10000.0,
    "status": 4,
    "site_id": "34",
    "site_login": "test_login",
    "request_id": "43435",
    "invoice_id": 343445,
    "currency": "USD",
    "received_currency": "USD",
    "received_amount": 43
}

python

Response parameters

Parameters	Required	Format	Description	Example
success	Yes	bool	Request success	False
amount	Yes	int	Transaction amount in order currency in minor units, for example for US dollars - in cents	10000
status	Yes	int	Operation status	4
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
invoice_id	Yes	int	Unique id in the cactus system	905910
currency	Yes	string	Currency	KZT
received_currency	Yes	string	Currency in which the payment will be made	KZT
received_amount	int	Numeric	Final payment amount (if payment is unsuccessful, returns 0) minor units	10000
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

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