Integration: doTransaction to include real-time recuring

Parameter Name

Description

Data type

DoTransactionRequest

Api

Version of the API. Current Version: 1.0

VarChar(4)

Safekey

PayU Merchant Identifier. Provided to merchant upon integration

Char(38)

TransactionType

The type of transaction being performed

RESERVE
RESERVE_CANCEL
PAYMENT
FINALIZE
CREDIT
RESERVE_RECURRING
RESERVE_RECURRING_CANCEL
PAYMENT_RECURRING
FINALIZE_RECURRING
CREDIT_RECURRING

String

AuthenticationType

The method of authentication used if a payment is being made that requires a user’s permission

NA

HANDSHAKE

TOKEN * (2^nd call and subsequent calls)

String

storePaymentMethod

Indicates if PayU must save this card and provide the merchant with a token to use for subsequent payments for the customer - True or False * (Only required for the first call, do not resend on subsequent calls for the customer)

Additional Information

MerchantReference

Unique merchant identifier for transaction

VarChar (64)

PayUReference

PayU unique reference number for transaction

VarChar(24)

DemoMode

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

Boolean

NotificationURL

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

String

Basket

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

VarChar(2)

Customer

FirstName

Customer first name

VarChar (64)

LastName

Customer last name

VarChar (64)

RegionalId

Regional identifier for customer such as RSA ID

String

Mobile

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

String

Email

Customer Email Address

VarChar (64)

MerchantUserId

*Unique Customer ID in merchant system (Required for Token payment)

VarChar (64)

DOB

Customer Date of Birth. Format 1970-07-30

VarChar (10)

Payment Methods – Credit Card (No handshake)

CardNumber

The credit card number that appears on the credit card

VarChar(24)

CardExpiry

The expiry month and year of the credit card. Format required: 042002 where the first two digits represents the month and the last four represents the year in the following format MMYYYY. For recurring transactions see here.

VarChar(6)

CVV

The credit card CVV number. Maximum length is 4 and the numbers must be positive integer. For recurring transactions see here.

VarChar(4)

NameOnCard

The full names that appears on the credit card, e.g. John Doe

VarChar(64)

BudgetPeriod

The budget term of payment. This indicates whether buyer wishes to pay once off, or spread the period of payment over several months. The period of payment starts at 0 (once off payment), 6 months, 12 months etc. Maximum 60 months

Integer

AmountInCents

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

Integer

Payment Methods – Credit Card (with handshake/token authentication)

pmID

The time-expired unique reference for the payment method of the user

VarChar (64)

CVV

The credit card CVV number. Maximum length is 4 and the numbers must be positive integer

VarChar(4)

AmountInCents

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

Integer

Payment Methods - EFT

BankName

Name of the bank the customer is paying into

VarChar (64)

Payment Methods - Loyalty

Information

Payment method name (example: Loyalty program name)

VarChar (64)

MembershipNumber

Membership number of a loyalty scheme

VarChar (64)

AmountInCents

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

Integer

Payment Methods – PayU Wallet (with handshake/token authentication)

pmID

The token obtained for the user from the LookupTransaction (PAYMENT_METHODS) call.

VarChar (64)

AmountInCents

The value of the transaction. Set to zero if you wish to only accept loyalty as payment

Integer

LoyaltyAmountInCents

The value of the transaction that may be paid for using loyalty

Integer

Custom Fields

Key

Identification for custom field

VarChar (64)

Value

Value for custom field

VarChar (64)

RESERVE

RESERVE_CANCEL

PAYMENT

FINALIZE

CREDIT

DoTransaction Request

Api

Y

Y

Y

Y

Y

Safekey

Y

Y

Y

Y

Y

TransactionType

Y

Y

Y

Y

Y

AuthenticationType

N⁽³⁾

N

N⁽³⁾

N

N

storePaymentMethod

N

N

N⁽⁴⁾

N

N

Additional Information

MerchantReference

Y

Y

Y

Y

Y

PayUReference

NA

Y

NA

Y

Y

DemoMode

N

NA

N

NA

NA

NotificationURL

N

N

N

N

N

Basket

Description

Y

NA

Y

NA

NA

AmountInCents

Y ⁽¹⁾

Y

Y⁽¹⁾

Y ^(1,2)

Y ^(1,2)

CurrencyCode

Y

Y

Y

Y

Y

Customer

FirstName

N

N

N

N

N

LastName

N

N

N

N

N

RegionalId

N

N

N

N

N

Mobile

N

N

N

N

N

Email

N

N

N

N

N

MerchantUserId

N

N

N⁽⁴⁾

N

N

DOB

N

N

N

N

N

Payment Methods – Loyalty

Information

NA

NA

NA

Y

NA

MermbershipNumber

NA

NA

NA

Y

NA

AmountInCents

NA

NA

NA

Y

NA

Payment Methods - Credit Card

CardNumber

Y

NA

Y

NA

NA

CardExpiry

Y

NA

Y

NA

NA

CVV

Y

NA

Y

NA

NA

NameOnCard

Y

NA

Y

NA

NA

BudgetPeriod

N

NA

N

NA

NA

AmountInCents

Y

Y

Y

Y

Y

Custom Fields

Key

N

N

N

N

N

Value

N

N

N

N

N

Y - Mandatory

N - Optional

NA - Not Allowed

(1) Basket Amount must equal sum of PaymentMethod Amount's

(2) Amount must equal to or less than the original transaction amount

(3) Field is required to be set to HANDSHAKE if payment is being made with PayU wallet or stored credit card

(4) Field is required when doing a transaction with a TOKEN or to generate a TOKEN