Load Money (Using Web View Component)

Load money using standard kit and WebView component.

Host:

Test: https://mob.paymentplug.com/
Live: https://wallet.paymentplug.com/

How to load money using standard kit?

The POST request will be send over HTTPS to thewalletServices/WalletStandardControllerendpoint.

NOTE:

Pass AuthToken in header for each request Auth API

Sample Request (URL Encoded)
                      
                        String params = "
                        merchantTransactionId="TD32434553454"
                        &amount="50.00"
                        ¤cy="USD"
                        &descriptor="TD32434553454"
                        &customerId="189405"
                        &walletOwnerId="1"
                        &verificationHash="8416e8c5cf8cecc7325d19c5b12015863d37f18f2ee9b669c975bf2db2be6125"
                        &transactionType="LOAD"
                        &mobilePlatform="android/iOS/web"
                        &paymentMode="CC"
                        &paymentBrand="VISA";
Sample Response
                      
                        {  
                          "status":"Success",
                          "amount":"50.00",
                          "statusdescription":"Transaction Successful"
                       }

NOTE:

  • merchantTransactionId – Provide Unique Id everytime
  • descriptor - same value of merchantTransactionId
  • customerContact – mobile number with country code
  • transactionType – LOAD
  • mobilePlatform – android/iOS
  • paymentMode – from above payment mode table
  • verificationHash - SHA256Algorithm.generateSHA256Hash(secKey.trim()+customerId.trim()+customerContact.trim()+walletOwnerId.trim())
How to generate verification hash?

Verification Hash has to be calculated with following combination using SHA256 algorithm and need to be send along with the authentication parameters in each server-to-server request: < secKey > < customerId > < customerContact > < walletOwnerId >

Sample Code

                    
                      import java.security.MessageDigest
                      def generatesha256Checksum( String text ) {
                      String values= text 
                      MessageDigest digest = Digest::SHA2.new(256).hexdigest
                      digest.update(values.bytes);
                      new BigInteger(1, digest.digest()).toString(16).padLeft(32, '0')
                      }
                    
                
                    
                      public static String generateMD5Checksum( String text )
                        {
                        String values= text; 
                        MessageDigest messageDigest = MessageDigest.getInstance(sha256);
                        String generatedCheckSum = getString(messageDigest.digest(values.getBytes()));
                        return generatedCheckSum;
                        }
                    
                
                    
                      var values= text; 
                      var md5 = require('crypto').createHash('sha256').update(values).digest(hex);
                    
                  
                    
                      function generateMD5Checksum( $text ) {
                        $values= $text;
                        $generatedCheckSum=hash('sha256', $values);
                        return $generatedCheckSum;
                        }
                    
                
                    
                      import hashlib
                      values= text; 
                      md5hash1 = hashlib.sha256(values.encode())
                    
                
                    
                      default
                    
                
                  
                    require 'digest/md5'
                    $values= text;
                    md5hash1 = Digest::MD5.hexdigest( values)
Example to call from WebView component
                  
                    webView.postUrl(URL, params.getBytes());
                    webView.getSettings().setJavaScriptEnabled(true);
                    webView.addJavascriptInterface(this,"android");

Request Parameters

This reference lists all the standard flow parameters to be send in request.

Parameter Description Format Required
merchantTransactionId This reference number is provided by the merchant, should be unique for the transactions and is visible on the end customer’s statement. .\\p[0-9a-zA-Z\\p{Space}\\-{0,1024} Yes
amount Amount of the transaction. N50
[0-9] {1,50}		 Yes
currency User's currency A3
[0-9]{3}		 Yes
descriptor Same value as merchantTransactionId .\\p[0-9a-zA-Z\\p{Space}\\-{0,1024} Yes
customerId Generated unique customer id on per user sign up. N
[0-9]		 Yes
walletOwnerId Provided by Paymentplug Unique id. N20
[0-9]		 Yes
verificationHash Verification Hash has collected combination of parameters. String Yes
transactionType Pass transaction type as LOAD/PURCHASE. A255 Yes
mobilePlatform Mobile device platform android/iOS. A255 Yes
paymentMode Payment method for paying amount. For ex: CC for Credit Cards AN32
[a-zA-Z0-9] {1,32}		 Yes
paymentBrand Type of Card while placing the transaction.For ex: VISA, MC AN32
[a-zA-Z0-9] {1,32}		 Yes

Response Parameters

This reference list lists all the standard flow parameters to be received in response.

Parameter Description Format Required
status Response status (SUCCESS/FAILED). A
[A-Z]		 Conditional
amount Amount of the transaction.. N
[0-9]		 Yes
statusDescription Transaction status description. A255 Conditional
List of response code from API
Status
Success
Failed
Pending
Declined