Page Comparison

Anchor

	doctop
	doctop

Click on the following links to view data structure examples of the following:The following are examples of how you would need to set out your data when querying PayU's API with SOAP.

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 HandshakeeBucks: PAYMENT
- REQUEST - Credit Card with Token (Save Card) - first requestHandshake
- REQUEST - Credit Card with Token (Save Card) - subsequent request
  ssCrediting a transaction
API response:

...

Top

...

- 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 3D Secure enabled - card enrolled)
  This is the default API response for either a PAYMENT or RESERVE API call using credit cards, but the store is 3D enabled.
- 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.

...

- RESPONSE - Credit Card: PAYMENT or RESERVE

...

- (with Fraud enabled - APPROVE)
  This is the default API response for either a PAYMENT or RESERVE API call using credit cards, where Fraud is enabled and an APPROVE response was recieved from the Fraud service provider.
- RESPONSE - Credit Card: PAYMENT or RESERVE (with Fraud enabled - CHALLENGE)
  This is the default API response for either a PAYMENT or RESERVE API call using credit cards, where Fraud is enabled and a CHALLENGE response was recieved from the Fraud service provider.
- RESPONSE - Credit Card: PAYMENT or RESERVE (with Fraud enabled - DENY)
  This is the default API response for either a PAYMENT or RESERVE API call using credit cards, where Fraud is enabled and a DENY response was recieved from the Fraud service provider.
- RESPONSE - eBucks: PAYMENT
  This is the default API response for either a PAYMENT or RESERVE API call using eBucks
- response_EFTPro_payment
  This is the default API response for EFT Pro payment

Anchor

	example_without_fraud
	example_without_fraud

Top

Code Block

language	xml
title	REQUEST - Credit Card request: PAYMENT or RESERVE
linenumbers	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.api.controller.web.payjar.com/" xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="SOAP-ENV">
   <soapenv:Header>
      <wsse:Security SOAP-ENV:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
         <wsse:UsernameToken wsu:Id="UsernameToken-9" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
            <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username>
            <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes here~~~</wsse:Password>
         </wsse:UsernameToken>
      </wsse:Security>
   </soapenv:Header>
   <soapenv:Body>
      <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">
         <Api>ONE_ZERO</Api>
         <Safekey>~~~SAFEKEY goes here ~~~</Safekey>
         <TransactionType>~~~a value of PAYMENT or RESERVE~~~</TransactionType>
         <AdditionalInformation>
            <merchantReference>~~~Merchant ref goes here~~~</merchantReference>
            <notificationUrl>http://example.com/notification-page/</notificationUrl>
         </AdditionalInformation>
         <Customer>
            <countryCode>27</countryCode>
            <countryOfResidence>ZAR</countryOfResidence>
            <merchantUserId>0123465798</merchantUserId>
            <email>john.doe@example.com</email>
            <firstName>John</firstName>
            <lastName>Doe</lastName>
            <mobile>0827777777</mobile>
            <regionalId>5612124567897</regionalId>
            <ip>127.0.0.1</ip>
         </Customer>
         <Basket>
            <amountInCents>12000</amountInCents>
            <currencyCode>ZAR</currencyCode>
            <description>Fraud Basket</description>
         </Basket>
         <Creditcard>
            <amountInCents>12000</amountInCents>
            <cardExpiry>122014</cardExpiry>
            <cardNumber>4111120000005078</cardNumber>
            <cvv>123</cvv>
            <nameOnCard>Fred Fraud</nameOnCard>
         </Creditcard>
      </soap:doTransaction>
   </soapenv:Body>
</soapenv:Envelope>

Anchor

	fraud
	fraud

Top

Code Block

language	xml
title	REQUEST - Credit Card: PAYMENT or RESERVE (with Fraud enabled)
linenumbers	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.api.controller.web.payjar.com/" xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Header>
    <wsse:Security SOAP-ENV:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
        <wsse:UsernameToken wsu:Id="UsernameToken-9" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
        <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username>
        <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes
            here~~~</wsse:Password>
        </wsse:UsernameToken>
    </wsse:Security>
    </soapenv:Header>
    <soapenv:Body>
    <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">
        <Api>ONE_ZERO</Api>
        <Safekey>~~~SAFEKEY goes here ~~~</Safekey>
        <TransactionType>~~~a value of PAYMENT or RESERVE~~~</TransactionType>
        <AdditionalInformation>
          <deviceId>TERM003</deviceId>
          <merchantReference>~~~Merchant ref goes here ~~~</merchantReference>
          <notificationUrl> http://example.com/notification-page/</notificationUrl>
        </AdditionalInformation>
        <Customer>
          <countryCode>27</countryCode>
          <countryOfResidence>ZAR</countryOfResidence>
          <merchantUserId>0123465798</merchantUserId>
          <email>john.doe@example.com</email>
          <firstName>John</firstName>
          <lastName> Doe </lastName>
          <mobile>0827777777</mobile>
          <regionalId>5612124567897</regionalId>
          <ip>127.0.0.1</ip>
        </Customer>
        <Basket>
          <amountInCents>12000</amountInCents>
          <currencyCode>ZAR</currencyCode>
          <description>Fraud Basket</description>
          <!--Zero or more repetitions:-->
          <productLineItem>
              <amount>10000</amount>
              <costAmount>1000</costAmount>
              <description>Product 1</description>
              <giftMessage>Happy Birthday</giftMessage>
              <productCode>ABC0002</productCode>
              <quantity>1</quantity>
              <recipientAddress1>21 Example Road</recipientAddress1>
              <recipientCity>Cape Town</recipientCity>
              <recipientCountryCode>ZAR</recipientCountryCode>
              <recipientPostalCode>8000</recipientPostalCode>
              <recipientFirstName>John</recipientFirstName>
              <recipientLastName>Doe</recipientLastName>
          </productLineItem>
          <shippingDetails>
              <shippingAddress1>21 Example Road</shippingAddress1>
              <shippingAddressCity>Cape Town </shippingAddressCity>
              <shippingEmail> john.doe@example.com </shippingEmail>
              <shippingCountryCode>ZAR</shippingCountryCode>
              <shippingStateCode>WC</shippingStateCode>
              <shippingMethod>P</shippingMethod>
              <shppingFirstName>John</shppingFirstName>
              <shippingLastName>Doe</shippingLastName>
              <shippingFax>27214688020</shippingFax>shippingFax>
              <shippingPhone>27214688021</shippingPhone>
          </shippingDetails>
        </Basket>
        <Fraud>
          <checkFraudOverride>false</checkFraudOverride>
          <merchantWebSite>http://www.example.com/ </merchantWebSite>
          <pcFingerPrint>owhjiflkwhefqwoaef</pcFingerPrint>
        </Fraud>
        <Creditcard>
          <amountInCents>12000</amountInCents>
          <cardExpiry>122014</cardExpiry>
          <cardNumber>4111120000005078</cardNumber>
          <cvv>123</cvv>
          <nameOnCard>Fred Fraud</nameOnCard>
          <verified/>
        </Creditcard>
    </soap:doTransaction>
    </soapenv:Body>
</soapenv:Envelope>

Anchor

	with_handshake
	with_handshake

Top

Code Block

language	xml
title	REQUEST - Credit Card with Handshake
linenumbers	true

<DoTransaction Api=â€�1.0â€� Safekey=â€�{86903CCB-79A9-42EE-8637-1ACE90185507}â€� TransactionType=â€�PAYMENTâ€� AuthenticationType=â€�HANDSHAKEâ€�>
    <AdditionalInformation>
        <merchantReference>CJR001</merchantReference>
    </AdditionalInformation>
    <Customer>
        <mobile>27827891249</mobile>
    </Customer>
    <Basket>
        <amountInCents>1000</amountInCents>
        <currencyCode>ZAR</currencyCode>
        <description>ORD111</description>
    </Basket>
    <PaymentMethods>
        <CreditCard pmID="jh23d29832jhdo23hu" CVV=â€�123â€� AmountInCents="2300" />
    </PaymentMethods>
</DoTransaction>

Anchor

	save_card_1
	save_card_1

Top

Code Block

language	xml
title	REQUEST - eBucks (PAYMENT)
linenumbers	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.api.controller.web.payjar.com/" xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="SOAP-ENV">
      <soapenv:Body>
      <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">
         <Api>ONE_ZERO</Api>
         <Safekey>{00000000-0000-0000-0000-000000000000}</Safekey>
         <TransactionType>PAYMENT/RESERVE</TransactionType>
         <AdditionalInformation>
            <merchantReference>1234567890</merchantReference>           
         </AdditionalInformation>
         <Customer>
            <countryCode>27</countryCode>
            <countryOfResidence>ZAR</countryOfResidence>
            <merchantUserId>0123465798</merchantUserId>
            <email>john.doe@example.com</email>
            <firstName>John</firstName>
            <lastName>Doe</lastName>
            <mobile>0827777777</mobile>
            <regionalId>5612124567897</regionalId>
         </Customer>
         <Basket>
            <amountInCents>12000</amountInCents> <!-- amount in zar cents -->
            <currencyCode>ZAR</currencyCode>
         </Basket>
         <Ebucks>
            <amountInCents>12000</amountInCents> <!-- amount in eBucks cents (EB * 10) -->
         </Ebucks>
        <Customfield>
            <key>ebucksOtp</key>
            <value>909059</value>
         </Customfield>
         <Customfield>
            <key>ebucksAccountNumber</key>
            <value>80000278865</value>
         </Customfield>
      </soap:doTransaction>
   </soapenv:Body>
</soapenv:Envelope>

Anchor

	request_credit
	request_credit

Top

Code Block

language	xml
title	REQUEST - Crediting a transaction
linenumbers	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.api.controller.web.payjar.com/" xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Header>
        <wsse:Security SOAP-ENV:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
            <wsse:UsernameToken wsu:Id="UsernameToken-9" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
                <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username>
                <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes
            here~~~</wsse:Password>
            </wsse:UsernameToken>
        </wsse:Security>
    </soapenv:Header>
    <soapenv:Body>
        <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">
            <Api>ONE_ZERO</Api>
            <Safekey>~~~SAFEKEY goes here ~~~</Safekey>
            <TransactionType>CREDIT</TransactionType>
            <AdditionalInformation>
                <merchantReference>~~~Merchant ref goes here ~~~</merchantReference>
                <payUReference>~~~PayU ref goes here ~~~</payUReference>
            </AdditionalInformation>
            <Basket>
                <amountInCents>1000</amountInCents>
                <currencyCode>ZAR</currencyCode>
            </Basket>
        </soap:doTransaction>
    </soapenv:Body>
</soapenv:Envelope>

Anchor

	response_without_bank_ref
	response_without_bank_ref

Top

Code Block

language	xml
title	RESPONSE - Credit Card: PAYMENT or RESERVE
linenumbers	true

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
         <return>
            <resultCode>00</resultCode>
            <resultMessage>Successful</resultMessage>
            <successful>true</successful>
            <displayMessage>Successful</displayMessage>
            <merchantReference>1234567890</merchantReference>
            <payUReference>21976214819</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>John Doe</nameOnCard>
            </paymentMethodsUsed>
         </return>
      </ns2:doTransactionResponse>
   </soap:Body>
</soap:Envelope>

Anchor

	response_with_3D
	response_with_3D

Top

Code Block

language	xml
title	RESPONSE - Credit Card: PAYMENT or RESERVE (with 3D Secure enabled - card enrolled)

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
    <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
        <return>
            <displayMessage>Transaction Pending 3DS Completion</displayMessage>
            <fraud>
                <resultCode>V030</resultCode>
                <resultMessage>Success</resultMessage>
            </fraud>
            <merchantReference>0123456789</merchantReference>
            <payUReference>31982857915</payUReference>
            <paymentMethodsUsed xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <amountInCents>350</amountInCents>
                <cardExpiry>092014</cardExpiry>
                <cardNumber>456546******6016</cardNumber>
                <gatewayReference>37117846</gatewayReference>
              <wsse:UsernameToken wsu:Id="UsernameToken-9" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> <information>VISA</information>
                <nameOnCard>Jon Doe </nameOnCard>
         <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username></paymentMethodsUsed>
           <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes <resultCode>P3DS</resultCode>
            <resultMessage>Transaction Pending 3DS here~~~</wsse:Password>
Completion</resultMessage>
       </wsse:UsernameToken>     </wsse:Security><secure3D>
     </soapenv:Header>     <soapenv:Body>     <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/"> <secure3DId>A5ufG1Q3sp3qGDxu5de3</secure3DId>
        <Api>ONE_ZERO</Api>         <Safekey>~~~SAFEKEY goes here ~~~</Safekey><secure3DUrl><![CDATA[<form name="downloadForm" action="http://acstest.bankserv.co.za/V3DSStart?osb=visa-3&VAA=B"
         <TransactionType>~~~a value of PAYMENT or RESERVE~~~</TransactionType>  method="POST">
      <AdditionalInformation>          <table <merchantReference>~~~Merchant ref goes here~~~</merchantReference>name="dataTable" border="0" cellpadding="0">
           <notificationUrl>http://example.com/notification-page/</notificationUrl>     <INPUT TYPE="hidden"   </AdditionalInformation>NAME="TransactionID" value="A5ufG1Q3sp3qGDxu5de3">
        <Customer>        <INPUT TYPE="hidden"  <countryCode>27</countryCode>NAME="PaReq"
           <countryOfResidence>ZAR</countryOfResidence>     value="eNpVUtty2jAQfddXeNLHzliWbWzCLJohgZSkTbik0yZ9E2IpLmCD5Av46ys5dtK+nbO7Wp2zu/B9qxDHzygLhRweUWvxG51kPbyanrP463K3Ci7ZTL
     <merchantUserId>0123465798</merchantUserId>           <email>john.doe@example.com</email>zOskX5ebp5qR/Efje84jAfLfHEoUSlkyzlzPVcH2hHiWml5FakOQchTzf3TzzqhYHPgLaUwAHV/ZgzPwh7UdwH+sYJpOKA/EakO42qHG1UIoXTdQPaZAnIrEh
          <firstName>John</firstName>      zdeEx84B2hECh9nyb58cBpVVVuau2iysztxZAbZoA/dA2LyzSxvo5WfM48Ov56+IJy9XPu/GPSzkZf9Gnl9vq2+MQqK0gsBY5ct9jgdf3fIdFg9AbMGOriRMQ
    <lastName> Doe </lastName>           <mobile>0827777777</mobile>B6uFLwO3Z4S1jMDR/jN6Y4HN/BswbgqlMJWdnY4RwPMxS9HUmNm+YyMCteSZWqNyPjlBzFjcDyOjwYYJJKnOxX5v33TQmP6weju1S5G5mfadCPWsno
           <regionalId>5612124567897</regionalId>     pZdP0QqF/qz3GyQb+q88XEbqqpaVQkZrws9K4bGUkza2r70PYOaHs6Bv13Un8BvvXHsA==">
     <ip>127.0.0.1</ip>         </Customer>  <INPUT TYPE="hidden" NAME="TermUrl" VALUE="http://staging.safeshop.co.za/s2s/Secure3D/Encode_Finish.asp">
   <Basket>           <amountInCents>12000</amountInCents>  <INPUT TYPE="hidden" NAME="MD" VALUE="37117846">
     <currencyCode>ZAR</currencyCode>           <description>Fraud Basket</description></table>
         </Basket>       <center><p><font  <Creditcard>
      type="Arial" size=2>Transfering to your bank for credit card authentication.
   <amountInCents>12000</amountInCents>           <cardExpiry>122014</cardExpiry>  <p> If you are not redirected please <a  <cardNumber>4111120000005078</cardNumber>
          <cvv>123</cvv>href="javascript:AutoSubmitForm()">click here</a> on the image to continue to access your banking
           <nameOnCard>Fred Fraud</nameOnCard>    institution.<p>
    </Creditcard>     </soap:doTransaction>     </soapenv:Body> </soapenv:Envelope>

...

Top

Code Block

language	xml
title	doTransaction request example (with Fraud enabled)
linenumbers	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap <input type="image" src="http://soapstaging.images.apisafeshop.controller.web.payjar.com/" xmlns:SOAPENV="co.za/PaymentMethods/Secure3D/VbyV_blue_120x69.gif" name="continue"
     http://schemas.xmlsoap.org/soap/envelope/">     <soapenv:Header>     <wsse:Security SOAP-ENV:mustUnderstand value="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">Continue"></center>
                </form>
               <wsse:UsernameToken wsu:Id="UsernameToken-9" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd <script language="Javascript">
        <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username>
         <!--
      <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes       function AutoSubmitForm() {document.downloadForm.submit();
   here~~~</wsse:Password>          </wsse:UsernameToken>   }
 </wsse:Security>     </soapenv:Header>     <soapenv:Body>     <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">AutoSubmitForm();
         <Api>ONE_ZERO</Api>       //--></script>]]></secure3DUrl>
 <Safekey>~~~SAFEKEY goes here ~~~</Safekey>         <TransactionType>~~~a value of PAYMENT</secure3D>
or RESERVE~~~</TransactionType>         <AdditionalInformation>  <successful>true</successful>
        <deviceId>TERM003<</deviceId>return>
    </ns2:doTransactionResponse>
     <merchantReference>~~~Merchant ref goes here ~~~</merchantReference>
   </soap:Body>
</soap:Envelope>

Anchor

	response_with_bank_ref
	response_with_bank_ref

Top

Code Block

language	xml
title	RESPONSE - Credit Card: PAYMENT or RESERVE (with bank reference)
linenumbers	true

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <notificationUrl> <ns2:doTransactionResponse xmlns:ns2="http://examplesoap.api.controller.web.payjar.com/notification-page/</notificationUrl>">
        </AdditionalInformation>  <return>
      <Customer>           <countryCode>27</countryCode>
          <countryOfResidence>ZAR</countryOfResidence><resultCode>00</resultCode>
            <merchantUserId>0123465798<<resultMessage>Successful</merchantUserId>resultMessage>
            <email>john.doe@example.com</email><successful>true</successful>
            <firstName>John<<displayMessage>Successful</firstName>displayMessage>
          <lastName> Doe <<merchantReference>1234567890</lastName>merchantReference>
            <mobile>0827777777<<payUReference>21976214819</mobile>payUReference>
          <regionalId>5612124567897</regionalId>  <paymentMethodsUsed xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <ip>127.0.0.1</ip>         <<amountInCents>1000</Customer>amountInCents>
         <Basket>      <cardExpiry>122015</cardExpiry>
    <amountInCents>12000</amountInCents>           <currencyCode>ZAR</currencyCode><cardNumber>400000******1000</cardNumber>
          <description>Fraud Basket</description>    <gatewayReference>37149772</gatewayReference>
      <!--Zero or more repetitions:-->      <information>VISA</information>
    <productLineItem>           <nameOnCard>John Doe</nameOnCard>
  <amount>10000</amount>          </paymentMethodsUsed> 
   <costAmount>1000</costAmount>         <customFields>
     <description>Product 1</description>         <key>bankReference</key>
     <giftMessage>Happy Birthday</giftMessage>         <value>DEMO12</value>
     <productCode>ABC0002</productCode>       </customFields>
       <quantity>1</quantity>  </return>
     Â </ns2:doTransactionResponse>
   </soap:Body>
  <recipientAddress1>21 Example Road</recipientAddress1></soap:Envelope>

Anchor

	response_with_fraud_approve
	response_with_fraud_approve

Top

Code Block

language	xml
title	RESPONSE - Credit Card: PAYMENT or RESERVE (with Fraud enabled - APPROVE)
linenumbers	true

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
         <recipientCity>Cape Town</recipientCity>
              <recipientCountryCode>ZAR</recipientCountryCode><ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
            <return>
 <recipientPostalCode>8000</recipientPostalCode>               <recipientFirstName>John</recipientFirstName>
         <displayMessage>Successful</displayMessage>
    <recipientLastName>Doe</recipientLastName>           </productLineItem>   <fraud>
       <shippingDetails>             <resultCode>V030</resultCode>
 <shippingAddress1>21 Example Road</shippingAddress1>               <shippingAddressCity>Cape Town <<resultMessage>Success</shippingAddressCity>resultMessage>
              <shippingEmail> john.doe@example.com </shippingEmail>fraud>
              <shippingCountryCode>ZAR</shippingCountryCode>  <merchantReference>mercRef_1403097874</merchantReference>
            <shippingStateCode>WC</shippingStateCode>    <payUReference>185871924286</payUReference>
          <shippingMethod>P</shippingMethod>      <paymentMethodsUsed xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns2:creditCard">
      <shppingFirstName>John</shppingFirstName>                <shippingLastName>Doe<<amountInCents>2156</shippingLastName>amountInCents>
              <shippingFax>27214688020</shippingFax>shippingFax>      <cardExpiry>012015</cardExpiry>
        <shippingPhone>27214688021</shippingPhone>            </shippingDetails><cardNumber>542028******1323</cardNumber>
          </Basket>         <Fraud> <gatewayReference>37585977</gatewayReference>
         <checkFraudOverride>false</checkFraudOverride>           <merchantWebSite>http://www.example.com/ </merchantWebSite><information>MASTERCARD</information>
            <pcFingerPrint>owhjiflkwhefqwoaef</pcFingerPrint>        <nameOnCard>John <Doe</Fraud>nameOnCard>
        <Creditcard>        </paymentMethodsUsed>
  <amountInCents>12000</amountInCents>           <cardExpiry>122014</cardExpiry>   <resultCode>00</resultCode>
       <cardNumber>4111120000005078</cardNumber>         <resultMessage>Successful</resultMessage>
 <cvv>123</cvv>           <nameOnCard>Fred Fraud</nameOnCard>   <successful>true</successful>
       <verified/>     </return>
   </Creditcard>     </soapns2:doTransaction>doTransactionResponse>
    </soapenvsoap:Body>
</soapenvsoap:Envelope>

Anchor

	response_with_fraud_handshakechallenge
	response_with_fraud_handshakechallenge

Top

Code Block

language	xml
title	RESPONSE - Credit Card with Handshake Example: PAYMENT or RESERVE (with Fraud enabled - CHALLENGE)
linenumbers	true

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
     <AdditionalInformation>   <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
    <merchantReference>CJR001</merchantReference>      </AdditionalInformation>  <return>
  <Customer>         <mobile>27827891249</mobile>     <<displayMessage>Successful</Customer>displayMessage>
     <Basket>         <amountInCents>1000</amountInCents>  <fraud>
      <currencyCode>ZAR</currencyCode>         <description>ORD111</description>     <<resultCode>V035</Basket>resultCode>
    <PaymentMethods>         <CreditCard pmID="jh23d29832jhdo23hu" CVV=â€�123â€� AmountInCents="2300" />     </PaymentMethods>
</DoTransaction>

...

Top

Code Block

language	xml
title	Credit Card with Token (Save Card) first 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><resultMessage>CHALLENGE - 0330</resultMessage>
                </fraud>
                <merchantReference>mercRef_1403098425</merchantReference>
                <payUReference>185878360665</payUReference>
                <soap:doTransaction<paymentMethodsUsed xmlns:ns2xsi="http://soapwww.api.controller.web.payjar.com/">
    w3.org/2001/XMLSchema-instance" xsi:type="ns2:creditCard">
       <Api>ONE_ZERO</Api>             <Safekey>{86903CCB-79A9-42EE-0174-1ACE90185507}</Safekey><amountInCents>7215</amountInCents>
               <TransactionType>PAYMENT</TransactionType>     <cardExpiry>012015</cardExpiry>
       <AuthenticationType>NA</AuthenticationType>             <AdditionalInformation><cardNumber>542028******1323</cardNumber>
                <merchantReference>MerchRef001</merchantReference>    <gatewayReference>37585978</gatewayReference>
            <supportedPaymentMethods>CREDITCARD</supportedPaymentMethods>        <information>MASTERCARD</information>
        <storePaymentMethod>true</storePaymentMethod>            <nameOnCard>John <Doe</AdditionalInformation>nameOnCard>
            <Customer>    </paymentMethodsUsed>
            <countryCode>27</countryCode>    <resultCode>00</resultCode>
            <merchantUserId>MechUser001</merchantUserId>    <resultMessage>Successful</resultMessage>
            <email>name.surname@mail.com</email>    <successful>true</successful>
            <firstName>Name<</firstName>return>
        </ns2:doTransactionResponse>
    </soap:Body>
</soap:Envelope>
  <lastName>Surname</lastName>

Anchor

	response_with_fraud_deny
	response_with_fraud_deny

Top

Code Block

language	xml
title	RESPONSE - Credit Card: PAYMENT or RESERVE (with Fraud enabled - DENY)
linenumbers	true

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
           <mobile>27887592452</mobile>
                <regionalId>2345679888</regionalId><ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
            </Customer><return>
            <Basket>     <fraud>
           <amountInCents>1000</amountInCents>                 <currencyCode>ZAR</currencyCode>
<resultCode>V039</resultCode>
               <description>Goods</description>       <resultMessage>DENY - 0700</resultMessage>
   </Basket>             <Creditcard></fraud>
                <amountInCents>1000<<merchantReference>mercRef_1403098545</amountInCents>merchantReference>
                <cardExpiry>122013<<payUReference>185879181093</cardExpiry>payUReference>
                <cardNumber>5111120000091349<<resultCode>P044</cardNumber>resultCode>
                <resultMessage>Rejected for <cvv>123<fraud</cvv>resultMessage>
                <nameOnCard>N Surname<<successful>false</nameOnCard>successful>
            </Creditcard>return>
        </soapns2:doTransaction>doTransactionResponse>
    </soapenvsoap:Body>
</soapenvsoap:Envelope>

Anchor

	saveresponse_cardeBucks_2PAYMENTsave
	response_cardeBucks_2PAYMENT

Top

Code Block

language	xml
title	Credit Card with Token (Save Card) Subsequent REQUEST:RESPONSE - eBucks (PAYMENT)
linenumbers	true

<soapenv<soap:Envelope xmlns:soapenvsoap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:doTransactionResponse xmlns:soapns2="http://soap.api.controller.web.payjar.com/">
   <soapenv:Header/>      <return>
    <soapenv:Body>       <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/"> <resultCode>00</resultCode>
            <Api>ONE_ZERO</Api><resultMessage>Successful</resultMessage>
            <successful>true</successful>
     <Safekey>{86903CCB-79A9-42EE-0174-1ACE90185507}</Safekey>       <displayMessage>Successful</displayMessage>
  <TransactionType>PAYMENT</TransactionType>          <AuthenticationType>TOKEN<<merchantReference>1234567890</AuthenticationType>merchantReference>
         <AdditionalInformation>   <payUReference>21976214819</payUReference>
       <merchantReference>MerchRef001</merchantReference>     <paymentMethodsUsed xsi:type="ns2:ebucks" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <supportedPaymentMethods>CREDITCARD</supportedPaymentMethods>           <<amountInCents>12000</AdditionalInformation>amountInCents>
         <Customer>   </paymentMethodsUsed>
         <countryCode>27<</countryCode>return>
      </ns2:doTransactionResponse>
   </soap:Body>
 <merchantUserId>MechUser001</merchantUserId></soap:Envelope>

Anchor

	response_EFTPro_payment
	response_EFTPro_payment

Top

Code Block

language	xml
title	RESPONSE - EFTPro payment
linenumbers	true

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
       <email>name.surname@mail.com</email><ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
            <firstName>Name</firstName><return>
            <lastName>Surname</lastName><merchantReference>EFT_PRO_98453984398</merchantReference>
            <mobile>27887592452<<payUReference>53390698880</mobile>payUReference>
            <regionalId>2345679888</regionalId>
         </Customer><paymentMethodsUsed xsi:type="ns2:eft" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
         <Basket>      <amountInCents>100</amountInCents>
      <amountInCents>1000</amountInCents>      </paymentMethodsUsed>
      <currencyCode>ZAR</currencyCode>      <redirect>
      <description>Goods</description>         <method>HTTP_GET</method>
 </Basket>              <type>EFT_PRO</type>
   <Creditcard             <pmId>DyZ7XBB5QxF5FEoIADAkMCQAUnlDEmIRVXNTa3xUYVUWfEUT</pmId><url>http://localhost:8080/PayJarWeb/redirectGet.do?PayUReference=53390698880</url>
            <amountInCents>1000<</amountInCents>redirect>
            <cvv>123<<successful>true</cvv>successful>
         </Creditcard>return>
      </soapns2:doTransaction>doTransactionResponse>
   </soapenvsoap:Body>
</soapenvsoap:Envelope>

Versions Compared

Old Version 36

New Version Current

Key