Child pages
  • getTransaction (RPP & 3DS API Redirects)
Skip to end of metadata
Go to start of metadata

getTransaction Request

In order to confirm transaction status a transaction lookup is provided by PayU. This transaction lookup is compulsory on any redirect integration and optional on API integration but still recommended to return full Secure 3D information where cards are not enrolled and no redirect happened.

getTransaction: Request Parameters

Parameter NameDescriptionDataTypeMandatory

Api

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

StringY
Safekey

PayU Merchant Identifier. Provided to merchant upon integration

StringY
AdditionalInformation/PayUReference

PayU unique reference number for transaction

StringSee note below *
AdditionalInformation/MerchantReferenceMerchantReference supplied for transactionStringSee note below *
*  - Either PayUReference or MerchantReference should be supplied for the call. If both are supplied the call will fail

getTransaction: SOAP request example

See getTransaction Request and Response SOAP API examples.

getTransactionResponse

The response will indicate the transaction state at the time of the request. Should the lookup be done while the transaction is still in progress appropriate responses needs to be interpreted and lookups should be repeated until transaction is in a final state.

getTransaction: Response Parameters

Parameter NameDescriptionData Type
basket/amountInCents

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

String
basket/currencyCode

International Currency code. Example: ZAR

String
basket/description

Basket description that was shown on PayU

String
customFields/key

Identification for custom field. E.g. Secure3D

String
customFields/value

Value for custom field. Multiple values can be included per key. Will be comma separated.

String

customFields/value/
lkpTransactionId 

Card enrollment lookup transaction ID issued by 3rd party authentication serverString

customFields/value/
lkpErrorNo

Card enrollment lookup error number if issued by 3rd party authentication server. "0" means successful message flow.String

customFields/value/
lkpErrorDescription

Card enrollment lookup error description iflkpErrorNo is not equal to "0".String

customFields/value/
lkpEnrolled

Card enrollment status, possible values "Y","N", "U"

  • "Y" = Card enrolled for Secure 3D and will be redirected for cardholder authentication.
  • "N" = Card not enrolled for Secure 3D and processing conditional as per merchant risk profile configured at the time of transaction.
  • "U" = Card enrollment status unknown. Processing conditional based on PASA guidelines and merchant risk profile configured at the time of transaction
String
customFields/value/
lkpEciFlag
Card enrollment lookup ECI value. Future use. Possible values that will be returned "1","2","5","6","7".String
customFields/value/
authSend
If transaction is subject to Secure 3D authentication and redirected to authentication server from PayU redirect pages. API integrations will have HTML redirect code returned in the doTransaction call and a value of "true" means that redirect code was provided but not an indication that redirect happened from the merchant checkout page.String
customFields/value/
authErrorNo
Cardholder authentication error number if issued by 3rd party authentication server. "0" means successful message flow.String
customFields/value/
authErrorDescription
Card authentication error description authErrorNo is not equal to "0".String
customFields/value/
authCavv
Card authentication CAVV value returned from 3rd party authentication server.String
customFields/value/
authXid 
Card authentication transaction ID issued by 3rd party authentication serverString
customFields/value/
authEciFlag 
Card authentication ECI value. Possible values that will be returned "1","2","5","6","7".String
customFields/value/
authPAResStatus 

Card authentication, possible values "Y", "N", "U", "A"

  • "Y" = Authentication successful. Transaction considered fully authenticated.
  • "N" = Authentication failed. Transaction will not be processed. Same as PIN failure on physical POS or ATM.
  • "U" = Authentication status unknown.
  • "A" = Authentication attempted.
String
* Please refer to Secure 3D guidelines for more information plus charge back risk profiles..
displayMessage

Customer friendly message to display in a browser to the customer

 String
merchantReferenceMerchant identifier for transaction.String
payUReferencePayU unique reference number for transactionString
paymentMethodsUsedSubfields can differ per payment method. To highlight Secure 3D credit card as payment method illustrated here.String
paymentMethodsUsed/amountInCentsTotal amount of the basket in cents. Format as 1000 for R10.00String
paymentMethodsUsed/cardExpiryIf Credit Card used, this will return card expiry date.String
paymentMethodsUsed/cardNumberIf Credit Card used, this will return a masked Credit Card numberString
paymentMethodsUsed/gatewayReferenceIf external gateway is used the gateway unique reference referenced here.String
paymentMethodsUsed/informationPayment method information (example: Loyalty program name), if credit card then the issuer schema. E.G. VISA, MasterCard, AMEX, Diners.String
paymentMethodsUsed/nameOnCardIf Credit Card used, this will return Card holder name of the cardString
resultCodeResult code returned by PayU for transactionString
resultMessageResult message relating to result code for transactionString
successfulBoolean value to determine if the message was successful or not. If the transaction failed the value will be "false" but a value of "true" does not indicate successful financial transaction. Refer to resultCode & resultMessage plus transactionState for transaction state. 
transactionState

The transaction state at the time of lookup.

  • NEW

  • PROCESSING

  • SUCCESSFUL

  • FAILED

String
transactionTypeThe type of transaction performed. 
  • RESERVE
  • RESERVE_CANCEL
  • FINALIZE
  • CREDIT
  • PAYMENT

String
PointOfFailureIndicated on failed transactions where the point of failure was, blank if successful transactionString

getTransaction: SOAP response example

See getTransaction Request and Response SOAP API examples.

 

E&OE

  • No labels