• Customer places order and wants to make payment via Alipay/WeChat pay.
• eCommerce Website calls any PayMeMate APIs (getHostedPage OR directPay) for payment of a dollar amount via Alipay or WeChat.
• PayMeMate identifies it as an Alipay or a WeChat payment request and calls ePayments.
• ePayments calls Alipay or WeChat with a request for a QR code associated with the merchant “eCommerce” for the requested dollar amount.
• Alipay or WeChat generate the QR Code/Page for that transaction (eCommerce & Amount) and pass it to ePayments.
• ePayments displays the QR Code on a payment page.
• Customer scans the QR Code with their Alipay or WeChat eWallet.
• Customer enters the payment password to authorise payment in their eWallet.
• Alipay or WeChat authorise payment and inform the Customer in their eWallet that payment has been successfully completed (or was unsuccessful).
• Alipay or WeChat informs ePayments payment was successful (or was unsuccessful).
• ePayments displays the payment was successful or unsuccessful on the ePayments payment page.
• ePayments informs PayMeMate that payment was successful (or was unsuccessful)
• PayMeMate informs eCommerce Website payment was successful (notification URL).
• eCommerce Website calls getTransactionDetail API (https://paymemate.com/api/v1/getTransactionDetail) which returns details associated with the transaction. (As good practice, in the record with the order store trade_status, Amount, payment_channels and trade_no as it will be helpful if ever an issue is found)
• eCommerce Website system looks for trade_status to be “TRADE_SUCCESS”(it means transaction was successful) and informs the customer the order is confirmed and successfully completed.

Example

When usemyfee is set to False :
{
notificationURL=http: //192.168.0.67: 8080/testPost,
paymemateMerchantID=d0t1l2m3s4c5i6v7p8e9y10k11m12l1388,
directContainerId=XZ3FGHLIEBO9, scheme=Alipay1
randomstr=1549447607058,
redirectionURL=http: //192.168.0.67: 8080/testGet,,
totalamount=0.01,
uniqueReference=test2,
usemyfee=false
}

When usemyfee set to True:
{
amount=0.01,
fee=0.01,
usemyfee=true,
notificationURL=http: //192.168.0.67: 8080/testPost,
paymemateMerchantID=d0t1l2m3s4c5i6v7p8e9y10k11m12l1388,
directContainerId=XZ3FGHLIEBO9, scheme=Alipay1
randomstr=1549449030819,
redirectionURL=http: //192.168.0.67: 8080/testGet,
totalamount=0.02,
uniqueReference=test4,
usemyfee=true
}

When usemyfee = false :
directContainerId=XZ3FGHLIEBO9&notificationURL=http://192.168.0.67:8080/testPost&paymemateMerchantID=d0t1l2m3s4c5i6v7p8e9y10k11m12l1388&randomstr=1549447607058&redirectionURL=http://192.168.0.67:8080/testGet&scheme=Alipay1&totalamount=0.01&uniqueReference=test2&usemyfee=false

When usemyfee = true :
amount=0.01&directContainerId=XZ3FGHLIEBO9&fee=0.01&notificationURL=http://192.168.0.67:8080/testPost&paymemateMerchantID=d0t1l2m3s4c5i6v7p8e9y10k11m12l1388&randomstr=1549449030819&redirectionURL=http://192.168.0.67:8080/testGet&scheme=Alipay&totalamount=0.02&uniqueReference=test4&usemyfee=true

When usemyfee = false :
directContainerId=XZ3FGHLIEBO9&notificationURL=http://192.168.0.67:8080/testPost&paymemateMerchantID=d0t1l2m3s4c5i6v7p8e9y10k11m12l1388&randomstr=1549447607058&redirectionURL=http://192.168.0.67:8080/testGet&scheme=Alipay1&totalamount=0.01&uniqueReference=test2&usemyfee=falseIMOQIXphUtehe0tE/R596ZTmzcGhPN6jnduYNSxCwjjIumurSWXusFEQ9VxutCpIYYYPWN+bfGquFUUo5Tl/e8rc2x+IhKl/GvZNgjkUqEU=

When usemyfee = true :
amount=0.01&directContainerId=XZ3FGHLIEBO9&fee=0.01&notificationURL=http://192.168.0.67:8080/testPost&paymemateMerchantID=d0t1l2m3s4c5i6v7p8e9y10k11m12l1388&randomstr=1549449030819&redirectionURL=http://192.168.0.67:8080/testGet&scheme=Alipay1&totalamount=0.02&uniqueReference=test4&usemyfee=trueIMOQIXphUtehe0tE/R596ZTmzcGhPN6jnduYNSxCwjjIumurSWXusFEQ9VxutCpIYYYPWN+bfGquFUUo5Tl/e8rc2x+IhKl/GvZNgjkUqEU=

When usemyfee = false :
60f53754a6712a3b5f22a85fef282073dfb472f8556d0219a8cb8f6ffe29cc2a769678743cdc57e5bcac9533818ca5061e5b1d37c589faa1c111571f2e2421a9

When usemyfee = true :
a425e195c6b49c72c228d0f705cd094fce25e8777034f41e8f3c95611ec919dbfd076d2bf87dcc0583fcbb05684e1ce0584021111b86e93ba198707ea80ff2a

When usemyfee = false :
{
directContainerId=XZ3FGHLIEBO9,notificationURL=http: //192.168.0.67: 8080/testPost,
uniqueReference=test2,
randomstr=1549447607058,
scheme=Alipay1, totalamount=0.01,
paymemateMerchantID=d0t1l2m3s4c5i6v7p8e9y10k11m12l1388,
usemyfee=false,
redirectionURL=http: //192.168.0.67: 8080/testGet,
signature=60f53754a6712a3b5f22a85fef282073dfb472f8556d0219a8cb8f6ffe29cc2a769678743cdc57e5bcac9533818ca5061e5b1d37c589faa1c111571f2e2421a9
}

When usemyfee = true :
{
directContainerId=XZ3FGHLIEBO9, notificationURL=http: //192.168.0.67: 8080/testPost,
amount=0.01,
uniqueReference=test4,
randomstr=1549449030819,
totalamount=0.02,
paymemateMerchantID=d0t1l2m3s4c5i6v7p8e9y10k11m12l1388,
redirectionURL=http: //192.168.0.67: 8080/testGet,
scheme=Alipay1, fee=0.01,
fee=0.01,
redirectionURL=http: //192.168.0.67: 8080/testGet,
signature=signature=a425e195c6b49c72c228d0f705cd094fce25e8777034f41e8f3c95611ec919dbfd076d2bf87dcc0583fcbb05684e1ce0584021111b86e93ba198707ea80ff2a
}

You would able to redirect to the desired payment gateway page for the payment.

At the PayMeMate Server, the Signature provided is validated before initiating the payment page.

NOTE: Do not add any keys with null or blank values while encrypting.
For example, If 'tokenid' value is blank or null. then that must not be included while encrypting.

Test Page

This API gives the current status of the transaction and any associated data it may have available at that point in time.

Example:- BASE URL/getTransactionDetail

In order to initiate and trigger this API, the Signature has to be generated first and then appended in the request before calling the /getTransactionDetail API.

Request Parameters:

Response :-

The Response will be same as the RESPONSE TABLE.

RESPONSE will be a JSON Object in String format.

Example:-

When usemyfee = false :
{
"amount": "0.01",
"merchantNotificationURL": "http://192.168.0.67:8080/testPost",
"paymemateGatewayName": "fusion-WECHAT",
"fee": "0.00",
"paymemateGatewayID": 14,
"createdOn": "2019-02-01 22:41:43.0",
"merchantUniqueReference": "merchant7",
"gatewayTransactionID": "4200000260201902015275392008",
"paymemateGatewayCompanyName": "ePayments",
"totalamount": "0.01",
"merchantRedirectionURL": "http://192.168.0.67:8080/testGet",
"paymemateMerchantID": "z0y1x2j3p4d5e6t7i8f9n10n11v12o1388",
"currency": "NZD",
"paymemateTransactionID": "Q4HYABRU8PIZ",
"status": "success"
}

When usemyfee = true :
{
"amount": "0.01",
"merchantNotificationURL": "http://192.168.0.67:8080/testPost",
"paymemateGatewayName": "fusion-WECHAT",
"fee": "0.01",
"paymemateGatewayID": 14,
"createdOn": "2019-02-06 23:36:38.0",
"merchantUniqueReference": "test4",
"gatewayTransactionID": "4200000260201902064786824382",
"paymemateGatewayCompanyName": "ePayments",
"totalamount": "0.02",
"merchantRedirectionURL": "http://192.168.0.67:8080/testGet",
"paymemateMerchantID": "d0t1l2m3s4c5i6v7p8e9y10k11m12l1388",
"currency": "NZD",
"paymemateTransactionID": "1YHV85KLM9SR",
"status": "success"
}

Response fields

Sample response (below) is sent to the Merchant on the Redirection / Notification URL:-

Example

When usemyfee = false :
{
"amount": "0.01",
"paymemateGatewayName": "fusion-WECHAT",
"fee": "0.00",
"paymemateGatewayID": 14,
"createdOn": "2020-05-13T13:55:51.000 0530",
"merchantUniqueReference": "test2",
"gatewayTransactionID": "4200000270201902060035529102",
"signature": "de372160377ed6c98a0...",
"paymemateGatewayCompanyName": "ePayments",
"totalamount": "0.01" ,
"paymemateMerchantID": "d0t1l2m3s4c5i6v7p8e9y10k11m12l1388",
"currency": "NZD",
"paymemateTransactionID": "DTFYR04WM5SO",
"status": "success"
}

When usemyfee = false :
{
"amount": "0.01" ,
"paymemateGatewayName": "fusion-WECHAT",
"fee": "0.01",
"paymemateGatewayID": 14,
"createdOn": "2020-05-13T13:55:51.000 0530",
"merchantUniqueReference": "test4",
"gatewayTransactionID": "4200000260201902064786824382",
"signature": "de372160377ed6c98a0...",
"paymemateGatewayCompanyName": "ePayments",
"totalamount": "0.02" ,
"paymemateMerchantID": "d0t1l2m3s4c5i6v7p8e9y10k11m12l1388",
"currency": "NZD",
"paymemateTransactionID": "1YHV85KLM9SR",
"status": "success"
}

If any error occurs after calling the /directPay Or /getTransactionDetail API then the system would show the status as false along with the appropriate error message in the response.The status of the transaction with the error details will also be sent to the given notification URL along with the unique reference set by the Merchant for that transaction.

The response will be in JSON to the given Notification URL in the following format:-

{“uniqueReference”:“”,“status”: “”,“msg”:“”}

Example - {“uniqueReference” : “test4”, “status” : “false”, “msg” : “Merchant not found with the given ID.”}

We have described the triggering event and the messages in a table below:

Triggering Event	status	Message
When the given parameters do not match with respect to: 1) Datatype: Example - If some Alphabets are passed in totalamount field. 2) Logical calculations: Example - If the total of given amount + fee does not match with totalamount	false	Validation Failed! Kindly refer the API document provided and check your requested Parameters.
When the client Signature does not match the PayMeMate created Signature.	false	Signature Verification Failed! Kindly refer to the API document provided and check your requested Parameters.
When the given Merchant ID is not found in PayMeMate.	false	Merchant not found with the given ID.
When the Merchant Account has been disabled.	false	Merchant Disabled. Contact PayMeMate Admin.
When the used Payment Gateway has been disabled.	false	This Payment Gateway has been disabled by the Merchant.
When the Payment Gateway being used has not been configured correctly by the Merchant.	false	This Payment Gateway has not been configured by the Merchant.
When system error occurs at PayMeMate server.	false	Something went Wrong! System exception.(Critical Error)
When the Token Id is left blank while creating a Merchant specific token.	false	TokenId cannot be blank!
When the Tokenise field is not Numeric.	false	Tokenise Field should be a Numeric Value!
When the given notificationURL or redirectionURL is not in a standard format.	false	MalFormedURL Exception
Signals that an I/O exception of some sort has occurred. This class is the general class of exceptions produced by failed or interrupted I/O operations.	false	IOException Exception
When the given Merchant Unique Reference is not unique. Note - Merchant has to send a new/unique “Merchant Unique Reference” every time.	false	Please check the Unique Reference, record already exists.

If any of the Limitations set by the merchants are violated, then the below listed limitation related error occurs:

Triggering Event	status	Message
When the maximum number of daily transaction limit for the specified Payment Gateway is reached.	false	Max No of Daily Transaction Limit reached for the Merchant.
When the transaction amount exceeds the allowed transaction limit set for the Payment Gateway.	false	Transaction exceeds the Max Transaction Size Limit set.
When the daily credit limit set for the Payment Gateway is reached.	false	Daily Credit Limit reached for the Merchant.
When the Monthly credit limit set for the Payment Gateway is reached.	false	Monthly Credit Limit reached for the Merchant.
When the Payment Gateway being used is disabled.	false	Admin has disabled Payment Gateway Name for this Merchant.

---

"PayMeMateUtils" is a Java library using which developers can easily create alphabetically ordered parameter String and can then pass it to generate the Signature to be used for PayMeMate platform.

We have mentioned the steps with Java sample code below:-

1. Include 'PayMeMateUtils.jar' in your Project Environment.
2. Use collection HashMap to collect all your parameters first.
3. Then pass your non-alphabetically ordered HashMap object to 'ArrangeAlphabetically' Class object for using in 'arrangeAlphabetically' method.
4. This takes two parameters:
   • i. Non-alphabetically ordered HashMap(paramMap) object and
   • ii. Your Merchant API ID(sign_key).

   In return you will get a parameterized String which is mentioned in the step 3 of PayMeMate API document. 'Steps to Initiate a Payment on PayMeMate' This parameterized String should be given to static method of GenerateSignature Class which will give you SHA512 Signature.

Code below:-

String signature = GenerateSignature.encryptThisString(new ArrangeAlphabetically().arrangeAlphabetically(paramMap, sign_key));

You can then send the Signature to /directPay API along with other required parameters. Alternatively, if you want to arrange the parameters alphabetically by your own, then you can do that as well. Then, you just need to use our Library to create the Signature.

Below is the code to create only the Signature

Send the Parameterized String to :-

String signature = GenerateSignature.encryptThisString( alphabeticallyOrderedParametrizedString);

---

You can DOWNLOAD java library :-

PayMeMateUtils.jar

---

Live testing
http://infidigisolutions.com/test_payment/send_data.php

Steps To Initiate a Payment:-

1. Create alphabetically parameterized String data like below:- notificationURL='.$_POST['notificationURL'].'&paymemateMerchantID='.$_POST['paymemateMerchantID'].' &paymentGatewayId='.$_POST['paymentGatewayId'].'&randomstr='.$_POST['randomstr'].'&redirectionURL ='.$_POST['redirectionURL'].'&totalamount='.$_POST['totalamount'].'&uniqueReference='.$_POST['uniqueR eference'].'&usemyfee=falseIMOQIXphUtehe0tE/R596ZTmzcGhPN6jnduYNSxCwjjIumurSWXusFEQ9VxutC pIYYYPWN+bfGquFUUo5Tl/e8rc2x+IhKl/GvZNgjkUqEU=
2. Make a signature of the above String Data using SHA 512 by using the code below:-

   hash('sha512','your parameterized string data');

---

Below is a code example of a sample form with data:-

The form is prefilled with the POST request data.

<h1>Readonly Form With Submitted Data ( Signature Generated )</h1><br> <form action="http://paymemateserver-env-1.isvbaiv2nt.us-east-1.elasticbeanstalk.com/directPay" method="post"> notificationURL<br> <input name="notificationURL" type="text" value="<?php echo $_POST['notificationURL']; ?>" readonly><br><br> paymentGatewayId<br> <input name="paymentGatewayId" type="text" value="<?php echo $_POST['paymentGatewayId']; ?>" readonly/><br><br> uniqueReference<br> <input name="uniqueReference" type="text" value="<?php echo $_POST['uniqueReference']; ?>" readonly/><br><br> randomstr<br> <input name="randomstr" type="text" value="<?php echo $_POST['randomstr']; ?>" readonly/><br><br> totalamount<br> <input name="totalamount" type="text" value="<?php echo $_POST['totalamount']; ?>" readonly/><br><br> paymemateMerchantID<br> <input name="paymemateMerchantID" type="text" value="<?php echo $_POST['paymemateMerchantID']; ?>" readonly/><br><br> usemyfee<br> <input name="usemyfee" type="text" value="false"/><br><br> redirectionURL<br> <input name="redirectionURL" type="text" value="<?php echo $_POST['redirectionURL']; ?>"/><br><br> signature<br> <input name="signature" type="text" value="<?php echo $hashed; ?>" readonly/> <br><input type="submit" value="Confirm and go to gateway"/> </form>

---

Description of the Code:-

Take data from the form and arrange them alphabetically and then create a String of the Parameters.

Below is the method to hash the parameterized String data to SHA512 encrypted signature. POST request data is pre filled in the form. Method used to hash is:- hash('sha512','your string');

$hashed=hash("sha512",'notificationURL='.$_POST['notificationURL'].'&paymemateMerchantID='.$_POST['paymem ateMerchantID'].'&paymentGatewayId='.$_POST['paymentGatewayId'].'&randomstr='.$_POST['randomstr'].'&redirecti onURL='.$_POST['redirectionURL'].'&totalamount='.$_POST['totalamount'].'&uniqueReference='.$_POST['uniqueRef erence'].'&usemyfee=falseIMOQIXphUtehe0tE/R596ZTmzcGhPN6jnduYNSxCwjjIumurSWXusFEQ9VxutCpIYYYPW N+bfGquFUUo5Tl/e8rc2x+IhKl/GvZNgjkUqEU=');

Once the hashing is done, it is stored in $hashed variable. You can use this hashed data in the Signature field in the sample form.

---

The PayMeMate Android SDK lets you seamlessly integrate Paymemate configured Payment Gateways with your Android app and start collecting payments from your customers.

The PayMeMate-SDK is a set of development tools used to develop application for Android platform.

The steps to configure this SDK are very easy and straight forward which allows developer to focus on the business logic developement instead of spending hours in integrating gateways.

Refer below documentation for integrating SDK in android application.

SDK module contains following

• Ready to test Sample apk file - paymemate_v1.0.apk
• Sample Code to integrate PayMeMate configured payment gateways
• Documentation which contains steps by step approach to integrate SDK in existing code
• An AAR file which contains a libraries used for integrating SDK.

You can download android SDK and related documents from following links

PayMeMate-SDK.pdf
PayMeMate_Code.zip
paymemate.aar
paymemate_v1.0.apk