Description

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

Parameters

string CardName

The name of the card holder, as it appears on the card.

int CardNumber

The 16 digit card number, without spaces.

string ExpiryMonth

The month that the card expires in a two digit format. For example '05' (May).

string ExpiryYear

The year that the card expires in a two digit format. For example '15' (2015).

int CV2

The last 3-4 digits on the signature strip of the specified card. This must be provided for security reasons.

string Type

The 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 Address1

The first line of the address that the card is registered to.

string City

The name of the city for the address that the card is registered to.

string Postcode

The postcode for the address that the card is registered to.

string Country

The two letter ISO code for the country for the address that the card is registered to.

string StartMonth optional

The 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 optional

The 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 optional

The 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>