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/

shell

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
}

python

import requests

url = 'https://cactusgino.com/api/create_invoice'
json = dict(
    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"
    }
)
response = requests.post(url, json=json)
data = response.json()

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