H2H Integration

Creating an invoice for payment

Request to create an invoice for payment. In response to this request, details for transferring funds or refusal to carry out the transaction will be provided.

The time it takes to receive a response from the server can be quite long (more than a minute) due to the fact that there is a search for a suitable operator, waiting for confirmation from him that he is ready to carry out the transaction.

Request address

https://cactusgino.com/api/create_invoice/

curl -X POST -H "Content-Type: application/json" -d '
{
    "merchant_id": "merch_id",
    "site_login": "user_login",
    "site_id": 21,
    "request_id": "request_id123",
    "amount": 900000,
    "signature": "signature_value",
    "currency": "KZT",
    "method": "card",
    "customer_type":"trust",
    "additional_fields": {
        "bank_name": "Morgan"
    }
}' https://cactusgino.com/api/create_invoice/

Failed response

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

Successful response

{
    "message": "Payout initialized",
    "request_id": "some_id",
    "success": true,
    "status": 3,
    "amount": 900000,
    "site_login": "user_login",
    "site_id": 21,
    "signature": "signature_value",
    "invoice_id": 1314
}

Parameters

Parameter
Required
Format
Description

merchant_id

Yes

string

Merchant ID to be determined in the system.

site_login

Yes

string

Login of the user making the payment.

site_id

Yes

integer

Yours site_id.

request_id

Yes

string

Order ID in the seller's system.

amount

Yes

integer

Amount to be paid in minor units (kopecks).

signature

Yes

string

See request signature . Rules for forming a request signature

currency

Yes

string

Currency. Available values: 'USD', 'EUR', 'RUB', 'UAH', 'USDT', 'IDR', 'AZN', 'VND'.

method

Yes

string

Payment method. Available values: 'card', 'sbp', 'WalletM10', 'localbanks', 'binance', 'cash', 'MTS', 'sbp_qr', 'Emanat', 'Tbank_card', 'cis_transfer', 'PIX'

customer_type

No

string

A parameter that sets the customers type (Trust or Not Trust). Available values: "trust" - trust customer, "regular" - not trust. For any other parameter values, the default value will be "regular"

additional_fields

No

object

Additional options for certain payment methods.

additional_fields:

  • cardand sbp:

    • bank_name(optional): Bank name.

  • cash:

    • address(required): Address.

    • username(required): Username.

    • messenger(required): Messenger.

    • verification_code(optional): Verification code.

    • asap(optional): Flag to indicate urgency.

    • time(optional): Time.

    • asapThe and fields timeare marked as optional, but at least one of them is required

  • cis_transfer:

    • bank_app (required): This mandatory field specifies the mobile banking application from which the user will initiate the transfer. It accepts one of the following values: ['Sberbank', 'Tinkoff']. The choice of bank app impacts the applicable exchange rates and the available account details for the transaction. Funds transferred using these options are directed to accounts located outside of Russia, within the CIS region.

  • Other payment methods do not require additional fields.

Response parameters

Field
Description
cis_transfer
card
sbp
WalletM10
wise
Emanat
localbanks
binance
cash
MTS
sbp_qr

card

Card/phone/account number

Yes

Yes

Yes

Yes

Yes

Yes

Yes

-

-

Yes

Yes

request_id

Request ID

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

success

Invoice success

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

invoice_id

Invoice ID in our system

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

status

Invoice status

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

amount

Invoice amount

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

site_login

User login

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

card_holder

Cardholder details

Yes

Yes

Yes

Yes

Yes

Yes

Yes

-

-

Yes

Yes

invoice_lifetime

Invoice lifetime

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

bank_name

Bank's name

Yes

Yes

Yes

Yes

Yes

Yes

Yes

Yes

-

Yes

Yes

address

Address

-

-

-

-

-

-

-

-

Yes

-

-

messenger

Messenger

-

-

-

-

-

-

-

-

Yes

-

-

username

Username

-

-

-

-

-

-

-

-

Yes

-

-

asap

Urgency flag

-

-

-

-

-

-

-

-

Yes

-

-

time

Time

-

-

-

-

-

-

-

-

Yes

-

-

currency

Currency

Yes

-

-

-

-

-

-

-

Yes

-

-

verification_code

Verification code

-

-

-

-

-

-

-

-

Yes

-

-

pay_link

Payment link

-

-

-

Yes

Yes

-

Yes

Yes

-

Yes

Yes

qr

svg QR code

-

-

-

Yes

Yes

-

-

-

-

-

Yes

qr_link

QR link

-

-

-

Yes

Yes

-

-

Yes

-

-

-

country

Country for CIS transfer

Yes

-

-

-

-

-

-

-

-

-

-

PreviousPayoutNextCallbacks

Last updated