a) Generating a payment link

Step 1: XML string

Here is the description of the chain you must build. You can copy and edit the example.

<P>

Parent element within the XML string scheme

<data id="1" display="true">
  <label>Size</label>
  <value>Large</value>
</data>

Example

					<?xml version="1.0" encoding="UTF-8"?>
<P>
  <business>
    <id_company>SNBX</id_company>
    <id_branch>01SNBXBRNCH</id_branch>
    <user>SNBXUSR01</user>
    <pwd>SECRETO</pwd>
  </business>
  <url>
    <reference>INVOICE999</reference>
    <amount>2500.00</amount>
    <moneda>MXN</moneda>
    <canal>W</canal>
    <omitir_notif_default>1</omitir_notif_default>
    <promociones>C,3,6,9</promociones>
    <st_correo>1</st_correo>
    <fh_vigencia>08/09/2020</fh_vigencia>
    <mail_cliente>nospam@gmail.com</mail_cliente>
    <datos_adicionales>
      <data id="1" display="true">
        <label>Size</label>
        <value>Large</value>
      </data>
      <data id="2" display="false">
        <label>Color</label>
        <value>Blue</value>
      </data>
    </datos_adicionales>
  </url>
</P>
					

Step 2: Encrypting the string

Once you have built the chain in clear, you can cypher it in AES-128, with the appropriate SDK to your server, which you can obtain in GitHUB.

The developer will receive the productive credentials of the merchant administrator.

Example

• Java
   
• PHP
  Versión 5 o superior
• C#
   
• Phyton
  2.7.10

								import AESCrypto
String originalString ="[USE THE CHAIN OF EXAMPLE ONE]";
String key = "5DCC67393750523CD165F17E1EFADD21";
String encryptedString = 
  AESCrypto.encrypt(originalString, key);

							

								<?php
include('/AESCrypto.php'); 
$originalString = '[USE THE CHAIN OF EXAMPLE ONE]';
$key = '5dcc67393750523cd165f17e1efadd21'; //128 bits key
$encryptedString = AESCrypto::encriptar($originalString, $key); 
?>
							

								using AESCrypto.cs
string originalString ="[USE THE CHAIN OF EXAMPLE ONE]";
string key = "5DCC67393750523CD165F17E1EFADD21";
string encryptedString =
  AESCrypto.encrypt(originalString, key);
string finalString = encryptedString.Replace("%", "%25").Replace(" ", "%20").Replace("+", "%2B").Replace("=", "%3D").Replace("/", "%2F");
							

								import AESCrypto.py
originalString ='[USE THE CHAIN OF EXAMPLE ONE]'
key = '5DCC67393750523CD165F17E1EFADD21'
encryptedString = AESCipher(key).encrypt(originalString)
							

Encrypt the example string from Step 1

Step 3: Link Generation Service

To guarantee the security in the transmission of information, Centro de Pagos has HTTPS servers which use the Transport Layer Security TLS protocol v1.2 as a secure transport protocol to carry out transactions. For its part, the merchant must also have TLS v1.2 servers, to ensure the secure exchange of information when making transactions.

https://wppsandbox.mit.com.mx/gen

This Sandbox endpoint receives the request with instructions from the merchant to record an intention to collect. In response to the request to the Link Generation Service, you will get an encrypted response string.

The implementation is based on sending to the service by POST a string in the xml parameter with the following structure:

xml=
<pgs>
  <data0>Fixed string assigned to merchant</data0>
  <data>Encrypted string in AES-128</data>
</pgs>

The developer will receive the productive credentials of the merchant administrator.

Example

• Java
  Unirest
• Java
  HttpsURLConnection
• PHP
  Version 5 or higher
• C#
   

								// This implementation uses http://unirest.io/java
String encodedString = 
  URLEncoder.encode("<pgs><data0>SNDBX123</data0><data>EBo2s....SBkZDVjWW</data></pgs>", "UTF-8");
HttpResponse<String> response = 
Unirest.post("https://wppsandbox.mit.com.mx/gen")
  .header("content-type", "application/x-www-form-urlencoded")
  .header("cache-control", "no-cache")
  .field("xml"  , encodedString,
"application/x-www-form-urlencoded")
  .asString();
							

								// This implementation uses HttpURLConnection
String encodedString = 
  URLEncoder.encode("<pgs><data0>SNDBX123</data0><data>EBo2s....SBkZDVjWW</data></pgs>", "UTF-8");
String postParam = "xml=" + encodedString;  
  URL obj = new URL(POST_URL);
  HttpURLConnection con = (HttpURLConnection) obj.openConnection();
    con.setRequestMethod("POST");
    con.setDoOutput(true);
	OutputStream os = con.getOutputStream();
	os.write(POST_PARAMS.getBytes());
	os.flush();
	os.close();
							

								<?php
$encodedString = urlencode('<pgs><data0>SNDBX123</data0><data>1OJAHMRu...IJiYtY5OnyQ==</data></pgs>');
$request = new HttpRequest();
$request->setUrl('https://wppsandbox.mit.com.mx/gen');
$request->setMethod(HTTP_METH_POST);

$request->setHeaders(array(
  'cache-control' => 'no-cache',
  'content-type' => 'application/x-www-form-urlencoded'
));

$request->setContentType('application/x-www-form-urlencoded');
$request->setPostFields(array(
  'xml' => encodedString
));

try {
  $response = $request->send();

  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}
							

								// This implementation uses http://restsharp.org v105
string encodedString = 
  HttpUtility.UrlEncode("<pgs><data0>SNDBX123</data0><data>[USE THE CHAIN OF EXAMPLE ONE]</data></pgs>");
string postParam = "xml=" + encodedString;
var client = new RestClient("https://wppsandbox.mit.com.mx/gen");
var request = new RestRequest(Method.POST);
request.AddHeader("cache-control", "no-cache");
request.AddHeader("content-type", "application/x-www-form-urlencoded");
request.AddQueryParameter(postParam, ParameterType.RequestBody);

IRestResponse response = client.Execute(request);
var content = response.Content;
							

Send the chain previously encrypted in Step 2 to the service

Step 4: Deciphering the response of the Generation Service

Once the service response is obtained, you can decrypt it with the appropriate SDK to your server, and within <nb_url> you will find the payment link or URL, that you must share with your client to receive your payment.

Example

• Java
   
• PHP
  Version 5 or higher
• C#
   

								import webPayPlus.AESCrypto
String originalString ="This is the text to be processed";
String key = "5dcc67393750523cd165f17e1efadd21";
String decryptedString = 
  AESCrypto.decrypt(originalString, key);
							

								<?php
include('/AESCrypto.php'); 
$originalString = 'This is the text to be processed';
$key = '5dcc67393750523cd165f17e1efadd21'; //Llave de 128 bits
$decryptedString = AESCrypto::desencriptar($originalString, $key);
?>
							

								using AESCrypto.cs
string originalString ="This is the text to be processed";
string key = "5DCC67393750523CD165F17E1EFADD21";
string decryptedString = 
  AESCrypto.decrypt(key, originalString);
							

Decipher response obtained from the service

Step 5: Payment link

From the decrypted answer, you get the payment link in the element nb_url . With the link you can invoke the payment form with GET in a web browser, Webview of an App, or embedding within the commerce portal in an iframe. Thus, you have the freedom to select the best that suits your technology. To find more visit Publish a payment link

Example

Invoke the link obtained in Step 3