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

afsfasf3434

{ 
    "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

{
    "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

si

{ 
    "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

{
    "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

afsfasf3434

site_id

Yes

integer

Site ID

123

request_id

Yes

string

Payment ID from the merchant

kjksjf-fsdff-s

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
}

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

f

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

message

Yes

string

Error message if any

No card available

Last updated