doTransaction (RPP)

Parameter Name

Description

Data type

Required field for request

DoTransactionRequest

RESERVE_CANCEL

FINALIZE

CREDIT

Api

Version of the API. Current Version: 1.0 (SOAP: ONE_ZERO)

VarChar(4)

Y

Y

Y

Safekey

PayU Merchant Identifier. Provided to merchant upon integration

Char(38)

Y

Y

Y

TransactionType

The type of transaction being performed.
RESERVE_CANCEL
FINALIZE
CREDIT
EFFECT_STAGING

String

Y

Y

Y

PayUReference

PayU unique reference number for transaction

Integer

Y

Y

Y

AdditionalInformation

MerchantReference

Merchant identifier for transaction.

VarChar (64)

Y

Y

Y

DemoMode

To determine if the API request should be handled as a demo transaction. Values: True/False FUTURE USE

Boolean

N/A

N/A

N/A

NotificationURL

URL where the merchant would like to be notified of transaction result via IPN (Instant Payment Notification). FUTURE USE

String

N

N

N

Customer

FirstName

Customer first name

VarChar (64)

N

N

N

LastName

Customer last name

VarChar (64)

N

N

N

RegionalId

Regional identifier for customer such as RSA ID

String

N

N

N

Mobile

Customer Mobile Number in international format without +( eg 27827891248)

String

N

N

N

Email

Customer Email Address

VarChar (64)

N

N

N

MerchUserId

Unique Customer ID in merchant system

VarChar (64)

N

N

N

Basket

Description

Basket description that will show on PayU

VarChar (64)

N/A

N/A

N/A

AmountInCents

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

Integer

Y

Y⁽²⁾

Y⁽²⁾

CurrencyCode

Currency code defined by PayU. Example: ZAR

VarChar(2)

Y

Y

Y

PaymentMethods – Credit Card

AmountInCents

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

Integer

Y

Y

Y

CustomFields

Key

Identification for custom field

VarChar (64)

N

N

N

Value

Value for custom field

VarChar (64)

N

N

N

Parameter Name

Description

Values

Stage

Allows the merchant to stage a transaction. Values: true / false

Boolean

MerchantReference

Merchant identifier for transaction.

VarChar (64)

Successful

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

Boolean

PointOfFailure

Indicated on failed transactions where the point of failure was

VarChar (64)

ResultCode

Result code returned by PayU for transaction

String

ResultMessage

Result message relating to result code for transaction

String

DisplayMessage

Customer friendly message to display in a browser to the customer

String

PayUReference

PayU unique reference number for transaction

VarChar (64)

Description

Basket description that will show on PayU

VarChar (64)

AmountInCents

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

Integer

CurrencyCode

Currency code defined by PayU. Example: ZAR

String

Information

Payment method information (example: Loyalty program name)

VarChar (64)

NameOnCard

If Credit Card used, this will return Card holder name of the card

String

CardNumber

If Credit Card used, this will return a masked Credit Card number

VarChar (64)

AmountInCents

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

Integer

FraudIndex

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

Integer