This integration method is NOT recommended if you have not previously integrated similar payment solutions that require activation. Recommended integration method

When choosing integration via API, we recommend that you additionally make the following improvements:

1. Add hints in text form for each payment system (PS) to explain to a user all payment steps.
2. Add a visual explanation of the payment process - gifs showing the process and screenshots of the payment steps.
3. Screenshots and all the necessary minimum text information can be obtained directly from Paykassma TS.

https://api.{URL_сервераPaykassma_PaykassmaServer}/api/v1/payment/save-transaction-custom-id-systems/available

{
    "typestatus": "payment_hintfail",
            "text": null
          },
          true
            "message": "MESSAGE"
}

https://api.{URL_server_Paykassma}/wallet-type/images/

"status": "success",
    "message": "",
    "code": 20000,
    "data],
        "show_limits": true
      }
    ],
      "imps": {
        "INR": {
          "min"imps": "8000",
{
            "maxid": "560000"486,
        }
    "url":  },
"https://api.staging.client-paykassma.com/storage/guide-image/bkash.mp4"
       "bkash": { },
        "BDTpaytm": {
            "minid": "100"500,
            "maxurl": "1000000"
        }
https://api.staging.client-paykassma.com/storage/guide-image/Ghjkfre22.gif"
        },
        "upi": {
        "INR": {
          "minid": "20000"506,
            "maxurl": "50000https://api.staging.client-paykassma.com/storage/guide-image/upi_in.mp4"
        }
      },
      "paytm": {
        "INR": {
          "min": "100000",
          "max": "20000000"
        }
      },
      "phone_pe": {
        "INR": {
          "min": "100",
          "max": "800000"
        }
      }
    }
  }
}}
}

{
    "status": "fail"
    "message": "MESSAGE"
}

Attention! To get a complete list of available PSs, you need to contact Paykassma TS. TS will provide complete examples of requests for currently available PSs. They will also determine the correct request, depending on the selected PS.

https://api.{URL_Paykassma_Server}/api/v1/transaction/create/{wallet_type}

https://api.{URL_Paykassma_Server}/api/v1/transaction/create/paytm

https://api.{URL_сервераPaykassma_PaykassmaServer}/api/v1/transaction/create/paytm

{
    "currency_code": "INRUSD",
    "wallet_type": "paytm",
    "label": "eligendi55",
    "key1": "123-ABC-456-DEF"
    "custom_transaction_id": "123465477897"
}

https://api.{URL_Paykassma_Server}/api/v1/payment/create/{payment_system}

{
    "status": "ok"
}

{
    "success_urls": [
        {
            "order": 2,
            "url": "https://test.com/success2.jpg"
        },
        {
            "order": 1,
            "url": "https://test.com/success1.jpg"
        }
    ],
    "fail_urls": [
        {
            "order": 1,
            "url": "https://test.com/fail1.jpg"
        },
        {
            "order": 2,
            "url": "https://test.com/fail2.jpg"
        }
    ],
    "pending_urls": [
  
        {
            "order": 3,
            "url": "https://test.com/pending1.jpg"
        },
        {
            "order": 4,
            "url": "https://test.com/pending2.jpg"
        }
    ]
}

{
  "status": "ok",
  "urls": {
    "success_url": [
      {
        "order": 1,
        "url": "a93558ba9e4f04eef3b1f759ae4281305776559ce86ae2af5f6e6498d84b99be"
      },
      {
        "order": 2,
        "url": "7c51f9d6b35a80a8fcce9cf3f4f0ae56b818c2e375a8b3297cb3fafb41a921eb"
      }
    ],
    "fail_url": [

{
    '"status'": '"fail'"
    '"message'": '"MESSAGE'"
}

The hash lifetime is 1 day. After the expiration date resend the request to get hash for the address if necessary.

Attention: When transmitting data, there should be no spaces at the beginning and end

$data = [
    ...
];
 
$data['signature'] = generateSignature($data); // return fa0ee1e2acf7f898635ec417491381c0a4f9d35c
 
//send $data like json ...
 
function generateSignature(array $data) {
    $privateKey = 'yourprivatekey';
    ksort($data);
    $implode = self::multiImplode( ':', $data);
    return sha1($privateKey . md5($implode));
}
 
 
function multiImplode($glue, $array): string
    {
        $finArray = [];
    foreach ($array as $val) {
        $finArray[] = is_array($val) ? self::multiImplode($glue, $val) : $val;
    }
    return implode($glue, $finArray);
}

You can see the mandatory fields for PS in the "Integration" section.

{
    "withdrawal_id": "1234567",
    "payment_system": "paytm",
    "amount" : 1000,  
    "currency_code": "INR",
    "label": "55",     
    "is_test": false,     
    "comment: "withdrawal",       
    "account_number": "11111111", 
    "payments_details": {
        "payments_provider": "56",
        "payments_method": "MOBILE_MONEY"
    },
    "bank_details": {
        "bank_code": "MAHB0001821",
        "branch_code": "000254",
        "bank_code_in_payments_system": "9393"
    },     
    "signature":"fae51673a8a9c85f724317214bd0bcc665ebc799"
}

{
    "status": "ok"
}

{
    "status": "fail"
    "message": "MESSAGE"
}

{
    "status": "fail",
    "message": {
        "withdrawals_sum_amount": [
            "Insufficient balance"
        ]
    }
}

https://api.{URL_server_Paykassma}/api/v1/postback

   {
    "status": "ok",
    "postback": {
      "wallet_type": "paytm_api",
      "amount": 13629,
      "currency_code": "INR",
      "label":"6424468",
      "converted_amount": 
          {
           "USD":40.43,"INR":3327,"EUR":40.98,"IDR":625650.25,"MYR":190.71,"VND":988191.07,"SGD":57.43,
           "THB":1539,"NGN":17640.29,"TRY":751.48,"AED":148.51,"CAD":55.52,"AUD":64,"BDT":4276.41,"AFN":3531.25,
           "ALL":4807.24,"AMD":16333.46,"AOA":18109.34,"ARS":6179.09,"AWG":72.88,"AZN":68.73,"BAM":80.49,"BBD":80.86,
       "BGN":80.2,"BHD":15.24,"BIF":83303.64,"BMD":40.43,"BND":57.44,"BOB":279.23,"BRL":211.91,"BSD":40.43,"BTC":0.00209234 
           },
       "direction":"ingoing",
       "created_datetime":"2023-06-30 10:59:24",
       "additional_data": 
            [ 
             {
              "activated_datetime":"2023-06-30 13:59:24",
              "exchanger_identifier":"97489343",
              "comment":"",
              "amount":"13628.5",
              "currency_code":"INR",
              "wallet_type":"paytm_api",
              "stockpiling_id":262402,
              "transaction_id":"160028076535305",
              "transaction_type":0,
              "plugin_custom_order_id":"6424468",
              "withdrawal_id":null,
              "withdrawal_status":null,
              "account_number":"",
              "account_name":"",
              "account_email":"",
              "bank_details": 
                {
                     "bank_code":"",
                     "branch_code":"" 
                }
             } 
                {...}
            ]
     }
   }

{
    "status": "ok",
    "postback": {
      "wallet_type":"nagad_api",
      "amount":820,
      "currency_code":"BDT",
      "label":"autotest898404792700response_500",
      "converted_amount": 
        {
          "USD":7.56,"INR":620,"IDR":113212.08,"MYR":34.39,"VND":178667.64,"SGD":10,
          "THB":257.14,"NGN":5947.67,"TRY":203.5,"AED":27.75,"CAD":9.93,"AUD":11.07,"BDT":820,"AFN":647.27,
         
"ALL":681.27,"AMD":2946.58,"AOA":6231.79,"ARS":2025.9,"AWG":13.62,"AZN":12.84,"BAM":13.17,"BBD":15.11,
          "BGN":13.17,"BHD":2.85,"BIF":21376.13,"BMD":7.56,"BND":10.02,"BOB":52.24,"BRL":36.2,"BSD":7.56,"BTC":0.00025009
         },
      "direction":"outgoing",
      "created_datetime":"2023-07-20 08:09:01",
      "additional_data": 
       [
        {
          "activated_datetime":"",
          "exchanger_identifier":"",
          "comment":"autotest approve by file",
          "amount":"820",
          "currency_code":"BDT",
          "wallet_type":"nagad_api",
          "stockpiling_id":null,
          "transaction_id":"",
          "transaction_type":null,
          "plugin_custom_order_id":"",
          "withdrawal_id":"autotest984047927037",
          "withdrawal_status":1,
          "account_number":"5632221204",
          "account_name":"autotest983948600573",
          "account_email":"",
          "bank_details":
            {
               "bank_code":null,
               "branch_code":null
             }
        }
       ]
  }
}

{
    "status": "fail"
    "message": "MESSAGE"
}

https://api.{URL_server_Paykassma}/api/v1/accounts-balance?secret={{pluginapi.secret}}

{
    "status": "success",
    "message": "",
    "code": 20000,
    "data": {
        "balances": [
            {
                "wallet_type": "paytm",
                "currency_code": "IDR",
                "amount": -324324.00
            },
            {
                "wallet_type": "paytm",
                "currency_code": "USD",
                "amount": -10800.00
             },
            {
                "wallet_type": "bkash",
                "currency_code": "VND",
                "amount": 155.00
             },
            {
                "wallet_type": "bkash",
                "currency_code": "BRL",
                "amount": 187239.195
            },
            {
                "wallet_type": "bkash",
                "currency_code": "EUR",
                "amount": 23.9375
            },
            {
                "wallet_type": "nagad",
                "currency_code": "CUC",
                "amount": 471.00
             },
            {
                "wallet_type": "upi_ib",
                "currency_code": "SAR",
                "amount": 499.00
             }
                         ]
}

{
    "status": "error",
    "code": 30228,
    "errors": {
        "target": "secret",
        "code": 36205,
        "message": "Wrong secret"
    },
    "error_message": "Data validation error"
}

https://api.{URL_server_Paykassma}/api/v1/pullpostbacks?secret={{pluginapi.secret}}

{
    "status": "success",
    "message": "",
    "code": 20000,
    "data": {
        "transactions": [
            {
                "plugin_custom_order_id": "autotest51191116971521",
                "message": "Postback not found"
            },
            {
                "plugin_custom_order_id": "1923912939dd912ddpppdd99test",
                "postback": {
                    "wallet_type": "phone_pe",
                    "amount": 100,
                    "currency_code": "INR",
                    "label": "1293912939kkee13",
                    "converted_amount": {
                        "USD": 1.16,
                        "INR": 100,
                        "EUR": 1.06,
                        ...
                    },
                    "direction": "ingoing",
                    "created_datetime": "2025-03-19 12:49:49",
                    "additional_data": [
                        {
                            "activated_datetime": "2025-03-19 12:49:47",
                            "exchanger_identifier": "635*****8",
                            "comment": "95*****98",
                            "amount": "100",
                            "currency_code": "INR",
                            "wallet_type": "phone_pe",
                            "stockpiling_id": 2233,
                            "transaction_id": "3279********",
                            "transaction_type": 0,
                            "plugin_custom_order_id": "1923912939dd912ddpppdd99test",
                            "withdrawal_id": null,
                            "withdrawal_status": null,
                            "account_number": "",
                            "account_name": "",
                            "account_email": "",
                            "bank_details": {
                                "bank_code": "",
                                "branch_code": ""
                            }
                        }
                    ]
                }
            }
        ]
    },
    "paginate": {
        "offset": 0,
        "total": 2,
        "limit": 2
    }
}

{
    "status": "success",
    "message": "",
    "code": 20000,
    "data": {
        "withdrawals": [
			{
                "withdrawal_id": "ID_05613331ret",
                "message": "Withdrawal with this ID not found"
            },
            {
                "withdrawal_id": "ID_03213331asd",
                "postback": {
                    "wallet_type": "easypaisa_api",
                    "amount": 3000,
                    "currency_code": "PKR",
                    "label": "label",
                    "converted_amount": {
                        "USD": 10.72,
                        "INR": 926,
                        "EUR": 9.83,
                        ...
                    },
                    "direction": "outgoing",
                    "created_datetime": "2025-03-19 12:38:01",
                    "additional_data": [
                        {
                            "activated_datetime": "",
                            "exchanger_identifier": "",
                            "comment": "test",
                            "amount": "3000",
                            "currency_code": "PKR",
                            "wallet_type": "easypaisa_api",
                            "stockpiling_id": null,
                            "transaction_id": "",
                            "transaction_type": null,
                            "plugin_custom_order_id": "",
                            "withdrawal_id": "87be1f94-04ba-11f0-bf20-0243a4aa6442",
                            "withdrawal_status": 5,
                            "account_number": "03*********",
                            "account_name": "Muhammad",
                            "account_email": "",
                            "bank_details": {
                                "bank_code": null,
                                "branch_code": null
                            }
                        }
                    ]
                }
            }
        ]
    },
    "paginate": {
        "offset": 0,
        "total": 1,
        "limit": 1
    }
}

{
    "status": "fail",
    "message": {
        "plugin_custom_order_id": [
            "The plugin custom order id field is required when type is deposit."
        ]
    }
}