Versions Compared

Key

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

Anchor
doctop
doctop

Click on any of the following links to view a sample of the respective data structureThe following are examples of how you would need to set out your data when querying PayU's API with SOAP.

  1. API requests:
  2. API response:

...

Top

...

...

...

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>
           <wsse:UsernameToken wsu:Id="UsernameToken-9" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> <Basket>
                <amountInCents>1000</amountInCents>
             <wsse:Username>~~~SOAP Username goes here~~~<<currencyCode>ZAR</wsse:Username>currencyCode>
        <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes    </Basket>
        </soap:doTransaction>
    </soapenv:Body>
 here~~~</wsse:Password>
        </wsse:UsernameToken>
    </wsse:Security>
    </soapenv:Header></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>
    <soapenv:Body>     <soap:doTransaction<ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">com/">
         <return>
            <resultCode>00</resultCode>
            <Api>ONE_ZERO</Api><resultMessage>Successful</resultMessage>
         <Safekey>~~~SAFEKEY goes here ~~~<<successful>true</Safekey>successful>
          <TransactionType>~~~a value of<displayMessage>Successful</displayMessage>
PAYMENT or RESERVE~~~</TransactionType>         <AdditionalInformation> <merchantReference>1234567890</merchantReference>
         <merchantReference>~~~Merchant ref goes here~~~<<payUReference>21976214819</merchantReference>payUReference>
            <notificationUrl>http<paymentMethodsUsed xsi:type="ns2:creditCard" xmlns:xsi="http://example.com/notification-page/</notificationUrl>
        </AdditionalInformation>www.w3.org/2001/XMLSchema-instance">
        <Customer>           <countryCode>27</countryCode><amountInCents>1000</amountInCents>
          <countryOfResidence>ZAR</countryOfResidence>     <cardExpiry>122015</cardExpiry>
     <merchantUserId>0123465798</merchantUserId>           <email>john.doe@example.com</email><cardNumber>400000******1000</cardNumber>
          <firstName>John</firstName>     <gatewayReference>37149772</gatewayReference>
     <lastName> Doe </lastName>           <mobile>0827777777<<information>VISA</mobile>information>
          <regionalId>5612124567897</regionalId>     <nameOnCard>John Doe</nameOnCard>
    <ip>127.0.0.1</ip>         </Customer>paymentMethodsUsed>
         </return>
  <Basket>    </ns2:doTransactionResponse>
   </soap:Body>
</soap:Envelope>
  <amountInCents>12000</amountInCents>
          <currencyCode>ZAR</currencyCode>

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>
     <description>Fraud Basket</description>
        </Basket>
        <Creditcard>
          <amountInCents>12000</amountInCents><ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
        <return>
 <cardExpiry>122014</cardExpiry>           <cardNumber>4111120000005078</cardNumber><displayMessage>Transaction Pending          <cvv>123</cvv>3DS Completion</displayMessage>
          <nameOnCard>Fred Fraud</nameOnCard>
        </Creditcard> <fraud>
    </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="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">      <resultCode>V030</resultCode>
                <resultMessage>Success</resultMessage>
            </fraud>
            <merchantReference>0123456789</merchantReference>
            <payUReference>31982857915</payUReference>
            <wsse:UsernameToken<paymentMethodsUsed wsuxsi:Idtype="UsernameToken-9ns2:creditCard" xmlns:wsuxsi="http://docswww.oasis-openw3.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">2001/XMLSchema-instance">
                <amountInCents>350</amountInCents>
                <cardExpiry>092014</cardExpiry>
             <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username> <cardNumber>456546******6016</cardNumber>
               <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes <gatewayReference>37117846</gatewayReference>
                here~~~<<information>VISA</wsse:Password>information>
        </wsse:UsernameToken>     </wsse:Security>   <nameOnCard>Jon Doe </soapenv:Header>nameOnCard>
    <soapenv:Body>     <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">    </paymentMethodsUsed>
    <Api>ONE_ZERO</Api>        <resultCode>P3DS</resultCode>
<Safekey>~~~SAFEKEY goes here ~~~</Safekey>         <TransactionType>~~~a<resultMessage>Transaction valuePending of3DS PAYMENTCompletion</resultMessage>
or RESERVE~~~</TransactionType>         <AdditionalInformation>  <secure3D>
        <deviceId>TERM003</deviceId>        <secure3DId>A5ufG1Q3sp3qGDxu5de3</secure3DId>
  <merchantReference>~~~Merchant ref goes here ~~~</merchantReference>           <notificationUrl> <secure3DUrl><![CDATA[<form name="downloadForm" action="http://example.com/notification-page/</notificationUrl>acstest.bankserv.co.za/V3DSStart?osb=visa-3&VAA=B"
        </AdditionalInformation>        method="POST">
<Customer>           <countryCode>27</countryCode>     <table      <countryOfResidence>ZAR</countryOfResidence>name="dataTable" border="0" cellpadding="0">
          <merchantUserId>0123465798</merchantUserId>      <INPUT TYPE="hidden" NAME="TransactionID" value="A5ufG1Q3sp3qGDxu5de3">
 <email>john.doe@example.com</email>           <firstName>John</firstName>    <INPUT TYPE="hidden" NAME="PaReq"
    <lastName> Doe </lastName>           <mobile>0827777777</mobile>value="eNpVUtty2jAQfddXeNLHzliWbWzCLJohgZSkTbik0yZ9E2IpLmCD5Av46ys5dtK+nbO7Wp2zu/B9qxDHzygLhRweUWvxG51kPbyanrP463K3Ci7ZTL
          <regionalId>5612124567897</regionalId>      zOskX5ebp5qR/Efje84jAfLfHEoUSlkyzlzPVcH2hHiWml5FakOQchTzf3TzzqhYHPgLaUwAHV/ZgzPwh7UdwH+sYJpOKA/EakO42qHG1UIoXTdQPaZAnIrEh
    <ip>127.0.0.1</ip>            </Customer>zdeEx84B2hECh9nyb58cBpVVVuau2iysztxZAbZoA/dA2LyzSxvo5WfM48Ov56+IJy9XPu/GPSzkZf9Gnl9vq2+MQqK0gsBY5ct9jgdf3fIdFg9AbMGOriRMQ
        <Basket>        B6uFLwO3Z4S1jMDR/jN6Y4HN/BswbgqlMJWdnY4RwPMxS9HUmNm+YyMCteSZWqNyPjlBzFjcDyOjwYYJJKnOxX5v33TQmP6weju1S5G5mfadCPWsno
  <amountInCents>12000</amountInCents>           <currencyCode>ZAR</currencyCode>   pZdP0QqF/qz3GyQb+q88XEbqqpaVQkZrws9K4bGUkza2r70PYOaHs6Bv13Un8BvvXHsA==">
       <description>Fraud Basket</description>        <INPUT TYPE="hidden"  <!--Zero or more repetitions:-->NAME="TermUrl" VALUE="http://staging.safeshop.co.za/s2s/Secure3D/Encode_Finish.asp">
               <productLineItem> <INPUT TYPE="hidden" NAME="MD" VALUE="37117846">
          <amount>10000</amount>      </table>
        <costAmount>1000</costAmount>        <center><p><font type="Arial" size=2>Transfering to your bank for <description>Productcredit 1</description>card authentication.
             <giftMessage>Happy Birthday</giftMessage>  <p> If you are not redirected please <a href="javascript:AutoSubmitForm()">click here</a> on the image <productCode>ABC0002</productCode>to continue to access your banking
         <quantity>1</quantity>       institution.<p>
       <recipientAddress1>21 Example Road</recipientAddress1>       <input type="image" src="http://staging.images.safeshop.co.za/PaymentMethods/Secure3D/VbyV_blue_120x69.gif" name="continue"
    <recipientCity>Cape Town</recipientCity>           value="Continue"></center>
   <recipientCountryCode>ZAR</recipientCountryCode>             </form>
 <recipientPostalCode>8000</recipientPostalCode>               <recipientFirstName>John</recipientFirstName>
<script language="Javascript">
             <recipientLastName>Doe</recipientLastName>   <!--
       </productLineItem>         function  <shippingDetails>AutoSubmitForm() {document.downloadForm.submit();
              <shippingAddress1>21 Example Road</shippingAddress1>}
              <shippingAddressCity>Cape Town </shippingAddressCity> AutoSubmitForm();
              <shippingEmail> john.doe@example.com </shippingEmail> //--></script>]]></secure3DUrl>
                <shippingCountryCode>ZAR</shippingCountryCode></secure3D>
            <successful>true</successful>
     <shippingStateCode>WC</shippingStateCode>   </return>
    </ns2:doTransactionResponse>
    </soap:Body>
 <shippingMethod>P</shippingMethod>
              <shppingFirstName>John</shppingFirstName>
   </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>
          <shippingLastName>Doe</shippingLastName>
              <shippingFax>27214688020</shippingFax>shippingFax>
              <shippingPhone>27214688021</shippingPhone><ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
         <return>
</shippingDetails>         </Basket>   <resultCode>00</resultCode>
     <Fraud>       <resultMessage>Successful</resultMessage>
   <checkFraudOverride>false</checkFraudOverride>         <successful>true</successful>
 <merchantWebSite>http://www.example.com/ </merchantWebSite>           <pcFingerPrint>owhjiflkwhefqwoaef<<displayMessage>Successful</pcFingerPrint>
displayMessage>
       </Fraud>     <merchantReference>1234567890</merchantReference>
   <Creditcard>           <amountInCents>12000<<payUReference>21976214819</amountInCents>payUReference>
          <cardExpiry>122014</cardExpiry>  <paymentMethodsUsed   xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
     <cardNumber>4111120000005078</cardNumber>           <cvv>123<<amountInCents>1000</cvv>
amountInCents>
         <nameOnCard>Fred Fraud</nameOnCard>           <verified/><cardExpiry>122015</cardExpiry>
        </Creditcard>     </soap:doTransaction>
    </soapenv:Body>
</soapenv:Envelope>

...

Top

Code Block
languagexml
titleCredit Card with Handshake Example
linenumberstrue
<DoTransaction Api=�1.0� Safekey=�{86903CCB-79A9-42EE-8637-1ACE90185507}� TransactionType=�PAYMENT� AuthenticationType=�HANDSHAKE� >
    <AdditionalInformation>  <cardNumber>400000******1000</cardNumber>
               <gatewayReference>37149772</gatewayReference>
          <merchantReference>CJR001</merchantReference>     <<information>VISA</AdditionalInformation>information>
      <Customer>         <mobile>27827891249</mobile><nameOnCard>John Doe</nameOnCard>
     </Customer>     <Basket>  </paymentMethodsUsed> 
     <amountInCents>1000</amountInCents>       <customFields>
 <currencyCode>ZAR</currencyCode>         <description>ORD111</description>     </Basket><key>bankReference</key>
       <PaymentMethods>        <value>DEMO12</value>
<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>
        <soap:doTransaction xmlns:ns2  </customFields>
         </return>
      </ns2:doTransactionResponse>
   </soap:Body>
</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://soapschemas.api.controller.web.payjar.com/">
            <Api>ONE_ZERO</Api>xmlsoap.org/soap/envelope/">
            <Safekey>{86903CCB-79A9-42EE-0174-1ACE90185507}</Safekey><soap:Body>
            <TransactionType>PAYMENT</TransactionType>
            <AuthenticationType>NA</AuthenticationType>
            <AdditionalInformation><ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
            <return>
   <merchantReference>MerchRef001</merchantReference>                 <supportedPaymentMethods>CREDITCARD</supportedPaymentMethods><displayMessage>Successful</displayMessage>
                <storePaymentMethod>true</storePaymentMethod><fraud>
            </AdditionalInformation>         <resultCode>V030</resultCode>
   <Customer>                 <countryCode>27<<resultMessage>Success</countryCode>resultMessage>
                <merchantUserId>MechUser001<</merchantUserId>fraud>
                <email>name.surname@mail.com</email><merchantReference>mercRef_1403097874</merchantReference>
                <firstName>Name<<payUReference>185871924286</firstName>payUReference>
                <lastName>Surname</lastName>
                <mobile>27887592452</mobile>
<paymentMethodsUsed xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns2:creditCard">
               <regionalId>2345679888</regionalId>             </Customer><amountInCents>2156</amountInCents>
            <Basket>        <cardExpiry>012015</cardExpiry>
        <amountInCents>1000</amountInCents>            <cardNumber>542028******1323</cardNumber>
    <currencyCode>ZAR</currencyCode>                 <description>Goods<<gatewayReference>37585977</description>gatewayReference>
            </Basket>        <information>MASTERCARD</information>
    <Creditcard>                <nameOnCard>John <amountInCents>1000<Doe</amountInCents>nameOnCard>
                <cardExpiry>122013<</cardExpiry>paymentMethodsUsed>
                <cardNumber>5111120000091349<<resultCode>00</cardNumber>resultCode>
                <cvv>123<<resultMessage>Successful</cvv>resultMessage>
                <nameOnCard>N Surname<<successful>true</nameOnCard>successful>
            </Creditcard>return>
        </soapns2:doTransaction>doTransactionResponse>
    </soapenvsoap:Body>
</soapenvsoap:Envelope>

Anchor
saveresponse_with_cardfraud_2challengesave
response_with_cardfraud_2challenge

Top

Code Block
languagexml
titleRESPONSE - Credit Card with Token (Save Card) Subsequent REQUEST:: PAYMENT or RESERVE (with Fraud enabled - CHALLENGE)
linenumberstrue
<soapenv<soap:Envelope xmlns:soapenvsoap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.api.controller.web.payjar.com/">
   <soapenv:Header//soap/envelope/">
   <soapenv <soap:Body>
      <soap  <ns2:doTransactiondoTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
            <return>
                <displayMessage>Successful</displayMessage>
                <fraud>
                    <resultCode>V035</resultCode>
     <Api>ONE_ZERO</Api>          <Safekey>{86903CCB-79A9-42EE-0174-1ACE90185507}</Safekey>     <resultMessage>CHALLENGE - 0330</resultMessage>
  <TransactionType>PAYMENT</TransactionType>          <AuthenticationType>TOKEN</AuthenticationType>    </fraud>
     <AdditionalInformation>           <merchantReference>MerchRef001<<merchantReference>mercRef_1403098425</merchantReference>
          <supportedPaymentMethods>CREDITCARD</supportedPaymentMethods>      <payUReference>185878360665</payUReference>
   </AdditionalInformation>            <Customer> <paymentMethodsUsed xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns2:creditCard">
         <countryCode>27</countryCode>             <merchantUserId>MechUser001<<amountInCents>7215</merchantUserId>amountInCents>
            <email>name.surname@mail.com</email>             <firstName>Name</firstName><cardExpiry>012015</cardExpiry>
            <lastName>Surname</lastName>             <mobile>27887592452</mobile><cardNumber>542028******1323</cardNumber>
            <regionalId>2345679888</regionalId>          <<gatewayReference>37585978</Customer>gatewayReference>
         <Basket>           <information>MASTERCARD</information>
 <amountInCents>1000</amountInCents>             <currencyCode>ZAR</currencyCode>      <nameOnCard>John Doe</nameOnCard>
     <description>Goods</description>           </Basket>paymentMethodsUsed>
                 <Creditcard
<resultCode>00</resultCode>
           <pmId>DyZ7XBB5QxF5FEoIADAkMCQAUnlDEmIRVXNTa3xUYVUWfEUT</pmId>      <resultMessage>Successful</resultMessage>
      <amountInCents>1000</amountInCents>          <successful>true</successful>
  <cvv>123</cvv>          </Creditcard>return>
        </soapns2:doTransaction>doTransactionResponse>
    </soapenvsoap:Body>
</soapenvsoap:Envelope>

Anchor
response_withoutwith_bankfraud_refdeny
response_withoutwith_bankfraud_refdeny

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>
        <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
          <return>  <return>
           <customFields>     <fraud>
           <key>bankReference</key>                 <value>DEMO12</value><resultCode>V039</resultCode>
              </customFields>      <resultMessage>DENY - 0700</resultMessage>
     <displayMessage>Successful</displayMessage>           </fraud>
  <merchantReference>Munier</merchantReference>              <payUReference>31976214819</payUReference><merchantReference>mercRef_1403098545</merchantReference>
              <paymentMethodsUsed xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <payUReference>185879181093</payUReference>
                <amountInCents>1000<<resultCode>P044</amountInCents>resultCode>
                <resultMessage>Rejected for <cardExpiry>122015<fraud</cardExpiry>resultMessage>
                <cardNumber>400000******1000</cardNumber><successful>false</successful>
            </return>
        <gatewayReference>37149772</gatewayReference>

   </ns2:doTransactionResponse>
    </soap:Body>
</soap:Envelope>

Anchor
response_eBucks_PAYMENT
response_eBucks_PAYMENT

Top

Code Block
languagexml
titleRESPONSE - eBucks (PAYMENT)
linenumberstrue
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
       <information>VISA</information><ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
         <return>
      <nameOnCard>NonThree</nameOnCard>              </paymentMethodsUsed><resultCode>00</resultCode>
             <resultCode>00<<resultMessage>Successful</resultCode>resultMessage>
             <resultMessage>Successful<<successful>true</resultMessage>successful>
             <successful>true</successful>

<displayMessage>Successful</displayMessage>
        </return>    <merchantReference>1234567890</merchantReference>
   </ns2:doTransactionResponse>     </soap:Body>
 </soap:Envelope>  

 

...

Top

Code Block
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <payUReference>21976214819</payUReference>
      <soap:Body>       <ns2:doTransactionResponse<paymentMethodsUsed xsi:type="ns2:ebucks" xmlns:ns2xsi="http://soapwww.api.controller.web.payjar.com/w3.org/2001/XMLSchema-instance">
         <return>      <amountInCents>12000</amountInCents>
      <customFields>      </paymentMethodsUsed>
         <key>bankReference</key></return>
      </ns2:doTransactionResponse>
   </soap:Body>
       <value>DEMO12</value></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>
        </customFields><ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
         <return>
  <displayMessage>Successful</displayMessage>             <merchantReference>Munier<<merchantReference>EFT_PRO_98453984398</merchantReference>
            <payUReference>31976214819<<payUReference>53390698880</payUReference>
            <paymentMethodsUsed xsi:type="ns2:creditCardeft" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <amountInCents>1000</amountInCents>/2001/XMLSchema-instance">
               <cardExpiry>122015<<amountInCents>100</cardExpiry>amountInCents>
               <cardNumber>400000******1000</cardNumber></paymentMethodsUsed>
            <redirect>
  <gatewayReference>37149772</gatewayReference>                <information>VISA</information><method>HTTP_GET</method>
               <nameOnCard>NonThree<<type>EFT_PRO</nameOnCard>type>
            </paymentMethodsUsed>             <resultCode>00</resultCode><url>http://localhost:8080/PayJarWeb/redirectGet.do?PayUReference=53390698880</url>
            <resultMessage>Successful<</resultMessage>redirect>
            <successful>true</successful>
         </return>
      </ns2:doTransactionResponse>
   </soap:Body>
</soap:Envelope>