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

...

languagexml
titleREQUEST - Credit Card request: PAYMENT or RESERVE
linenumberstrue

...

...

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">
        <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username>
 <soapenv:Body>
      <wsse<soap:PassworddoTransaction Typexmlns:ns2="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes
  soap.api.controller.web.payjar.com/">
         <Api>ONE_ZERO</Api>
         here~~~</wsse:Password><Safekey>{00000000-0000-0000-0000-000000000000}</Safekey>
         </wsse:UsernameToken><TransactionType>PAYMENT/RESERVE</TransactionType>
     </wsse:Security>    <AdditionalInformation>
 </soapenv:Header>     <soapenv:Body>     <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/"> <merchantReference>1234567890</merchantReference>         <Api>ONE_ZERO</Api>  
      <Safekey>~~~SAFEKEY goes here ~~~<</Safekey>AdditionalInformation>
        <TransactionType>~~~a value of<Customer>
PAYMENT or RESERVE~~~</TransactionType>         <AdditionalInformation> <countryCode>27</countryCode>
         <merchantReference>~~~Merchant ref goes here~~~<<countryOfResidence>ZAR</merchantReference>countryOfResidence>
          <notificationUrl>http://example.com/notification-page/</notificationUrl>   <merchantUserId>0123465798</merchantUserId>
     </AdditionalInformation>       <email>john.doe@example.com</email>
 <Customer>           <countryCode>27<<firstName>John</countryCode>firstName>
            <countryOfResidence>ZAR<<lastName>Doe</countryOfResidence>lastName>
            <merchantUserId>0123465798<<mobile>0827777777</merchantUserId>mobile>
            <email>john.doe@example.com</email><regionalId>5612124567897</regionalId>
          <firstName>John<</firstName>Customer>
         <Basket>
<lastName> Doe </lastName>           <mobile>0827777777</mobile>
    <amountInCents>12000</amountInCents> <!-- amount in zar cents -->
     <regionalId>5612124567897</regionalId>       <currencyCode>ZAR</currencyCode>
   <ip>127.0.0.1</ip>      </Basket>
  </Customer>       <Ebucks>
 <Basket>           <amountInCents>12000</amountInCents> <!-- amount in eBucks cents (EB * 10) -->
   <currencyCode>ZAR</currencyCode>      </Ebucks>
    <description>Fraud Basket</description>   <Customfield>
     </Basket>       <key>ebucksOtp</key>
 <Creditcard>           <amountInCents>12000<<value>909059</amountInCents>value>
         </Customfield>
<cardExpiry>122014</cardExpiry>         <Customfield>
 <cardNumber>4111120000005078</cardNumber>           <cvv>123<<key>ebucksAccountNumber</cvv>key>
           <nameOnCard>Fred Fraud<<value>80000278865</nameOnCard>value>
         </Creditcard>Customfield>
      </soap:doTransaction>

   </soapenv:Body>
</soapenv:Envelope>

 

Anchor
fraudfraudrequest_credit
request_credit

Top

Code Block
REQUEST - Credit Card: PAYMENT or RESERVE (with Fraud enabled)
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="1envelope/" xmlns:wssesoap="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
        <wsse:UsernameToken wsu:Id="UsernameToken-9" xmlns:wsusoap.api.controller.web.payjar.com/" xmlns:SOAPENV="http://docsschemas.oasis-openxmlsoap.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsdsoap/envelope/">
        <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username><soapenv:Header>
        <wsse:Security   <wsse:Password TypeSOAP-ENV:mustUnderstand="1" xmlns:wsse="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>/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
       </soapenv:Header>     <soapenv<wsse:Body>
    <soap:doTransactionUsernameToken wsu:Id="UsernameToken-9" xmlns:ns2wsu="http://soapdocs.api.controller.web.payjar.com/oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
        <Api>ONE_ZERO</Api>        <wsse:Username>~~~SOAP <Safekey>~~~SAFEKEYUsername goes here ~~~</Safekey>here~~~</wsse:Username>
        <TransactionType>~~~a value of PAYMENT or RESERVE~~~</TransactionType>         <AdditionalInformation>
          <deviceId>TERM003</deviceId>
 <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes
        <merchantReference>~~~Merchant ref goes here ~~~</merchantReference>here~~~</wsse:Password>
           <notificationUrl> http://example.com/notification-page/</notificationUrl>wsse:UsernameToken>
        </AdditionalInformation>wsse:Security>
    </soapenv:Header>
   <Customer> <soapenv:Body>
         <countryCode>27</countryCode><soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">
          <countryOfResidence>ZAR</countryOfResidence>  <Api>ONE_ZERO</Api>
        <merchantUserId>0123465798</merchantUserId>        <Safekey>~~~SAFEKEY goes here <email>john.doe@example.com</email>~~~</Safekey>
            <firstName>John<<TransactionType>CREDIT</firstName>TransactionType>
          <lastName> Doe </lastName><AdditionalInformation>
          <mobile>0827777777</mobile>      <merchantReference>~~~Merchant ref goes here ~~~</merchantReference>
<regionalId>5612124567897</regionalId>           <ip>127.0.0.1</ip>     <payUReference>~~~PayU ref goes here <~~~</Customer>payUReference>
        <Basket>    </AdditionalInformation>
      <amountInCents>12000</amountInCents>      <Basket>
    <currencyCode>ZAR</currencyCode>           <description>Fraud Basket</description><amountInCents>1000</amountInCents>
               <!--Zero or more repetitions:--> <currencyCode>ZAR</currencyCode>
            </Basket>
<productLineItem>        </soap:doTransaction>
    </soapenv:Body>
 <amount>10000</amount></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>
          <costAmount>1000</costAmount><ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
         <return>
    <description>Product 1</description>               <giftMessage>Happy Birthday</giftMessage><resultCode>00</resultCode>
              <productCode>ABC0002<<resultMessage>Successful</productCode>resultMessage>
              <quantity>1<<successful>true</quantity>successful>
              <recipientAddress1>21 Example Road</recipientAddress1><displayMessage>Successful</displayMessage>
              <recipientCity>Cape Town</recipientCity><merchantReference>1234567890</merchantReference>
              <recipientCountryCode>ZAR<<payUReference>21976214819</recipientCountryCode>payUReference>
            <paymentMethodsUsed  <recipientPostalCode>8000</recipientPostalCode>xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <recipientFirstName>John<<amountInCents>1000</recipientFirstName>amountInCents>
               <recipientLastName>Doe<<cardExpiry>122015</recipientLastName>cardExpiry>
          </productLineItem>     <cardNumber>400000******1000</cardNumber>
     <shippingDetails>          <gatewayReference>37149772</gatewayReference>
    <shippingAddress1>21 Example Road</shippingAddress1>          <information>VISA</information>
    <shippingAddressCity>Cape Town </shippingAddressCity>         <nameOnCard>John Doe</nameOnCard>
    <shippingEmail> john.doe@example.com </shippingEmail>       </paymentMethodsUsed>
         <shippingCountryCode>ZAR<</shippingCountryCode>return>
      </ns2:doTransactionResponse>
   </soap:Body>
</soap:Envelope>
  <shippingStateCode>WC</shippingStateCode>

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>
         <shippingMethod>P</shippingMethod>
              <shppingFirstName>John</shppingFirstName>
              <shippingLastName>Doe</shippingLastName><ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
        <return>
     <shippingFax>27214688020</shippingFax>shippingFax>               <shippingPhone>27214688021</shippingPhone>
   <displayMessage>Transaction Pending 3DS Completion</displayMessage>
      </shippingDetails>      <fraud>
  </Basket>         <Fraud>     <resultCode>V030</resultCode>
     <checkFraudOverride>false</checkFraudOverride>           <merchantWebSite>http://www.example.com/ </merchantWebSite><resultMessage>Success</resultMessage>
            <pcFingerPrint>owhjiflkwhefqwoaef<</pcFingerPrint>fraud>
         </Fraud>   <merchantReference>0123456789</merchantReference>
     <Creditcard>       <payUReference>31982857915</payUReference>
   <amountInCents>12000</amountInCents>         <paymentMethodsUsed  <cardExpiry>122014</cardExpiry>xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
          <cardNumber>4111120000005078</cardNumber>       <amountInCents>350</amountInCents>
    <cvv>123</cvv>           <nameOnCard>Fred Fraud<<cardExpiry>092014</nameOnCard>cardExpiry>
          <verified/>      <cardNumber>456546******6016</cardNumber>
  </Creditcard>     </soap:doTransaction>     </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� >  <gatewayReference>37117846</gatewayReference>
       <AdditionalInformation>         <merchantReference>CJR001<<information>VISA</merchantReference>information>
    </AdditionalInformation>     <Customer>       <nameOnCard>Jon Doe <mobile>27827891249</mobile></nameOnCard>
            </Customer>paymentMethodsUsed>
          <Basket>  <resultCode>P3DS</resultCode>
      <amountInCents>1000</amountInCents>      <resultMessage>Transaction Pending 3DS <currencyCode>ZAR</currencyCode>Completion</resultMessage>
            <secure3D>
   <description>ORD111</description>     </Basket>     <PaymentMethods>   <secure3DId>A5ufG1Q3sp3qGDxu5de3</secure3DId>
     <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 <secure3DUrl><![CDATA[<form name="downloadForm" action="http://soapacstest.apibankserv.controller.web.payjar.com/co.za/V3DSStart?osb=visa-3&VAA=B"
                method="POST">
                <table name="dataTable" border="0" cellpadding="0">
    <soapenv:Header/>     <soapenv:Body>       <INPUT  <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">
TYPE="hidden" NAME="TransactionID" value="A5ufG1Q3sp3qGDxu5de3">
           <Api>ONE_ZERO</Api>     <INPUT        <Safekey>{86903CCB-79A9-42EE-0174-1ACE90185507}</Safekey>TYPE="hidden" NAME="PaReq"
            <TransactionType>PAYMENT</TransactionType>         value="eNpVUtty2jAQfddXeNLHzliWbWzCLJohgZSkTbik0yZ9E2IpLmCD5Av46ys5dtK+nbO7Wp2zu/B9qxDHzygLhRweUWvxG51kPbyanrP463K3Ci7ZTL
   <AuthenticationType>NA</AuthenticationType>             <AdditionalInformation>zOskX5ebp5qR/Efje84jAfLfHEoUSlkyzlzPVcH2hHiWml5FakOQchTzf3TzzqhYHPgLaUwAHV/ZgzPwh7UdwH+sYJpOKA/EakO42qHG1UIoXTdQPaZAnIrEh
                <merchantReference>MerchRef001</merchantReference>zdeEx84B2hECh9nyb58cBpVVVuau2iysztxZAbZoA/dA2LyzSxvo5WfM48Ov56+IJy9XPu/GPSzkZf9Gnl9vq2+MQqK0gsBY5ct9jgdf3fIdFg9AbMGOriRMQ
                <supportedPaymentMethods>CREDITCARD</supportedPaymentMethods>B6uFLwO3Z4S1jMDR/jN6Y4HN/BswbgqlMJWdnY4RwPMxS9HUmNm+YyMCteSZWqNyPjlBzFjcDyOjwYYJJKnOxX5v33TQmP6weju1S5G5mfadCPWsno
                <storePaymentMethod>true</storePaymentMethod>pZdP0QqF/qz3GyQb+q88XEbqqpaVQkZrws9K4bGUkza2r70PYOaHs6Bv13Un8BvvXHsA==">
               </AdditionalInformation> <INPUT TYPE="hidden" NAME="TermUrl" VALUE="http://staging.safeshop.co.za/s2s/Secure3D/Encode_Finish.asp">
        <Customer>        <INPUT TYPE="hidden" NAME="MD" VALUE="37117846">
     <countryCode>27</countryCode>                 <merchantUserId>MechUser001</merchantUserId></table>
                <email>name.surname@mail.com</email>
        <center><p><font type="Arial" size=2>Transfering to your bank for credit card authentication.
       <firstName>Name</firstName>         <p> If you are not redirected please  <lastName>Surname</lastName>
                <mobile>27887592452</mobile><a href="javascript:AutoSubmitForm()">click here</a> on the image to continue to access your banking
                <regionalId>2345679888</regionalId>institution.<p>
            </Customer>    <input type="image" src="http://staging.images.safeshop.co.za/PaymentMethods/Secure3D/VbyV_blue_120x69.gif" name="continue"
     <Basket>                 <amountInCents>1000</amountInCents>value="Continue"></center>
                <currencyCode>ZAR<</currencyCode>form>
                 <description>Goods</description><script language="Javascript">
             </Basket>   <!--
         <Creditcard>       function AutoSubmitForm() {document.downloadForm.submit();
       <amountInCents>1000</amountInCents>         }
       <cardExpiry>122013</cardExpiry>         AutoSubmitForm();
       <cardNumber>5111120000091349</cardNumber>         //--></script>]]></secure3DUrl>
       <cvv>123</cvv>         </secure3D>
       <nameOnCard>N Surname</nameOnCard>    <successful>true</successful>
        </Creditcard>
   return>
    </soapns2:doTransaction>doTransactionResponse>
    </soapenvsoap:Body>
</soapenvsoap:Envelope>

save_card_2
Anchor
save_card_2
response_with_bank_ref
response_with_bank_ref

Top

<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
Code Block
languagexml
titleCredit Card with Token (Save Card) Subsequent REQUEST:
linenumberstrue
RESPONSE - Credit Card: PAYMENT or RESERVE (with bank reference)
linenumberstrue
<soap:Envelope xmlns:soap="http://soapschemas.api.controller.web.payjar.com/">
         <Api>ONE_ZERO</Api>
         <Safekey>{86903CCB-79A9-42EE-0174-1ACE90185507}</Safekey>
  xmlsoap.org/soap/envelope/">
   <soap:Body>
      <TransactionType>PAYMENT</TransactionType><ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
         <AuthenticationType>TOKEN</AuthenticationType><return>
         <AdditionalInformation>   <resultCode>00</resultCode>
       <merchantReference>MerchRef001</merchantReference>     <resultMessage>Successful</resultMessage>
     <supportedPaymentMethods>CREDITCARD</supportedPaymentMethods>       <successful>true</successful>
  </AdditionalInformation>          <Customer><displayMessage>Successful</displayMessage>
            <countryCode>27<<merchantReference>1234567890</countryCode>merchantReference>
            <merchantUserId>MechUser001<<payUReference>21976214819</merchantUserId>payUReference>
            <paymentMethodsUsed  <email>name.surname@mail.com</email>xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <firstName>Name</firstName>   <amountInCents>1000</amountInCents>
         <lastName>Surname</lastName>       <cardExpiry>122015</cardExpiry>
     <mobile>27887592452</mobile>          <cardNumber>400000******1000</cardNumber>
  <regionalId>2345679888</regionalId>          </Customer>   <gatewayReference>37149772</gatewayReference>
      <Basket>         <information>VISA</information>
   <amountInCents>1000</amountInCents>            <nameOnCard>John <currencyCode>ZAR<Doe</currencyCode>nameOnCard>
            <description>Goods<</description>
paymentMethodsUsed> 
        </Basket>    <customFields>
             <Creditcard      <key>bankReference</key>
      <pmId>DyZ7XBB5QxF5FEoIADAkMCQAUnlDEmIRVXNTa3xUYVUWfEUT</pmId>             <amountInCents>1000</amountInCents><value>DEMO12</value>
            <cvv>123<</cvv>customFields>
         </Creditcard>return>
      < </soapns2:doTransaction>doTransactionResponse>
   </soapenvsoap:Body>
</soapenvsoap:Envelope>

Anchor
response_withoutwith_bankfraud_refapprove
response_withoutwith_bankfraud_refapprove

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>
        <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
         <return>    <return>
        <resultCode>00</resultCode>             <resultMessage>Successful</resultMessage><displayMessage>Successful</displayMessage>
            <successful>true</successful>    <fraud>
        <displayMessage>Successful</displayMessage>             <merchantReference>1234567890</merchantReference>
       <resultCode>V030</resultCode>
    <payUReference>21976214819</payUReference>             <paymentMethodsUsed xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">   <resultMessage>Success</resultMessage>
                <amountInCents>1000<</amountInCents>fraud>
                <cardExpiry>122015</cardExpiry><merchantReference>mercRef_1403097874</merchantReference>
                <cardNumber>400000******1000</cardNumber><payUReference>185871924286</payUReference>
                <gatewayReference>37149772</gatewayReference><paymentMethodsUsed xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns2:creditCard">
               <information>VISA</information>     <amountInCents>2156</amountInCents>
          <nameOnCard>John Doe</nameOnCard>         <cardExpiry>012015</cardExpiry>
   </paymentMethodsUsed>          </return>       </ns2:doTransactionResponse><cardNumber>542028******1323</cardNumber>
      </soap:Body> </soap:Envelope>

...

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/">             <gatewayReference>37585977</gatewayReference>
              <soap:Body>     <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/"> <information>MASTERCARD</information>
         <return>           <nameOnCard>John Doe</nameOnCard>
<displayMessage>Transaction Pending 3DS Completion</displayMessage>             <fraud></paymentMethodsUsed>
                <resultCode>V030<<resultCode>00</resultCode>
                <resultMessage>Success<<resultMessage>Successful</resultMessage>
            </fraud>    <successful>true</successful>
        <merchantReference>0123456789</merchantReference>    </return>
        <payUReference>31982857915<</payUReference>ns2:doTransactionResponse>
    </soap:Body>
       <paymentMethodsUsed xsi:type="ns2:creditCard" xmlns:xsi</soap:Envelope>

Anchor
response_with_fraud_challenge
response_with_fraud_challenge

Top

Code Block
languagexml
titleRESPONSE - Credit Card: PAYMENT or RESERVE (with Fraud enabled - CHALLENGE)
linenumberstrue
<soap:Envelope xmlns:soap="http://wwwschemas.w3xmlsoap.org/2001/XMLSchema-instancesoap/envelope/">
    <soap:Body>
           <amountInCents>350</amountInCents>
                <cardExpiry>092014</cardExpiry><ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
                <cardNumber>456546******6016</cardNumber><return>
                <gatewayReference>37117846<<displayMessage>Successful</gatewayReference>displayMessage>
                <fraud>
 <information>VISA</information>                 <nameOnCard>Jon Doe <<resultCode>V035</nameOnCard>resultCode>
              </paymentMethodsUsed>      <resultMessage>CHALLENGE - 0330</resultMessage>
    <resultCode>P3DS</resultCode>            </fraud>
<resultMessage>Transaction Pending 3DS Completion</resultMessage>             <secure3D><merchantReference>mercRef_1403098425</merchantReference>
                <secure3DId>A5ufG1Q3sp3qGDxu5de3<<payUReference>185878360665</secure3DId>payUReference>
                <secure3DUrl><![CDATA[<form name="downloadForm" action<paymentMethodsUsed xmlns:xsi="http://acstestwww.bankserv.co.za/V3DSStart?osb=visa-3&VAA=B"w3.org/2001/XMLSchema-instance" xsi:type="ns2:creditCard">
                    <amountInCents>7215</amountInCents>
       method="POST">             <cardExpiry>012015</cardExpiry>
   <table name="dataTable" border="0" cellpadding="0">              <cardNumber>542028******1323</cardNumber>
  <INPUT TYPE="hidden" NAME="TransactionID" value="A5ufG1Q3sp3qGDxu5de3">               <gatewayReference>37585978</gatewayReference>
 <INPUT TYPE="hidden" NAME="PaReq"                 value="eNpVUtty2jAQfddXeNLHzliWbWzCLJohgZSkTbik0yZ9E2IpLmCD5Av46ys5dtK+nbO7Wp2zu/B9qxDHzygLhRweUWvxG51kPbyanrP463K3Ci7ZTL<information>MASTERCARD</information>
                    zOskX5ebp5qR/Efje84jAfLfHEoUSlkyzlzPVcH2hHiWml5FakOQchTzf3TzzqhYHPgLaUwAHV/ZgzPwh7UdwH+sYJpOKA/EakO42qHG1UIoXTdQPaZAnIrEh<nameOnCard>John Doe</nameOnCard>
                zdeEx84B2hECh9nyb58cBpVVVuau2iysztxZAbZoA/dA2LyzSxvo5WfM48Ov56+IJy9XPu/GPSzkZf9Gnl9vq2+MQqK0gsBY5ct9jgdf3fIdFg9AbMGOriRMQ</paymentMethodsUsed>
                B6uFLwO3Z4S1jMDR/jN6Y4HN/BswbgqlMJWdnY4RwPMxS9HUmNm+YyMCteSZWqNyPjlBzFjcDyOjwYYJJKnOxX5v33TQmP6weju1S5G5mfadCPWsno<resultCode>00</resultCode>
                pZdP0QqF/qz3GyQb+q88XEbqqpaVQkZrws9K4bGUkza2r70PYOaHs6Bv13Un8BvvXHsA=="><resultMessage>Successful</resultMessage>
                <INPUT TYPE="hidden" NAME="TermUrl" VALUE="http://staging.safeshop.co.za/s2s/Secure3D/Encode_Finish.asp">
  <successful>true</successful>
            </return>
        </ns2:doTransactionResponse>
    <INPUT TYPE="hidden" NAME="MD" VALUE="37117846</soap:Body>
</soap:Envelope>

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>
           </table><ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
                <center><p><font type="Arial" size=2>Transfering to your bank for credit card authentication.<return>
                <fraud>
      <p> If you are not redirected please <a href="javascript:AutoSubmitForm()">click here</a> on the image to continue<resultCode>V039</resultCode>
to access your banking                 institution.<p><resultMessage>DENY - 0700</resultMessage>
              <input type="image" src="http://staging.images.safeshop.co.za/PaymentMethods/Secure3D/VbyV_blue_120x69.gif" name="continue" </fraud>
                value="Continue"></center><merchantReference>mercRef_1403098545</merchantReference>
                <<payUReference>185879181093</form>payUReference>
                <script language="Javascript"><resultCode>P044</resultCode>
                <resultMessage>Rejected <!--
for fraud</resultMessage>
               function AutoSubmitForm() {document.downloadForm.submit(); <successful>false</successful>
            </return>
    }    </ns2:doTransactionResponse>
    </soap:Body>
       AutoSubmitForm();
</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>
           //--></script>]]></secure3DUrl><ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
         <return>
      </secure3D>         <resultCode>00</resultCode>
   <successful>true</successful>         <<resultMessage>Successful</return>resultMessage>
    </ns2:doTransactionResponse>     </soap:Body> </soap:Envelope>

...

Top

Code Block
languagexml
titleREQUEST - Credit Card with Token (Save Card) - subsequent request
linenumberstrue
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">  <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</resultCode><payUReference>21976214819</payUReference>
            <paymentMethodsUsed xsi:type="ns2:ebucks" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
     <resultMessage>Successful</resultMessage>             <successful>true</successful><amountInCents>12000</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>

...