Additional deposits callbacks

In cases where deposits from the user are found on the Cactus platform (for example, if a deposit is made twice for one invoice)

It is important to note that ideally, a good practice is to ensure that one invoice equals one deposit

In these instances, Cactus operators will create an invoice of their own, and a callback (described below) will inform the merchant about the additional deposit

Callbacks parameters

Parameter
Required
Format
Description
Example

is_payout

No

bool

whether the transaction is a payment

false

site_login

Yes

string

User login on the merchant's website

test_login

invoice_id

Yes

int

Unique id in the cactus system

905910

method

Yes

string

Type of method used in the invoice

card

amount

Yes

int

Transaction amount in order currency in minor units, for example for US dollars - in cents

10000

description

Yes

string

Description of cases of exceptions. The value is empty if the response is successful

Manual created payment

site_id

Yes

int

Site ID

123

signature

Yes

string

f4eb33161e94aa8d816a9d053e7008f6ae9237c

status

Yes

Enum

Operation status

4

received_amount

Yes

int

Final payment amount (if payment is unsuccessful, returns 0) minor units

10000

received_currency

Yes

string

Currency in which the payment will be made

KZT

currency

Yes

string

Currency

KZT

Example of success response

{
    "request_id": "280",
    "signature": "f4eb33161e94aa8d816a9d053e7008f6ae9237c",
    "site_login": "qtywugbjbjbal123",
    "amount": 8000,
    "message": "",
    "transaction_id": "11657913317442782754521496079",
    "status": 3,
    "currency": "USD",
    "site_id": 21,
    "invoice_id": 905900,
    "received_amount": 8000,
    "received_currency": "USD",
    "method": "card"
}

Description in exceptional cases

Value in "description" parameter
Response description

Payout Invoice status set to Success by user {user}

The Cactus operator ({user}) has manually set the status of the payout invoice to 'Success'

Manual created payment

The Cactus operator has manually made an invoice for the lost accrual

Last updated