Topup Request

A code sample of TopupRequest can be seen below.

PosClientService _posClientService = new PosTcpClientService(ipAddress: "127.0.0.1", port: 5002);

//Optional: TransactionConfig can also be set via configuration files, see "Configuration files" documentation for more information.
_posClientService.TransactionConfig = new Credential
{
    CustomerCode = "ABF",
    Site = "PXP000000001",
    Workstation = "001",
    Merchant = "1234567890",
    Username = "PXPUser",
    Password = "Testing",
    Culture = "en"
};

//Optional: PedConfig can also be set via configuration files, see "Configuration files" documentation for more information.
_posClientService.PedConfig = new PedEndpointAddress
{
    EndpointAddressType = PedEndpointAddressType.Serial,
    SerialEndpointAddress = new SerialEndpointAddress
    {
        ComPort = "com9"
    }
};

var topUpRequest = new TopUpRequest() {
	Workstation = "001",
	Currency = "GBP",
	Amount = 10.50M,
	TransactionReference = "Topup",
	OriginalTransactionReference = "OriginalPreAuthorization",
	TokenisedCardNumber = "9920000000000120010",
};

var topupResponse = await _posClientService.ProcessAsync(topupRequest);

Console.WriteLine(topupResponse.ResponseCode);
Console.WriteLine(topupResponse.ResponseMessage);
Console.WriteLine(topupResponse.FaultResponseCode);
Console.WriteLine(topupResponse.CaptureMethod);
Console.WriteLine(topupResponse.AuthorityCode);
Console.WriteLine(topupResponse.AuthorityMethod);
Console.WriteLine(topupResponse.OriginalTransactionReference);
Console.WriteLine(topupResponse.TransactionReference);
Console.WriteLine(topupResponse.PEDSerialNumber);
Console.WriteLine(topupResponse.Token);
Console.WriteLine(topupResponse.ReceiptXML);

The following tables contain TopupRequest objects and their detailed definitions. The field definitions are divided into request fields and response fields.

TopupRequest

Field Name Type (C#) Mandatory Description
Workstation string Yes This is the workstation number, a unique workstation ID allocated to a workstation when the service is set up
Currency string Yes This is the currency of the transaction. This is the currency code. A three character code in accordance with ISO 4217
Amount decimal Yes This is the monetary value of the transaction in minor units
TransactionReference string Yes This is the merchant's own unique reference for the request
OriginalTransactionReference  string Yes This is the original reference of the preauthorisation transaction that top up amount will be added up to
TokenisedCardNumber string Yes This is the tokenised card number returned from PXP from a previous transaction

 TopupResponse

Field Name Type (C#) Mandatory Description
ResponseCode string Yes This is the response code indicating the result of the processing operation
ResponseMessage  string Yes This is the human readable message from either the acquirer or the ANYpay service that describes the Response Code
FaultResponseCode  int Yes This is the code indicating the reason when the response code is an "Error"
CaptureMethod Enum Yes The card data capture method
AuthorityCode string  Yes This is the authorization code provided by the acquirer, card issuer or ANYpay
AuthorityMethod Enum  Yes This is the method used to authorize the transaction
OriginalTransactionReference string Yes This is the original reference of the preauthorisation transaction that top up amount will be added up to
TransactionReference string Yes This is the merchant's own unique reference for the request
PEDSerialNumber string Yes This is the serial number of the Pin Entry Device
Token  string  Yes This is the token generated by ANYpay to uniquely identify a transaction
ReceiptXML string Yes This is an XML receipt which complies EMV receipt requirement. This following page lists objects and their detailed definitions of each XML parameter.