Payout

Request to create an invoice for payment. In response to this request, a response will be provided with success if the invoice has been created and it is possible to make a payment.

Request address

https://cactusgino.com/api/payout/

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",
    "additional_fields": {
        "bank_name": "Morgan",
        "card_holder":" John Wick",
        "card_number":"0000000000000"
    }
}' https://cactusgino.com/api/payout/

Failed response

{
  "success": false,
  "message": "Invalid ContentType or json format",
  "signature": "lfdfndsfksd-f93nfjdf-ds"
}

Successful response

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

python

import requests

url = 'https://cactusgino.com/api/payout/'
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",
    additional_fields={
        "bank_name": "Morgan",
        "card_holder":" John Wick",
        "card_number":"0000000000000"
    }
)
response = requests.post(url, json=json)
data = response.json()

Failed response

{
  "success": false,
  "message": "Invalid ContentType or json format",
  "signature": "lfdfndsfksd-f93nfjdf-ds"
}

Successful response

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

Request 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	Your 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'.
additional_fields	Yes	object	Additional options for certain payment methods.

additional_fields:

List of required fields for a specific payment method; parameters must be passed as a string.

For example, for a method, cardthe required fields arecard_number

• card:

  • bank_name(optional): Bank name. Example: Morgan

  • card_holder(optional): Owner's full name. Example: John Wick

  • card_number(required): Card number for payment. Example: 4242424242424242

  • bank_option (optional): It can be FIN ID or VOEN for the PASA bank. Example: 778953337789

  • expiry date (optional): Card expiry date. Example: 07/23

• localbanks:

  • account_number (required): Account number for payment. Example: 40702810800070000366

  • bank_name (optional): Bank name. Example: Testbank

  • account_holder (optional): Owner's full name. Example: John Wick

• sbp:

  • bank_name(optional): Bank name. Example: Morgan

  • phone_holder(required): Owner's full name. Example: John Wick

  • phone_number(required): Phone number for payment. Example: 79999999999

• mts:

  • phone_number(required): Phone number for payment. Example: 79999999999

• skrill:

  • skrill_account(required): Skrill account identification (email or phone). Example: [e-mail]

  • skrill_holder(required): Account holder name. Example: Potter Vasya

• wise:

  • wise_tag(required): Wise tag name. Example: @examplovich23

  • wise_holder(required): Account holder name. Example: Petrov Vasya

• WalletM10/Emanat:

  • phone_number(required): Phone number for payment. Example: 79999999999

• cash:

  • address(required): Address. Example: Pushkin street, Kolotushkin house 5

  • username(required): Username. Example: @test

  • messenger(required): Messenger. Example: telegram

  • asap(optional): Flag to indicate urgency. Example: true

  • time(optional): Time. Example: 2023-05-01 10:22

  • verification_code(required): Verification code. Example: 123456

• papara:

  • papara_account(required): Papara account ID. Example: 9925125660

  • papara_holder(required): Owner's full name. Example: John Wick

  • phone_number(required): Phone number for payment. Example: 79999999999

• PIX:

  • phone_number (required): Phone number for payment. Example: 79999999999

  • account_holder (required): Account holder name. Example: John Wick

  • pix_transfer_key (required): Pix transfer key. Example: 123e4567-e89b-12d3-a456-426655440000

• Other payment methods do not require additional fields.

Response parameters

Field	Description
signature	Request signature
request_id	Request ID
success	Request status
status	Invoice status
amount	Invoice amount
site_login	User login
site_id	site_id
currency	Request currency
invoice_id	Invoice ID in our system