Description

Adds a saved card to the account associated with the current API session. Returns a TokenId for use with Order::PlaceOrder.

Parameters

string CardNameThe name of the card holder, as it appears on the card.
int CardNumberThe 16 digit card number, without spaces.
string ExpiryMonthThe month that the card expires in a two digit format. For example '05' (May).
string ExpiryYearThe year that the card expires in a two digit format. For example '15' (2015).
int CV2The last 3-4 digits on the signature strip of the specified card. This must be provided for security reasons.
string TypeThe card type. Available options;

  • Visa > VISA

  • Visa Delta > DELTA

  • Visa Debit > DELTA

  • Visa Electron > UKE

  • MasterCard > MC

  • Solo > SOLO

  • Switch > SWITCH

  • UK Maestro > SWITCH

  • American Express > AMEX

string Address1The first line of the address that the card is registered to.
string CityThe name of the city for the address that the card is registered to.
string PostcodeThe postcode for the address that the card is registered to.
string CountryThe two letter ISO code for the country for the address that the card is registered to.
string StartMonth optionalThe month that the card expires in a two digit format. For example '08' (August). This field is required if the Type parameter has been set to SWITCH.
string StartYear optionalThe year that the card expires in a two digit format. For example '12' (2012). This field is required if the Type parameter has been set to SWITCH.
string IssueNumber optionalThe issue number of the card. This is only applicable if the Type parameter is set to SWITCH, however it is not a required parameter itself.

Request

<?xml version="1.0"?>
<NoveroRequest>
  <Request target="NoveroUser" name="AddCard" id="TestRequest">
    <CardName>Mr Test Testington</CardName>
    <CardNumber>4485663919957945</CardNumber>
    <ExpiryMonth>03</ExpiryMonth>
    <ExpiryYear>15</ExpiryYear>
    <CV2>123</CV2>
    <Type>VISA</Type>
    <Address1>1 The Road</Address1>
    <City>Testham</City>
    <Postcode>TE57 73ST</Postcode>
    <Country>GB</Country>
  </Request>
</NoveroRequest>
<?php
    require_once('TTNCApi.php');
    $Api = new TTNCApi('<username>', '<password>', '<VKey>');
    $Request = $Api->NewRequest('NoveroUser', 'AddCard', 'TestRequest');
    $Request->SetData('CardName', 'Mr Test Testington');
    $Request->SetData('CardNumber', '4485663919957945');
    $Request->SetData('ExpiryMonth', '03');
    $Request->SetData('ExpiryYear', '15');
    $Request->SetData('CV2', '123');
    $Request->SetData('Type', 'VISA');
    $Request->SetData('Address1', '1 The Road');
    $Request->SetData('City', 'Testham');
    $Request->SetData('Postcode', 'TE57 73ST');
    $Request->SetData('Country', 'GB');
    $Api->MakeRequests();
    $Response = $Api->GetResponseFromId('TestRequest');
?>
require TTNCApi
api = TTNCApi.new('<username>', '<password>', '<vkey>')
request = api.newrequest('NoveroUser', 'AddCard', 'TestRequest')
request.setdata('CardName', 'Mr Test Testington')
request.setdata('CardNumber', '4485663919957945')
request.setdata('ExpiryMonth', '03')
request.setdata('ExpiryYear', '15')
request.setdata('CV2', '123')
request.setdata('Type', 'VISA')
request.setdata('Address1', '1 The Road')
request.setdata('City', 'Testham')
request.setdata('Postcode', 'TE57 73ST')
request.setdata('Country', 'GB')
api.makerequest()
p request.getresponse()
api = TTNCApi('<username>', '<password>', '<vkey>')
request = api.newrequest('NoveroUser', 'AddCard', 'TestRequest')
request.setdata('CardName', 'Mr Test Testington')
request.setdata('CardNumber', '4485663919957945')
request.setdata('ExpiryMonth', '03')
request.setdata('ExpiryYear', '15')
request.setdata('CV2', '123')
request.setdata('Type', 'VISA')
request.setdata('Address1', '1 The Road')
request.setdata('City', 'Testham')
request.setdata('Postcode', 'TE57 73ST')
request.setdata('Country', 'GB')
api.makerequest()
p request.getresponse()using System;
using TTNCApi;
 
class Program
{
    static void Main(string[] args)
    {
        TTNCApi api = new TTNCApi("<username>", "<password>", "<vkey>");
        TTNCRequest request = api.NewRequest("NoveroUser", "AddCard", "TestRequest");
        request.setData("CardName", "Mr Test Testington");
        request.setData("CardNumber", "4485663919957945");
        request.setData("ExpiryMonth", "03");
        request.setData("ExpiryYear", "15");
        request.setData("CV2", "123");
        request.setData("Type", "VISA");
        request.setData("Address1", "1 The Road");
        request.setData("City", "Testham");
        request.setData("Postcode", "TE57 73ST");
        request.setData("Country", "GB");
        api.MakeRequests();
        TTNCParser dic = request.GetResponse();
     }
}
using System;
using TTNCApi;
 
class Program
{
    static void Main(string[] args)
    {
        TTNCApi api = new TTNCApi("<username>", "<password>", "<vkey>");
        TTNCRequest request = api.NewRequest("NoveroUser", "AddCard", "TestRequest");
        request.setData("CardName", "Mr Test Testington");
        request.setData("CardNumber", "4485663919957945");
        request.setData("ExpiryMonth", "03");
        request.setData("ExpiryYear", "15");
        request.setData("CV2", "123");
        request.setData("Type", "VISA");
        request.setData("Address1", "1 The Road");
        request.setData("City", "Testham");
        request.setData("Postcode", "TE57 73ST");
        request.setData("Country", "GB");
        api.MakeRequests();
        TTNCParser dic = request.GetResponse();
     }
}

Response

<?xml version="1.0"?>
<NoveroResponse>
  <Response target="NoveroUser" name="AddCard" Code="200" RequestId="TestRequest">
    <Token>
      <TokenId>15084</TokenId>
    </Token>
  </Response>
</NoveroResponse>