Page Comparison

Anchor

	doctop
	doctop

Click on any of the following links to view a sample of the respective data structure examples of the following:

API requests:
- REQUEST - Credit Card request: PAYMENT or RESERVE
  This is the default API response for either a PAYMENT or RESERVE API call using credit cards as a payment method. Please make sure that you understand the difference between a PAYMENT and RESERVE api calls.
- REQUEST - Credit Card: PAYMENT or RESERVE (with Fraud enabled)
  PayU's Fraud service is an optional paid-for service. If integrating and signed up for fraud, please make sure to include the sections Basket.productLineItem, Basket.shippingDetails and Fraud
- REQUEST - Credit Card with Handshake
- REQUEST - Credit Card with Token (Save Card) - first request
- REQUEST - Credit Card with Token (Save Card) - subsequent request
API response:

- RESPONSE - Credit Card: PAYMENT or RESERVE
  This is the default API response for either a PAYMENT or RESERVE API call using credit cards.
- RESPONSE - Credit Card: PAYMENT or RESERVE (with bank reference)
  Merchant can request to have the the bank reference returned in the doTransaction API reponse (by default it is not returned) for credit card payments. If enabled it will send the bank reference in the customer field parameter.

...

Code Block

language	xml
title	Credit Card with Token (Save Card) Subsequent REQUEST:
linenumbers	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.api.controller.web.payjar.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">
         <Api>ONE_ZERO</Api>
         <Safekey>{86903CCB-79A9-42EE-0174-1ACE90185507}</Safekey>
         <TransactionType>PAYMENT</TransactionType>
         <AuthenticationType>TOKEN</AuthenticationType>
         <AdditionalInformation>
          <merchantReference>MerchRef001</merchantReference>
          <supportedPaymentMethods>CREDITCARD</supportedPaymentMethods>
         </AdditionalInformation>
         <Customer>
            <countryCode>27</countryCode>
            <merchantUserId>MechUser001</merchantUserId>
            <email>name.surname@mail.com</email>
            <firstName>Name</firstName>
            <lastName>Surname</lastName>
            <mobile>27887592452</mobile>
            <regionalId>2345679888</regionalId>
         </Customer>
         <Basket>
            <amountInCents>1000</amountInCents>
            <currencyCode>ZAR</currencyCode>
            <description>Goods</description>
          </Basket>       
          <Creditcard
            <pmId>DyZ7XBB5QxF5FEoIADAkMCQAUnlDEmIRVXNTa3xUYVUWfEUT</pmId>
            <amountInCents>1000</amountInCents>
            <cvv>123</cvv>
         </Creditcard>
      </soap:doTransaction>
   </soapenv:Body>
</soapenv:Envelope>

Anchor

	response_without_bank_ref
	response_without_bank_ref

Top

Code Block

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

   <soap:Body>

      <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">

         <return>

            <customFields>

               <key>bankReference</key>

               <value>DEMO12</value>

            </customFields>

            <displayMessage>Successful</displayMessage>

            <merchantReference>Munier</merchantReference>

            <payUReference>31976214819</payUReference>

            <paymentMethodsUsed xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

               <amountInCents>1000</amountInCents>

               <cardExpiry>122015</cardExpiry>

               <cardNumber>400000******1000</cardNumber>

               <gatewayReference>37149772</gatewayReference>

               <information>VISA</information>

               <nameOnCard>NonThree</nameOnCard>

            </paymentMethodsUsed>

            <resultCode>00</resultCode>

            <resultMessage>Successful</resultMessage>

            <successful>true</successful>

         </return>

      </ns2:doTransactionResponse>

   </soap:Body>

</soap:Envelope>

Anchor

	response_with_bank_ref
	response_with_bank_ref

Top

Code Block

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
         <return>
            <customFields>
               <key>bankReference</key>
               <value>DEMO12</value>
            </customFields>
            <displayMessage>Successful</displayMessage>
            <merchantReference>Munier</merchantReference>
            <payUReference>31976214819</payUReference>
            <paymentMethodsUsed xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <amountInCents>1000</amountInCents>
               <cardExpiry>122015</cardExpiry>
               <cardNumber>400000******1000</cardNumber>
               <gatewayReference>37149772</gatewayReference>
               <information>VISA</information>
               <nameOnCard>NonThree</nameOnCard>
            </paymentMethodsUsed>
            <resultCode>00</resultCode>
            <resultMessage>Successful</resultMessage>
            <successful>true</successful>
         </return>
      </ns2:doTransactionResponse>
   </soap:Body>
</soap:Envelope>

Versions Compared

Old Version 37

New Version 38

Key