Digital wallet


This page outlines the specification for digital wallet fields.

The fields described on this page are only supported by certain acquirers (and can only be processed with Mastercard transactions). For further information, please contact our Support team.


Before getting started, you will need to contact our Support team and request that the digital wallet functionality is enabled on your account. Then you can update your requests using the following specification.


Submitting digital wallet fields in a request

Failure to meet these requirements will result in an invalid field error being returned (30000).


The following is an example of a request where digital wallet fields are included:

import securetrading

stconfig = securetrading.Config()
stconfig.username = "[email protected]"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

auth = {
  "sitereference": "test_site12345",
  "requesttypedescriptions": ["AUTH"],
  "accounttypedescription": "ECOM",
  "currencyiso3a": "GBP",
  "baseamount": "1050",
  "orderreference": "My_Order_123",
  "walletid": "ABC",
  "walletsource": "OTHER",
  "cachetoken": "token_posted_by_st.js"

strequest = securetrading.Request()
stresponse = st.process(strequest) #stresponse contains the transaction response

if (!($autoload = realpath(__DIR__ . '/../../../autoload.php')) && !($autoload = realpath(__DIR__ . '/../vendor/autoload.php'))) {
  throw new Exception('Composer autoloader file could not be found.');

$configData = array(
  'username' => '[email protected]',
  'password' => 'Password1^',

$requestData = array(
  'sitereference' => 'test_site12345', 
  'requesttypedescriptions' => array('AUTH'),
  'accounttypedescription' => 'ECOM',
  'currencyiso3a' => 'GBP',
  'baseamount' => '1050',
  'orderreference' => 'My_Order_123',
  'wallet id' => 'ABC',
  'wallet source' => 'OTHER',
  'cachetoken' => 'token_posted_by_st.js'

$api = Securetradingapi($configData);
$response = $api->process($requestData);

curl --user [email protected]:Password1^ -H "Content-type: application/json" -H "Accept: application/json" -X POST -d '{
"alias":"[email protected]",
"version": "1.00",
"request": [{
  "currencyiso3a": "GBP",
  "requesttypedescriptions": ["AUTH"],
  "sitereference": "test_site12345",
  "baseamount": "1050",
  "orderreference": "My_Order_123",
  "accounttypedescription": "ECOM",
  "walletid": "ABC",
  "walletsource": "OTHER",
  "cachetoken": "token_posted_by_st.js"


Field specification

Field name Type Length Request Response Description
walletid Alphanumeric 3 Id of the wallet associated with the transaction.
walletsource  Alpha 5 This field identifies the wallet brand.

Must be submitted as “OTHER”.


Additional notes

Supported request types

The digital wallet fields can be submitted in the following requests:

Click here for a full list of request types.