Encrypt Parameters

The Encrypt Parameters request accepts Hosted Checkout or Hosted Payment Page parameters and encrypts them into a single string.

Endpoint

https://ws.bluesnap.com/services/2/tools/param-encryption

Usage

You can include the returned encrypted string in the URL for your Hosted Checkout and Hosted Payment pages as the value of the enc query string parameter. For example:

https://checkout.bluesnap.com/buynow/checkout?storeId=1022&enc=TROfAP5AKDEtqWYHV7JSpIWO6mwWW71tswnrVH%2BT%3D%3D

❗️

Important

storeId is mandatory when you send the encrypted string.

Request Content

param-encryption container    required, contains the following property(see param-encryption):

  • parameters string    required (see parameters)

Response Details

If successful, the response HTTP status code is 200 OK. The encrypted string is returned within the encrypted-token property.

Examples

Request Examples

curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/param-encryption \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<param-encryption xmlns="http://ws.plimus.com">
  <parameters>
    <parameter>
      <param-key>sku2125148</param-key>
      <param-value>1</param-value>
    </parameter>
    <parameter>
      <param-key>currency</param-key>
      <param-value>USD</param-value>
    </parameter>
    <parameter>
      <param-key>language</param-key>
      <param-value>ENGLISH</param-value>
    </parameter>
  </parameters>
</param-encryption>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/param-encryption \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<param-encryption xmlns="http://ws.plimus.com">
  <parameters>
    <parameter>
      <param-key>shopperId</param-key>
      <param-value>19505364</param-value>
    </parameter>
    <parameter>
      <param-key>expirationInMinutes</param-key>
      <param-value>300</param-value>
    </parameter>
    <parameter>
      <param-key>pageName</param-key>
      <param-value>AUTO_LOGIN_PAGE</param-value>
    </parameter>
  </parameters>
</param-encryption>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/param-encryption \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<?xml version="1.0" encoding="UTF-8"?>
<param-encryption xmlns="http://ws.plimus.com">
  <parameters>
    <parameter>
      <param-key>thankyou.backtosellerurl</param-key>
      <param-value>https%3A%2F%2Fmywebsite.com%2Fmypage%3Finv%3D!%7Binvoice.id%7D</param-value>
    </parameter>
  </parameters>
</param-encryption>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/param-encryption \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<param-encryption xmlns="http://ws.plimus.com">
  <parameters>
    <parameter>
      <param-key>sku2129472priceamount</param-key>
      <param-value>15</param-value>
    </parameter>
    <parameter>
      <param-key>sku2129472pricecurrency</param-key>
      <param-value>GBP</param-value>
    </parameter>
    <parameter>
      <param-key>sku2129472recurringpriceamount</param-key>
      <param-value>20</param-value>
    </parameter>
    <parameter>
      <param-key>sku2129472recurringpricecurrency</param-key>
      <param-value>GBP</param-value>
    </parameter>
  </parameters>
</param-encryption>'
curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/param-encryption \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<param-encryption xmlns="http://ws.plimus.com">
  <parameters>
    <parameter>
      <param-key>subscriptionId</param-key>
      <param-value>39469016</param-value>
    </parameter>
    <parameter>
      <param-key>expirationInMinutes</param-key>
      <param-value>300</param-value>
    </parameter>
    <parameter>
      <param-key>pageName</param-key>
      <param-value>PLAN_CHANGE_PAGE</param-value>
    </parameter>
    <parameter>
      <param-key>sku2169034</param-key>
      <param-value>1</param-value>
    </parameter>
  </parameters>
</param-encryption>'

Response Examples

HTTP/ 1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<param-encryption xmlns="http://ws.plimus.com">
  <encrypted-token>XC9VdW0NVMnb%2FZdF1xccFwMulRrHqC2gurtDIrxRhHUFUqZAXA6Flwv3iR84oSVf</encrypted-token>
</param-encryption>
HTTP/ 1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<param-encryption xmlns="http://ws.plimus.com">
  <encrypted-token>oDSauzLnClwx9Tq%2FtG2NN%2B5bAz87h74KopMiLRTcwiLGth3W5X1GQxtoOcaf521xfGRa2HLxglEwAhE37eesar0vw8az6A0Mk3jchpevQ%2Bstt0F32MuL59LwVT6QzD1n</encrypted-token>
</param-encryption>
HTTP/ 1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<param-encryption xmlns="http://ws.plimus.com">
  <encrypted-token>vzog4BXQAg9UwYR91UpewQj7QREmV7T1iS6fj%2FlhAnab2zz1mUlnbpLJm6wpityBcDNpYIQfXFYpxyLGL4HKn%2F%2FhU0rafW2Hw2HVPAymDiinZ4MwcrePbJdfAgk6KsIcpoZA4YaMTuvi5gPu1LCDBw%3D%3D</encrypted-token>
</param-encryption>
HTTP/ 1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<param-encryption xmlns="http://ws.plimus.com">
  <encrypted-token>MrSwQVuGAwZTkT4QUfzoKP3Uq7fPc97U%2F0F%2FeHmSAZGXizA1%2BXJwa8u%2FDkCHpvcFrAgZW9dysuPc89Z8Fqe2R3h9Nw%2F1a5SsVjKeNJvYrbRvHec0xIpXzdQxpo63S4hcsGExVXfJHMrJDvTgZ5RCmkeqF%2FEHYN2uggHkREUi5Eg%3D</encrypted-token>
</param-encryption>
HTTP/ 1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<param-encryption xmlns="http://ws.plimus.com">
  <encrypted-token>XoDNW%2By%2BjDYrjF8KfAL3GpgNTTVmeB62tQPcYLPtNllgidXwaUooyOTFQU4KM6%2BpQmw4F7RmB9h52sFpsHr34cEWiw%2Bv8ykXEV29h5J65x5sqbO2fioL%2B6lRt%2BoBPK7t4Gc3c4UZBYRJoDVz9EwGqg%3D%3D</encrypted-token>
</param-encryption>