Page Comparison

Parameter Name

Description

Data type

Mandatory

Address1

Customer address line 1

AN : 1 – 30

N

Address2

Customer address line 2

AN : 1 – 30

N

AddressCity

Customer address city

A : 1 – 20

N

StateCode

Customer address state code

A : 2 – 2

N

CountryOfResidence

Customer Country Code - ISO-Alpha 3

A : 3 – 3

N

PostCode

Customer Post/Zip Code (remove '-' from field)

AN : 1 -9

N

IP

Source IP of customer - Format: nnn.nnn.nnn.nnn

A :  7 – 45

Y

Known

Previous Customer Flag - format Y or N

A : 1 – 1

N

CheckFraudOverride

Used to override the default merchant fraud setting. If set to true, no fraud check will be completed

A : 4 – 4

N

PcFingerPrint

See separate guide for full integration details

AN : 1 - 4000

N

MerchantWebSite

Merchant source website domain

AN : 1 – 60

Y

ShippingId

Shipping ID

AN: 1 - 16

N

ShppingFirstName

Shipping First Name

AN: 1 – 30

N

ShippingLastName

Shipping Last Name

AN: 1 – 30

N

ShippingEmail

Shipping Email Address - value must contain @

AN: 1 – 45

N

ShippingAddress1

Shipping address line 1

AN: 1 – 30

N

ShippingAddress2

Shipping address line 2

AN: 1 – 30

N

ShippingAddressCity

Shipping address city

A: 1 - 20

N

ShippingStateCode

Shipping address state code

A : 2 – 2

N

Shipping Country Code - ISO-Alpha 3

(http://en.wikipedia.org/wiki/ISO_3166-1_alpha-3)

ShippingPhone

Shipping Phone

N : 11 – 19

N

ShippingFax

Shipping Fax

N : 11 – 19

N

ShippingMethod

A : 1 - 1

N

RecipientFirstName

Recipient First Name

AN : 1 - 30

N

RecipientLastName

Recipient Last Name

AN : 1 – 30

N

RecipientEmail

Recipient email address

AN : 1 – 45

N

RecipientAddress1

Recipient Address Line 1

AN : 1 – 30

N

RecipientAddress2

Recipient Address Line 2

AN : 1 – 30

N

RecipientCity

Recipient City

A : 1 – 20

N

RecipientStateCode

Recipient State/Province Code

A : 2 - 2

N

RecipientCountryCode

Recipient Country Code - ISO 3 Digit Alpha

A : 3 – 3

N

RecipientPostalCode

Recipient Post/Zip code (remove '-' from field)

AN : 1 – 9

N

RecipientPhone

Recipient Phone Number

N : 9 – 19

N

ProductCode

Item Product Code

AN : 1 – 12

N

Sku

Item SKU

AN : 1 – 12

N

Description

Item description

AN : 1 – 26

N

Quantity

Item quantity

N : 1 – 8

N

CostAmount

Item cost amount - R5.00 should be sent as 500

N : 2 – 8

N

Amount

Total Item Amount (item qty x item cost amt), no decimal

N : 2 – 12

N

ShippingNumber

Item shiping/tracking number

AN : 1 – 19

N

GiftMessage

Item gift message

AN : 1 - 160

N

Parameter Name

Mandatory

Description

Values

GetTransactionResponse

Stage

Y

Allows the merchant to stage a transaction. Values: True / False

Boolean

MerchantReference

Y

Merchant identifier for transaction.

VarChar (64)

Successful

Y

Boolean value to determine if the transaction was successful or not.

Boolean

PointOfFailure

N

Indicated on failed transactions where the point of failure was

VarChar (64)

ResultCode

Y

Result code returned by PayU for transaction

Integer

ResultMessage

Y

Result message relating to result code for transaction

String

DisplayMessage

N

Customer friendly message to display in a browser to the customer

String

PayUReference

Y

PayU unique reference number for transaction

VarChar (64)

Basket

Description

Y

Basket description that will show on PayU

VarChar (64)

AmountInCents

Y

Total amount of the basket in cents. Format as 1000 for R10.00

Integer

CurrencyCode

Y

Currency code defined by PayU. Example: ZAR

String

PaymentMethodsUsed

Information

Y

Payment method information (example: Loyalty program name)

VarChar (64)

NameOnCard

N

Card holder name for a credit card

String

CardNumber

N

Masked Credit Card number

VarChar (64)

AmountInCents

Y

Amount in cents for payment method. Format as 1000 for R10.00

Integer

FraudIndex

N

If credit card is the payment method, this will be the fraud index returned from SafeShop.

Integer

Reference

N

Will be returned upon an EFT transaction request

VarChar (64)