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>