Versions Compared

Old Version 34

changes.mady.by.user Former user

Saved on

compared with

New Version Current

changes.mady.by.user Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
doctop
doctop

Click on the following links to view data structure examples of the following API request

...

The following are examples of how you would need to set out your data when querying PayU's API with SOAP.

  1. API requests:

...

    • 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

...

...

Top

...


  1. API response:

...

Anchor
example_without_fraud
example_without_fraud

Top

Code Block
languagexml
titleREQUEST - Credit Card request: PAYMENT or RESERVE
linenumberstrue
<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
languagexml
titleREQUEST - Credit Card: PAYMENT or RESERVE (with Fraud enabled)
linenumberstrue
<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
languagexml
titleREQUEST - Credit Card with Handshake
linenumberstrue
<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
languagexml
titleREQUEST - eBucks (PAYMENT)
linenumberstrue
<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
languagexml
titleREQUEST - Crediting a transaction
linenumberstrue
<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
languagexml
titleRESPONSE - Credit Card: PAYMENT or RESERVE
linenumberstrue
<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
languagexml
titleRESPONSE - 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
languagexml
titledoTransaction request example (with Fraud enabled)
linenumberstrue
<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
languagexml
titleRESPONSE - Credit Card: PAYMENT or RESERVE (with bank reference)
linenumberstrue
<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
languagexml
titleRESPONSE - Credit Card: PAYMENT or RESERVE (with Fraud enabled - APPROVE)
linenumberstrue
<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

<DoTransaction Api=�1.0� Safekey=�{86903CCB-79A9-42EE-8637-1ACE90185507}� TransactionType=�PAYMENT� AuthenticationType=�HANDSHAKE� >
Code Block
languagexml
titleRESPONSE - Credit Card with Handshake Example: PAYMENT or RESERVE (with Fraud enabled - CHALLENGE)
linenumberstrue
<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
languagexml
titleCredit Card with Token (Save Card) first REQUEST:
linenumberstrue
<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
languagexml
titleRESPONSE - Credit Card: PAYMENT or RESERVE (with Fraud enabled - DENY)
linenumberstrue
<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
languagexml
titleCredit Card with Token (Save Card) Subsequent REQUEST:RESPONSE - eBucks (PAYMENT)
linenumberstrue
<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
languagexml
titleRESPONSE - EFTPro payment
linenumberstrue
<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>