Skip to content

Latest commit

 

History

History
140 lines (84 loc) · 5.99 KB

README.md

File metadata and controls

140 lines (84 loc) · 5.99 KB
Raw

TrueWallet Class

Unoffical TrueMoney Wallet API Class for PHP.

// Login with Credentials.
$tw = new TrueWallet($username, $password);
print_r($tw->RequestLoginOTP());
print_r($tw->SubmitLoginOTP($otp_code, $mobile_number, $otp_reference));
print_r($tw->access_token); // Access Token

// Login with Access Token.
$tw = new TrueWallet($access_token);
// Example Usage with Transaction History.
$transactions = $tw->getTransaction(50); // Fetch last 50 transactions. (within the last 30 days)
foreach ($transactions["data"]["activities"] as $report) {
	// Fetch transaction details.
	print_r($tw->GetTransactionReport($report["report_id"]));
}

Support Me?

If you like my project, consider donating me. Thank you! <3

[ Donate with Paypal or Donate with PromptPay ]

Paypal: [email protected]

PromptPay: 091-314-7533 (Thiranat Mahattanobon)

Installation

It is pretty simple to utilize this class, you just need to require it.

require_once("TrueWallet.class.php");

Initialization

Simple initialization with Login Credentials/Access Token.

$tw = new TrueWallet("[USERNAME]", "[PASSWORD]"); // Login Credentials
$tw = new TrueWallet("[ACCESS_TOKEN]"); // Access Token

Functions

function setCredentials ($username, $password, $type = null)

You can set Login Credentials with this function.

Email or Mobile Number can be used as Username. PIN can be used as Password as well.

function setAccessToken ($access_token)

You can set Access Token with this function.

function RequestLoginOTP ()

You can request for Login OTP with this function, Login Credentials are required.

function SubmitLoginOTP ($otp_code, $mobile_number = null, $otp_reference = null)

You can submit Login OTP with this function, $mobile_number and $otp_reference parameters are required.

function GetProfile ()

You can get your Profile information with this function.

function GetBalance ()

You can get your current wallet balance with this function.

function GetTransaction ($limit = 50, $start_date = null, $end_date = null)

You can fetch your transaction(s) with this function, $start_date and $end_date parameters are needed to be "Y-m-d" format.

function GetTransactionReport ($report_id)

You can fetch your transaction report with this function, $report_id parameter is required.

function TopupCashcard ($cashcard)

You can topup your wallet balance with this function, $cashcard parameter is required.

Useful Variables

These variables can be used if you need them.

  • (string) $this->response : Plain body Response from Curl execution.

  • (int) $this->http_code : HTTP Code from Curl execution.

  • (string) $this->access_token : You can take Access Token from this variable.

  • (array) $this->curl_options : Allow you to set extra Curl Options. (You can modify this variable.)

  • (int) $this->device_id : Allow you to change device_id parameter. (You can modify this variable.)

  • (int) $this->mobile_tracking : Allow you to change mobile_tracking parameter. (You can modify this variable.)

Note

  • CURLOPT_TIMEOUT can be set with $this->curl_options.
  • CURLOPT_SSL_VERIFYPEER can be turn off with $this->curl_options.
  • It is best to combine $this->http_code to check for the status of API.
  • $this->request() will automatically json_decode if possible.
  • $mobile_number and $otp_reference are not required to be fill if you use RequestLoginOTP() function before.
  • GetTransaction() function will fetch last 50 transactions within the last 30 days by default.

Licenses

TrueWallet Class is 100% free and open-source.

Creative Commons License
This work is licensed under a Creative Commons Attribution 4.0 International License.

Copyright 2018 Likecyber

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Special thanks to @Noxturnix for original gen-wallet-signature.py script.

https://gist.github.com/Noxturnix/2333671ffe093386b477c2edca323cbf