⚙️Payment form integration

1. Get a token to open the form

2. Open form

3. Make a deposit/payment

4. Receive a callback with invoice status

Request address to receive a token

https://cactusgino.com/api/jsapi/obtain_token/

shell

curl -X POST -H "Content-Type: application/json" \
     -d '
    {
    "site_id": 1,
    "site_login": "551d0ad9072b30f3b71b989e",
    "merchant_id": "merch_id",
    "request_id":"jnvdjd094vnd",
    "amount":900000,
    "method":"card",
    "customer_type":"trust",
    "signature": "mnasdkansda09sdjaslkdnalkd",
    "currency": "KZT"
    }'
 https://cactusgino.com/api/jsapi/obtain_token/

Failed response

{
  "success": false,
  "message": "Invalid ContentType or json format",
  "signature": "jnfndssfdjkfndsnf09jf"
}

Successful response

{
  "success": true,
  "key": "u48fbalfjf904903nb7s830fnaoa0jnfkoddijfkjf9442jijex",
  "redirect_url": "https://pp.ohboo0ie.com/api/jsapi/open/3d6f4a7992bbc19d95e4951cc4387e1dabe04c4bf086cd675009030e75b6a5cd/",
  "signature": "jd93jdslkajldkjskldjskald0"
}

python

import requests

url = 'https://cactusgino.com/api/jsapi/obtain_token/'

json = dict(
    site_id=1,
    site_login="551d0ad9072b30f3b71b989e",
    merchant_id="merch_id",
    request_id="jnvdjd094vnd",
    amount=90000,
    signature="eve84knnfdjnknfsdjfsdfjs0d9jf",
    currency="KZT",
    method="card"
    customer_type="trust",
)
response = requests.post(url, json=json)
data = response.json()

Failed response

{
  "success": false,
  "message": "Invalid ContentType or json format",
  "signature": "jnfndssfdjkfndsnf09jf"
}

Successful response

{
  "success": true,
  "key": "u48fbalfjf904903nb7s830fnaoa0jnfkoddijfkjf9442jijex",
  "signature": "jd93jdslkajldkjskldjskald0"
}

Take the key value from the response to receive a token and open the form to the user.

Depending on your website’s settings, the response parameters may include the redirect_url parameter. In this case, the user should be redirected to the specified URL to complete the payment.

Opening a form

Parameter	Required	Format	Description	Example
merchant_id	Yes	string	Merchant ID, to be determined in the system	superkey
site_login	Yes	string	Login of the user making the payment	jnsdf093jfsdklfndf09
site_id	Yes	integer	Your site_id	1
request_id	Yes	string	Order ID in the seller's system	uib64bc9494n9v
amount	Yes	integer	Amount to be paid in minor units (numbers after ".")	9000
signature	Yes	string	See request signature. Rules for forming a request signature
currency	Yes	string	Currency	KZT
method	No	string	Open the interface, with a pre-selected method, possible values are sbp, card, qiwi, cash, mobile, binance, MTSPay, WalletM10, Emanat, wise, skrill, cis_transfer, cis_transfer_card, localbanks, papara, Tbank_card, PIX	card
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"	trust
language	No	string	A parameter that sets the language of the payment page interface. Available values: EN - English, UA - Ukrainian, RU - Russian, KZ - Kazakh, AZ - Azerbaijani, IN - Indonisian, ID - Hindi. EN - default parameter, it’s determined when “language” is not recognized.	EN
success_url	No	string	Redirect link upon successful deposit	https://google.com
fail_url	No	string	Redirection link in case of unsuccessful deposit	https://google.com
additional_fields	No	object	Additional options for certain payment methods.

additional_fields:

• cis_transfer, cis_transfer_card:

  • bank_app(required): The parameter that determines which bank the transfer will originate from. The user interface instructions for making a transfer depend on this parameter. Available values: sberbank and tbank

• Other payment methods do not require additional fields.

Example of a cis_transfer payment method request

Request

curl -X POST -H "Content-Type: application/json" \
     -d '
    {
    "site_id": 1,
    "site_login": "551d0ad9072b30f3b71b989e",
    "merchant_id": "merch_id",
    "request_id":"jnvdjd094vnd",
    "amount":900000,
    "method":"cis_transfer",
    "customer_type":"trust",
    "signature": "mnasdkansda09sdjaslkdnalkd",
    "currency": "RUB"
    "additional_fields": {
        "bank_app": "tbank"
        }
    }'
 https://cactusgino.com/api/jsapi/obtain_token/

Request address for opening iframe

https://cactusgino.com/api/jsapi/open/{key}/