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/" xmlns:SOAPENV=".payjar.com/">
            <Api>ONE_ZERO</Api>
            <Safekey>~~~SAFEKEY goes here ~~~</Safekey>
            <TransactionType>CREDIT</TransactionType>
            <AdditionalInformation>
        http://schemas.xmlsoap.org/soap/envelope/">     <soapenv:Header>   <merchantReference>~~~Merchant ref <wsse:Security SOAP-ENV:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">goes here ~~~</merchantReference>
                <payUReference>~~~PayU ref <wsse:UsernameToken wsu:Id="UsernameToken-9" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">goes here ~~~</payUReference>
            </AdditionalInformation>
            <Basket>
             <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username><amountInCents>1000</amountInCents>
               <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes <currencyCode>ZAR</currencyCode>
            </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/">/">
         <return>
            <resultCode>00</resultCode>
            <Api>ONE_ZERO</Api><resultMessage>Successful</resultMessage>
         <Safekey>~~~SAFEKEY goes here ~~~<<successful>true</Safekey>successful>
        <TransactionType>~~~a value of PAYMENT or RESERVE~~~<<displayMessage>Successful</TransactionType>displayMessage>
        <AdditionalInformation>    <merchantReference>1234567890</merchantReference>
      <merchantReference>~~~Merchant ref goes here~~~</merchantReference>   <payUReference>21976214819</payUReference>
       <notificationUrl>http://example.com/notification-page/</notificationUrl>     <paymentMethodsUsed    </AdditionalInformation>xsi:type="ns2:creditCard" xmlns:xsi="http://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</mobile>
<information>VISA</information>
         <regionalId>5612124567897</regionalId>      <nameOnCard>John Doe</nameOnCard>
   <ip>127.0.0.1</ip>         </Customer>
  paymentMethodsUsed>
     <Basket>    </return>
      <amountInCents>12000<</amountInCents>ns2:doTransactionResponse>
   </soap:Body>
</soap:Envelope>
     <currencyCode>ZAR</currencyCode>
          <description>Fraud Basket</description>
        </Basket>

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>
   <Creditcard>           <amountInCents>12000</amountInCents>
          <cardExpiry>122014</cardExpiry>
     <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
    <cardNumber>4111120000005078</cardNumber>    <return>
      <cvv>123</cvv>      <displayMessage>Transaction Pending 3DS   <nameOnCard>Fred Fraud</nameOnCard>Completion</displayMessage>
        </Creditcard>     </soap:doTransaction>
    </soapenv:Body>
</soapenv:Envelope>

 

...

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

...

Top

Code Block
languagexml
titleREQUEST - Credit Card with Handshake
linenumberstrue
<DoTransaction Api=�1.0� Safekey=�{86903CCB-79A9-42EE-8637-1ACE90185507}� TransactionType=�PAYMENT� AuthenticationType=�HANDSHAKE� >    <amountInCents>1000</amountInCents>
<AdditionalInformation>          <merchantReference>CJR001</merchantReference>     <<cardExpiry>122015</AdditionalInformation>cardExpiry>
      <Customer>         <mobile>27827891249</mobile><cardNumber>400000******1000</cardNumber>
               <<gatewayReference>37149772</Customer>gatewayReference>
      <Basket>         <amountInCents>1000</amountInCents><information>VISA</information>
               <nameOnCard>John <currencyCode>ZAR<Doe</currencyCode>nameOnCard>
        <description>ORD111</description>     </Basket>paymentMethodsUsed> 
      <PaymentMethods>      <customFields>
  <CreditCard pmID="jh23d29832jhdo23hu" CVV=�123� AmountInCents="2300" />           </PaymentMethods> </DoTransaction>

...

Top

Code Block
languagexml
titleREQUEST - Credit 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 <key>bankReference</key>
               <value>DEMO12</value>
            </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/">
         <soap:Body>
  <Safekey>{86903CCB-79A9-42EE-0174-1ACE90185507}</Safekey>             <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>
            <paymentMethodsUsed xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns2:creditCard">
   <mobile>27887592452</mobile>                 <regionalId>2345679888<<amountInCents>2156</regionalId>amountInCents>
            </Customer>        <cardExpiry>012015</cardExpiry>
    <Basket>                 <amountInCents>1000</amountInCents><cardNumber>542028******1323</cardNumber>
                <currencyCode>ZAR</currencyCode>    <gatewayReference>37585977</gatewayReference>
            <description>Goods</description>             </Basket><information>MASTERCARD</information>
            <Creditcard>                 <amountInCents>1000</amountInCents><nameOnCard>John Doe</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.xmlsoap.org/soap/envelope/">
   <soapenv:Header/> <soap:Body>
   <soapenv:Body>       <soap<ns2:doTransactiondoTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
            <return>
                <Api>ONE_ZERO</Api>
 <displayMessage>Successful</displayMessage>
                <fraud>
       <Safekey>{86903CCB-79A9-42EE-0174-1ACE90185507}</Safekey>           <TransactionType>PAYMENT</TransactionType>  <resultCode>V035</resultCode>
       <AuthenticationType>TOKEN</AuthenticationType>          <AdditionalInformation>   <resultMessage>CHALLENGE - 0330</resultMessage>
     <merchantReference>MerchRef001</merchantReference>           <supportedPaymentMethods>CREDITCARD<</supportedPaymentMethods>fraud>
         </AdditionalInformation>       <merchantReference>mercRef_1403098425</merchantReference>
  <Customer>              <countryCode>27</countryCode><payUReference>185878360665</payUReference>
                 <merchantUserId>MechUser001</merchantUserId><paymentMethodsUsed xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns2:creditCard">
               <email>name.surname@mail.com</email>     <amountInCents>7215</amountInCents>
       <firstName>Name</firstName>             <lastName>Surname<<cardExpiry>012015</lastName>cardExpiry>
            <mobile>27887592452</mobile>        <cardNumber>542028******1323</cardNumber>
    <regionalId>2345679888</regionalId>          </Customer>      <gatewayReference>37585978</gatewayReference>
   <Basket>             <amountInCents>1000</amountInCents>    <information>MASTERCARD</information>
        <currencyCode>ZAR</currencyCode>            <nameOnCard>John <description>Goods<Doe</description>nameOnCard>
          </Basket>      </paymentMethodsUsed>
           <Creditcard     <resultCode>00</resultCode>
       <pmId>DyZ7XBB5QxF5FEoIADAkMCQAUnlDEmIRVXNTa3xUYVUWfEUT</pmId>         <resultMessage>Successful</resultMessage>
   <amountInCents>1000</amountInCents>             <cvv>123</cvv><successful>true</successful>
            </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>             <resultCode>00</resultCode>
            <resultMessage>Successful</resultMessage>
        <return>
   <successful>true</successful>
            <displayMessage>Successful</displayMessage>             <merchantReference>1234567890</merchantReference><fraud>
            <payUReference>21976214819</payUReference>        <resultCode>V039</resultCode>
    <paymentMethodsUsed xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">              <resultMessage>DENY - <amountInCents>1000<0700</amountInCents>resultMessage>
                <cardExpiry>122015<</cardExpiry>fraud>
                <cardNumber>400000******1000</cardNumber><merchantReference>mercRef_1403098545</merchantReference>
                <gatewayReference>37149772<<payUReference>185879181093</gatewayReference>payUReference>
                <information>VISA</information><resultCode>P044</resultCode>
                <resultMessage>Rejected for fraud</resultMessage>
  <nameOnCard>John Doe</nameOnCard>             </paymentMethodsUsed><successful>false</successful>
            </return>
        </ns2:doTransactionResponse>
    </soap:Body>
</soap:Envelope>

Anchor
response_witheBucks_bank_refPAYMENT
response_witheBucks_bank_refPAYMENT

Top

<soap:Envelope xmlns:soap
Code Block
languagexml
titleREQUEST - Credit Card with Token (Save Card) - subsequent request
linenumberstrue
RESPONSE - eBucks (PAYMENT)
linenumberstrue
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:doTransactionResponse xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/">soap.api.controller.web.payjar.com/">
         <return>
            <resultCode>00</resultCode>
            <resultMessage>Successful</resultMessage>
            <successful>true</successful>
    <soap:Body>       <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/"> <displayMessage>Successful</displayMessage>
            <return><merchantReference>1234567890</merchantReference>
            <resultCode>00<<payUReference>21976214819</resultCode>payUReference>
            <resultMessage>Successful</resultMessage><paymentMethodsUsed xsi:type="ns2:ebucks" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <successful>true<<amountInCents>12000</successful>amountInCents>
            <displayMessage>Successful<</displayMessage>paymentMethodsUsed>
         </return>
  <merchantReference>1234567890</merchantReference>    </ns2:doTransactionResponse>
   </soap:Body>
    <payUReference>21976214819</payUReference></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>
        <paymentMethodsUsed xsi:type="ns2:creditCard"<ns2:doTransactionResponse xmlns:xsins2="http://www.w3.org/2001/XMLSchema-instancesoap.api.controller.web.payjar.com/">
         <return>
     <amountInCents>1000</amountInCents>       <merchantReference>EFT_PRO_98453984398</merchantReference>
            <cardExpiry>122015<<payUReference>53390698880</cardExpiry>payUReference>
            <paymentMethodsUsed   <cardNumber>400000******1000</cardNumber>xsi:type="ns2:eft" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <gatewayReference>37149772<<amountInCents>100</gatewayReference>amountInCents>
               <information>VISA</information></paymentMethodsUsed>
            <redirect>
  <nameOnCard>John Doe</nameOnCard>             </paymentMethodsUsed><method>HTTP_GET</method>
             <customFields>  <type>EFT_PRO</type>
             <key>bankReference</key>  <url>http://localhost:8080/PayJarWeb/redirectGet.do?PayUReference=53390698880</url>
             <value>DEMO12<</value>redirect>
            <<successful>true</customFields>successful>
         </return>
       <</ns2:doTransactionResponse>
   </soap:Body>
</soap:Envelope>