Success parameters

In some cases, the set of parameters transmitted in the notification may be changed without prior notice.

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

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

Yes

int

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

10000

is_payout

No

bool

whether the transaction is a payment

false

currency

Yes

string

Currency

KZT

received_currency

Yes

string

Currency in which the payment will be made

KZT

method

Yes

string

Type of method used in the invoice

card

signature

Yes

string

description

Yes

string

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

Session expired

Example of a successful callback

{
    "request_id": "280",
    "signature": "f4eb33161e94aa78d816a9d053e7008f6ae9237c",
    "site_login": "qtywugbjhdbjbal123",
    "amount": 8000,
    "description": "",
    "transaction_id": "116579133176442782754521496079",
    "status": 3,
    "currency": "USD",
    "site_id": 21,
    "invoice_id": 905910,
    "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

Description of other cases

Value in "description" parameter
Response description

Session expired. No success payment

The user's session has expired due to inactivity or authentication timeout

Receive {response['status']} after request - {response['status']}

Final status in integration with processing

Could not make payout. Server respond incorrect

Some problems with automatic payouts

Another bill has already been paid

When the user has "n" invoices and receives a successful payment on one of them, we will close the remaining invoices (only deposits)

No payment received

The expected payment for the invoice was not received

Payout Invoice status set to Decline by user {user}

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

Payout Invoice status set to Success by user {user}

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

User close invoice

The user has closed the invoice, and no further action will be taken

Last updated