Versions Compared

Old Version 1

changes.mady.by.user barto

Saved on

compared with

New Version 2

changes.mady.by.user barto

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Payment

  1. The user is provided with wallet details to which payment must be made.
  2. The user makes a payment in their wallet app and receives a unique transaction number.
  3. Next, the user enters a unique transaction number in the payment window, after which the transaction is activated.
  4. Paykassma sends a postback to the merchant's side.
  5. Funds are credited to the user’s balance on the merchant platform.

Тable of contents

Table of Contents
excludeТable of contents

Payment window integration (plugin)

Example of a link to open a Itau Paraguay Manual payment window:

https://plugin.{server_URL_сервера}/?
label=label
&currency_code=PYG
&lang=lang
&wallet_type=itau_ml
&custom_transaction_id=custom_transaction_id
&fixed_amount=fixed_amount
&payment_url_success_id=2
&payment_url_pending_id=3
&payment_url_fail_id=1
&success_url=hash
&fail_url=hash
&pending_url=hash


Code Block
wallet_type=itau_ml
currency_code=PYG
Available languages (lang): en, es
Info

Pay attention to the description of the parameters payment_url_success_id / payment_url_fail_id/ payment_url_pending_id and success_url / fail_url / pending_url.
To use payment_url_success_id / payment_url_fail_id / payment_url_pending_id you need to send the URLs to Paykassma support and use the received IDs in the parameters.
To use success_url / fail_url / pending_url you must use hashing URLs ( For more details on hashing click here ).

For the description of all the plug-in parameters click here.

API integration

Creating payment 

URL: https://api.{server_URL}/api/v1/transaction/create/itau_ml?secret={pluginapi_secret}

At this stage we first accept a request for input through the payment system and in response we will provide the wallet details to which the user should transfer the payment. After the payment is made you will need to send a request to activate the transaction.

Request method:

POST

Format:
JSON

Parameters:

Name

Type

Required

Max Length

Description

currencystringyes3Currency code.

label

string

yes

190

The unique identifier (ID) of the user who makes the payment.


Code Block
languagephp
themeDJango
titleRequest
{
  "currency": "PYG",
  "label": "eligendi"
}


Code Block
languagephp
themeDJango
titleResponse Success
{
    "status": "ok",
    "params": {
        "Account number": "220000000",
        "Account name": "Account Test Name",
        "is_check_amount": null
    }
}


Code Block
languagephp
themeDJango
titleResponse Fail
{
    "status": "fail",
    "message": "MESSAGE"
}

Activation request

URL: http://api.{server_URL}/api/v1/possible-transaction?secret={pluginapi_secret}

Request method:
POST

Format:
form-data

Parameters:

Name

Type

Required

Max Length

Description

currency_codestringyes3Currency code (PYG).

wallet_type

string

yes

190

itau_ml
labelstringyes190The unique identifier (ID) of the user who makes the payment. 
key1stringyes10Transaction number received from the user. Length from 6 to 10 digits.
screenshotfileyes
Screenshot of the payment from the user.
amountintyes256Payment amount.
custom_transaction_id

string

yes190

The identifier of the transaction in the Client's system.

Must be unique.


Code Block
languagephp
themeDJango
titleResponse Success
{
    "status": "success",
    "message": "",
    "code": 20000,
    "data": [],
    "paginate": {
        "offset": 0,
        "total": 1,
        "limit": 1
    }
}


Code Block
languagephp
themeDJango
titleResponse Fail
{
    "status": "fail",
    "message": "MESSAGE"
}

Deposit postback

For the general documentation on post backs click here.

Example of a deposit postback for a Itau Paraguay Manual

Code Block
languagephp
themeDJango
collapsetrue
{
    "signature": "50f7ad0d213b28e6f7fb7a19726e521d722ec500",
    "wallet_type": "itau_ml",
    "amount": 25000,
    "currency_code": "PYG",
    "label": "test_label1234",
    "direction": "ingoing",
    "created_datetime": "2025-11-11 15:38:48",
    "access_key": "uowkn0b3LfBxpcWYHi4_",
    "additional_data": [
        {
            "activated_datetime": "2025-11-11 15:38:47",
            "exchanger_identifier": null,
            "comment": "",
            "amount": "25000",
            "currency_code": "PYG",
            "wallet_type": "itau_ml",
            "stockpiling_id": 11844,
            "transaction_id": "0394031",
            "transaction_type": 0,
            "plugin_custom_order_id": "test_custom1234",
            "withdrawal_id": null,
            "withdrawal_status": null,
            "account_number": "",
            "account_name": "",
            "account_email": "",
            "bank_details": {
                "bank_code": "",
                "branch_code": ""
            }
        }
    ]
}
Warning

The Paykassma server is waiting for a response in json {"status": "ok"} response code 200, otherwise, when receiving a different response, Paykassma will forward the postback with a certain frequency.
Repeated postbacks must also be answered with {"status":"ok"} response code 200.

Withdrawals for users

For the general documentation on the withdrawals of funds click here.

Creating withdrawal

URL: https://api.{server_URL}/v2/withdrawal/create

Request method:

POST

Format:
JSON

Parameters:

Name

Type

Required

Description

withdrawal_idstringyes Withdrawal ID, if the parameter is not passed, then the system generates withdrawal_id.
payment_systemstring yesPayment system.
amount

int


required

Additional requirements:

  1. amount >= The value of the set minimum value;
  2. amount <= The value of the set maximum value.
currency_codestringyesCurrency code.

label

string

yes

The unique identifier (ID) of the user who makes the payment.

account_numberstring 

yes

The user's account number at Itau Bank (from 7 to 9 digits).

account_namestring

yes

Name and Surname of the account holder.

is_test

booleanyes

The is_test parameter possible values:

  • true - if Withdrawal is test;
  • false - if Withdrawal is real.
signaturestringyesSignature generated with private_key.


Code Block
themeDJango
titleRequest
{
    "withdrawal_id": "test1129245631874491",
    "payment_system": "itau_ml",
    "amount": 75000,
    "currency_code": "PYG",
    "label": "testlabel12345",
    "account_number": "220000000",
    "account_name": "Ashik Bik",
    "is_test": false,
    "signature": "dd323cc90163d306ad97bc327cf482417a7af276"
}


Code Block
languagephp
themeDJango
titleResponse Success
{
    "status": "ok",
}


Code Block
themeDJango
titleResponse Fail
{
    "status": "fail",
    "message": "MESSAGE"
}

*If, when trying to create a withdrawal request, the amount of account balances in the currency of the request is less than the total amount of new and still incomplete applications, the error message"Insufficient balance" will be displayed (to configure this functionality, contact the TS Paykassma).

Code Block
languagephp
themeDJango
titleResponse Fail (при недостаточном балансе)
{
    "status": "fail",
    "message": {
        "withdrawals_sum_amount": [
            "Insufficient balance"
        ]
    }
}

Example of a withdrawal postback for a Itau Paraguay Manual

Code Block
languagephp
themeDJango
collapsetrue
{
    "signature": "adfba698ad218ef2a081a5744ecfb7787faef13e",
    "wallet_type": "itau_ml",
    "amount": 75000,
    "currency_code": "PYG",
    "label": "testlabel12345",
    "direction": "outgoing",
    "created_datetime": "2025-11-11 16:08:21",
    "access_key": "uowkn0b3LfBxpcWYHi4_",
    "additional_data": [
        {
            "activated_datetime": "",
            "exchanger_identifier": "",
            "comment": "",
            "amount": "75000",
            "currency_code": "PYG",
            "wallet_type": "itau_ml",
            "stockpiling_id": null,
            "transaction_id": "",
            "transaction_type": null,
            "plugin_custom_order_id": "",
            "withdrawal_id": "test11129245631874491",
            "withdrawal_status": 1,
            "account_number": "220000000",
            "account_name": "Ashik Bik",
            "account_email": "",
            "bank_details": {
                "bank_code": null,
                "branch_code": null
            }
        }
    ]
}
Warning

The Paykassma server is waiting for a response in json {"status": "ok"} response code 200, otherwise, when receiving a different response, Paykassma will forward the postback with a certain frequency.
Repeated postbacks must also be answered with {"status":"ok"} response code 200.

Withdrawal statuses

ID

Name

Description

1

PROCESSED

Status for withdrawal when the withdrawal request has been successfully processed.

5

REJECTED

Status for withdrawal when the withdrawal request was rejected.

Creating withdrawal request in Paykassma

To create a withdrawal request, you need to go to the Withdrawals pagePayments  → Withdrawals and perform the following steps

  1. Press the button "Add withdrawal request".
    Image Modified

  2. Select payment system from list.



  3. Fill in the fields to create the request in the next window(the list of fields is standardized and not all fields are required. To create a request for a specific PS, you should fill in the required fields for this PS).
    Required fields for Itau Paraguay Manual withdrawal:
    - Label (user ID);
    - Amount;
    - Currency;
    - Wallet recipient;
    - Recipient name.


  4. After payment the withdrawal status will change.
    Image Modified
    Paykassma does not send postback for withdrawals created manually.