...
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. | 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 | |
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(2) | Y(2) | |
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 |
DoTransaction: Response Parameters
...
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 |
...
<soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/"> <Api>ONE_ZERO</Api> <Safekey>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</Safekey> <TransactionType>PAYMENT</TransactionType> <AuthenticationType>NA</AuthenticationType> <AdditionalInformation> <merchantReference>QA_Kyle</merchantReference> </AdditionalInformation> <Customer> <countryCode>27</countryCode> <merchantUserId>SOMETOKEN</merchantUserId> <email>clown@clown.com</email> <firstName>Joe</firstName> <lastName>Guy</lastName> <mobile>27887592452</mobile> <regionalId>5612124567897</regionalId> </Customer> <Basket> <amountInCents>1000</amountInCents> <currencyCode>ZAR</currencyCode> <description>LoadTest</description> </Basket> <Creditcard> <amountInCents>1000</amountInCents> <cardExpiry>122012</cardExpiry> <cardNumber>4111120000005078</cardNumber> <cvv>123</cvv> <nameOnCard>Joe the Guy</nameOnCard> </Creditcard> <Customfield> <key>someName</key> <value>JoeJoe</value> </Customfield> </soap:doTransaction> |
---|