Contents

Custom digital wallets

 

Warning
The following content assumes you have obtained the necessary PCI certification to process and submit sensitive cardholder data in the request to our Webservices API.

If you are unsure, please contact our Support Team for assistance.

 

This page outlines the specification for custom digital wallet fields.

Info
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

Warning
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:


#!/usr/bin/python
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",
  "pan": "5100000000000511",
  "expirydate": "12/2020",
  "securitycode": "123"
}

strequest = securetrading.Request()
strequest.update(auth)
stresponse = st.process(strequest) #stresponse contains the transaction response
<?php

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

$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',
  'pan' => '5100000000000511',
  'expirydate' => '12/2020',
  'securitycode' => '123'
);

$api = \Securetrading\api($configData);
$response = $api->process($requestData);
var_dump($response->toArray());

?>
curl --user [email protected]:Password1^ https://webservices.securetrading.net/json/ -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",
  "pan": "5100000000000511",
  "expirydate": "12/2020",
  "securitycode": "123"
}]}'

 

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.