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>
        <wsse:UsernameToken wsu:Id="UsernameToken-9" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> </productLineItem>
          <shippingDetails>
              <shippingAddress1>21 Example Road</shippingAddress1>
             <wsse:Username>~~~SOAP Username<shippingAddressCity>Cape goesTown here~~~</wsse:Username></shippingAddressCity>
              <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes<shippingEmail> john.doe@example.com </shippingEmail>
              <shippingCountryCode>ZAR</shippingCountryCode>
              here~~~</wsse:Password><shippingStateCode>WC</shippingStateCode>
              <<shippingMethod>P</wsse:UsernameToken>shippingMethod>
    </wsse:Security>     </soapenv:Header>     <soapenv:Body><shppingFirstName>John</shppingFirstName>
    <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">         <Api>ONE_ZERO</Api><shippingLastName>Doe</shippingLastName>
         <Safekey>~~~SAFEKEY goes here ~~~</Safekey>  <shippingFax>27214688020</shippingFax>shippingFax>
      <TransactionType>~~~a value of PAYMENT or RESERVE~~~</TransactionType>   <shippingPhone>27214688021</shippingPhone>
     <AdditionalInformation>     </shippingDetails>
     <merchantReference>~~~Merchant ref goes here~~~<</merchantReference>Basket>
        <Fraud>
 <notificationUrl>http://example.com/notification-page/</notificationUrl>         <<checkFraudOverride>false</AdditionalInformation>checkFraudOverride>
         <Customer>
  <merchantWebSite>http://www.example.com/ </merchantWebSite>
        <countryCode>27</countryCode>  <pcFingerPrint>owhjiflkwhefqwoaef</pcFingerPrint>
        <countryOfResidence>ZAR<</countryOfResidence>Fraud>
        <Creditcard>
 <merchantUserId>0123465798</merchantUserId>           <email>john.doe@example.com</email><amountInCents>12000</amountInCents>
          <firstName>John<<cardExpiry>122014</firstName>cardExpiry>
          <lastName> Doe </lastName><cardNumber>4111120000005078</cardNumber>
          <mobile>0827777777<<cvv>123</mobile>cvv>
          <regionalId>5612124567897<<nameOnCard>Fred Fraud</regionalId>nameOnCard>
          <ip>127.0.0.1</ip><verified/>
        </Customer>Creditcard>
    </soap:doTransaction>
   <Basket>
    </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>
  <amountInCents>12000</amountInCents>      <merchantReference>CJR001</merchantReference>
    <currencyCode>ZAR<</currencyCode>AdditionalInformation>
    <Customer>
     <description>Fraud Basket</description>  <mobile>27827891249</mobile>
      </Basket>Customer>
    <Basket>
   <Creditcard>           <amountInCents>12000<<amountInCents>1000</amountInCents>
          <cardExpiry>122014<<currencyCode>ZAR</cardExpiry>currencyCode>
          <cardNumber>4111120000005078<<description>ORD111</cardNumber>description>
          <cvv>123</cvv></Basket>
    <PaymentMethods>
     <nameOnCard>Fred Fraud</nameOnCard>  <CreditCard pmID="jh23d29832jhdo23hu"      </Creditcard>
    </soap:doTransaction>CVV=�123� AmountInCents="2300" />
    </soapenv:Body>PaymentMethods>
</soapenv:Envelope>

 

...

DoTransaction>

Anchor
save_card_1
save_card_1

 

Top

Code Block
languagexml
titleREQUEST - Credit Card: PAYMENT or RESERVE (with Fraud enabledeBucks (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/">
    <soapenv:Header>
    <wsse:Security SOAP-ENV:mustUnderstand="1/" xmlns:wsseSOAPENV="http://docsschemas.oasis-openxmlsoap.org/wsssoap/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsdenvelope/" xmlns:SOAP-ENV="SOAP-ENV">
      <soapenv:Body>
     <wsse:UsernameToken wsu:Id="UsernameToken-9"<soap:doTransaction xmlns:wsuns2="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">soap.api.controller.web.payjar.com/">
          <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username><Api>ONE_ZERO</Api>
         <Safekey>{00000000-0000-0000-0000-000000000000}</Safekey>
        <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes <TransactionType>PAYMENT/RESERVE</TransactionType>
         <AdditionalInformation>
            here~~~</wsse:Password><merchantReference>1234567890</merchantReference>           </wsse:UsernameToken>
    </wsse:Security>     </soapenv:Header>AdditionalInformation>
       <soapenv:Body>  <Customer>
  <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">         <Api>ONE_ZERO</Api><countryCode>27</countryCode>
         <Safekey>~~~SAFEKEY goes here ~~~<<countryOfResidence>ZAR</Safekey>countryOfResidence>
        <TransactionType>~~~a value of PAYMENT or RESERVE~~~<<merchantUserId>0123465798</TransactionType>merchantUserId>
        <AdditionalInformation>    <email>john.doe@example.com</email>
      <deviceId>TERM003</deviceId>      <firstName>John</firstName>
    <merchantReference>~~~Merchant ref goes here ~~~</merchantReference>    <lastName>Doe</lastName>
      <notificationUrl> http://example.com/notification-page/</notificationUrl>     <mobile>0827777777</mobile>
   </AdditionalInformation>         <Customer><regionalId>5612124567897</regionalId>
         </Customer>
<countryCode>27</countryCode>         <Basket>
 <countryOfResidence>ZAR</countryOfResidence>           <merchantUserId>0123465798<<amountInCents>12000</merchantUserId>amountInCents> <!-- amount in zar cents -->
    <email>john.doe@example.com</email>           <firstName>John</firstName>
<currencyCode>ZAR</currencyCode>
         <lastName> Doe </lastName>Basket>
         <Ebucks>
 <mobile>0827777777</mobile>           <regionalId>5612124567897<<amountInCents>12000</regionalId>amountInCents> <!-- amount in eBucks cents (EB * 10)   <ip>127.0.0.1</ip>-->
         </Customer>Ebucks>
        <Customfield>
 <Basket>           <amountInCents>12000<<key>ebucksOtp</amountInCents>key>
            <currencyCode>ZAR</currencyCode><value>909059</value>
         </Customfield>
    <description>Fraud Basket</description>    <Customfield>
      <!--Zero or more repetitions:-->   <key>ebucksAccountNumber</key>
       <productLineItem>     <value>80000278865</value>
         <amount>10000<</amount>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/"  <costAmount>1000</costAmount>xmlns:soap="http://soap.api.controller.web.payjar.com/" xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Header>
         <description>Product 1</description>
              <giftMessage>Happy Birthday</giftMessage><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  <productCode>ABC0002</productCode>
              <quantity>1</quantity>
              <recipientAddress1>21 Example Road</recipientAddress1>wsu:Id="UsernameToken-9" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
              <recipientCity>Cape Town</recipientCity> <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username>
          <recipientCountryCode>ZAR</recipientCountryCode>      <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes
     <recipientPostalCode>8000</recipientPostalCode>       here~~~</wsse:Password>
       <recipientFirstName>John</recipientFirstName>     </wsse:UsernameToken>
         <recipientLastName>Doe</recipientLastName></wsse:Security>
    </soapenv:Header>
    <soapenv:Body>
</productLineItem>        <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">
 <shippingDetails>           <Api>ONE_ZERO</Api>
   <shippingAddress1>21 Example Road</shippingAddress1>       <Safekey>~~~SAFEKEY goes here ~~~</Safekey>
    <shippingAddressCity>Cape Town </shippingAddressCity>      <TransactionType>CREDIT</TransactionType>
        <shippingEmail> john.doe@example.com </shippingEmail>  <AdditionalInformation>
            <shippingCountryCode>ZAR</shippingCountryCode>    <merchantReference>~~~Merchant ref goes here ~~~</merchantReference>
      <shippingStateCode>WC</shippingStateCode>           <payUReference>~~~PayU ref goes here <shippingMethod>P<~~~</shippingMethod>
payUReference>
             <shppingFirstName>John<</shppingFirstName>AdditionalInformation>
            <Basket>
 <shippingLastName>Doe</shippingLastName>               <shippingFax>27214688020<<amountInCents>1000</shippingFax>shippingFax>amountInCents>
              <shippingPhone>27214688021</shippingPhone>  <currencyCode>ZAR</currencyCode>
        </shippingDetails>         </Basket>
        <Fraud></soap:doTransaction>
    </soapenv:Body>
</soapenv:Envelope>

 

Anchor
response_without_bank_ref
response_without_bank_ref

Top

Code Block
languagexml
titleRESPONSE - Credit Card: PAYMENT or RESERVE
linenumberstrue
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
<checkFraudOverride>false</checkFraudOverride>           <merchantWebSite>http<ns2:doTransactionResponse xmlns:ns2="http://www.examplesoap.api.controller.web.payjar.com/">
</merchantWebSite>         <return>
 <pcFingerPrint>owhjiflkwhefqwoaef</pcFingerPrint>         </Fraud>  <resultCode>00</resultCode>
      <Creditcard>      <resultMessage>Successful</resultMessage>
    <amountInCents>12000</amountInCents>           <cardExpiry>122014</cardExpiry>
          <cardNumber>4111120000005078</cardNumber><successful>true</successful>
            <cvv>123<<displayMessage>Successful</cvv>displayMessage>
           <nameOnCard>Fred Fraud<<merchantReference>1234567890</nameOnCard>merchantReference>
            <verified<payUReference>21976214819</>payUReference>
        </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� ><paymentMethodsUsed xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <amountInCents>1000</amountInCents>
      <AdditionalInformation>         <merchantReference>CJR001</merchantReference><cardExpiry>122015</cardExpiry>
               </AdditionalInformation><cardNumber>400000******1000</cardNumber>
            <Customer>   <gatewayReference>37149772</gatewayReference>
     <mobile>27827891249</mobile>     </Customer>     <Basket><information>VISA</information>
        <amountInCents>1000</amountInCents>       <nameOnCard>John  <currencyCode>ZAR<Doe</currencyCode>nameOnCard>
        <description>ORD111</description>     </Basket>paymentMethodsUsed>
    <PaymentMethods>     </return>
   <CreditCard pmID="jh23d29832jhdo23hu" CVV=�123� AmountInCents="2300" />
 </ns2:doTransactionResponse>
   </PaymentMethods>soap:Body>
</DoTransaction>soap:Envelope>

Anchor
saveresponse_cardwith_13Dsave
response_cardwith_13D

Top

<soapenv
Code Block
languagexml
titleREQUEST RESPONSE - Credit Card with Token (Save Card) - first request
linenumberstrue
: PAYMENT or RESERVE (with 3D Secure enabled - card enrolled)
<soap:Envelope xmlns:soapenvsoap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.api.controller.web.payjar.com/">
    <soapenv:Header/>
    <soapenv<soap:Body>
        <soap:doTransaction<ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
 
          <Api>ONE_ZERO</Api>
            <Safekey>{86903CCB-79A9-42EE-0174-1ACE90185507}</Safekey>
 <return>
           <TransactionType>PAYMENT</TransactionType> <displayMessage>Transaction Pending 3DS Completion</displayMessage>
        <AuthenticationType>NA</AuthenticationType>    <fraud>
        <AdditionalInformation>        <resultCode>V030</resultCode>
        <merchantReference>MerchRef001</merchantReference>        <resultMessage>Success</resultMessage>
        <supportedPaymentMethods>CREDITCARD</supportedPaymentMethods>    </fraud>
            <storePaymentMethod>true<<merchantReference>0123456789</storePaymentMethod>merchantReference>
            <<payUReference>31982857915</AdditionalInformation>payUReference>
            <paymentMethodsUsed  <Customer>xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <countryCode>27<<amountInCents>350</countryCode>amountInCents>
                <merchantUserId>MechUser001<<cardExpiry>092014</merchantUserId>cardExpiry>
                <email>name.surname@mail.com</email><cardNumber>456546******6016</cardNumber>
                <firstName>Name<<gatewayReference>37117846</firstName>gatewayReference>
                <lastName>Surname<<information>VISA</lastName>information>
                <mobile>27887592452</mobile><nameOnCard>Jon Doe </nameOnCard>
            </paymentMethodsUsed>
 <regionalId>2345679888</regionalId>           <resultCode>P3DS</resultCode>
 </Customer>           <resultMessage>Transaction Pending <Basket>3DS Completion</resultMessage>
            <secure3D>
  <amountInCents>1000</amountInCents>              <secure3DId>A5ufG1Q3sp3qGDxu5de3</secure3DId>
  <currencyCode>ZAR</currencyCode>              <secure3DUrl><![CDATA[<form name="downloadForm"  <description>Goods</description>action="http://acstest.bankserv.co.za/V3DSStart?osb=visa-3&VAA=B"
             </Basket>   method="POST">
         <Creditcard>       <table name="dataTable" border="0" cellpadding="0">
      <amountInCents>1000</amountInCents>          <INPUT TYPE="hidden" NAME="TransactionID" value="A5ufG1Q3sp3qGDxu5de3">
   <cardExpiry>122013</cardExpiry>             <INPUT TYPE="hidden" NAME="PaReq"
 <cardNumber>5111120000091349</cardNumber>               value="eNpVUtty2jAQfddXeNLHzliWbWzCLJohgZSkTbik0yZ9E2IpLmCD5Av46ys5dtK+nbO7Wp2zu/B9qxDHzygLhRweUWvxG51kPbyanrP463K3Ci7ZTL
 <cvv>123</cvv>               zOskX5ebp5qR/Efje84jAfLfHEoUSlkyzlzPVcH2hHiWml5FakOQchTzf3TzzqhYHPgLaUwAHV/ZgzPwh7UdwH+sYJpOKA/EakO42qHG1UIoXTdQPaZAnIrEh
 <nameOnCard>N Surname</nameOnCard>              </Creditcard>zdeEx84B2hECh9nyb58cBpVVVuau2iysztxZAbZoA/dA2LyzSxvo5WfM48Ov56+IJy9XPu/GPSzkZf9Gnl9vq2+MQqK0gsBY5ct9jgdf3fIdFg9AbMGOriRMQ
        </soap:doTransaction>     </soapenv:Body> </soapenv:Envelope>

...

Top

Code Block
languagexml
titleCredit Card with Token (Save Card) Subsequent 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> B6uFLwO3Z4S1jMDR/jN6Y4HN/BswbgqlMJWdnY4RwPMxS9HUmNm+YyMCteSZWqNyPjlBzFjcDyOjwYYJJKnOxX5v33TQmP6weju1S5G5mfadCPWsno
                pZdP0QqF/qz3GyQb+q88XEbqqpaVQkZrws9K4bGUkza2r70PYOaHs6Bv13Un8BvvXHsA==">
                <INPUT  <soap:doTransaction xmlns:ns2TYPE="hidden" NAME="TermUrl" VALUE="http://soapstaging.apisafeshop.controller.web.payjar.com/co.za/s2s/Secure3D/Encode_Finish.asp">
         <Api>ONE_ZERO</Api>       <INPUT TYPE="hidden"  <Safekey>{86903CCB-79A9-42EE-0174-1ACE90185507}</Safekey>NAME="MD" VALUE="37117846">
            <TransactionType>PAYMENT</TransactionType>    </table>
     <AuthenticationType>TOKEN</AuthenticationType>          <AdditionalInformation> <center><p><font type="Arial" size=2>Transfering to your bank for credit card authentication.
<merchantReference>MerchRef001</merchantReference>           <supportedPaymentMethods>CREDITCARD</supportedPaymentMethods>     <p> If you are not </AdditionalInformation>redirected please <a href="javascript:AutoSubmitForm()">click here</a> on the image to continue <Customer>to access your banking
         <countryCode>27</countryCode>       institution.<p>
     <merchantUserId>MechUser001</merchantUserId>           <input  <email>name.surname@mail.com</email>
type="image" src="http://staging.images.safeshop.co.za/PaymentMethods/Secure3D/VbyV_blue_120x69.gif" name="continue"
           <firstName>Name</firstName>             <lastName>Surname</lastName>value="Continue"></center>
            <mobile>27887592452</mobile>    </form>
        <regionalId>2345679888</regionalId>        <script  </Customer>language="Javascript">
          <Basket>      <!--
      <amountInCents>1000</amountInCents>          function AutoSubmitForm()  <currencyCode>ZAR</currencyCode>{document.downloadForm.submit();
             <description>Goods</description>   }
       </Basket>         AutoSubmitForm();
        <Creditcard        //--></script>]]></secure3DUrl>
    <pmId>DyZ7XBB5QxF5FEoIADAkMCQAUnlDEmIRVXNTa3xUYVUWfEUT</pmId>             <amountInCents>1000<</amountInCents>secure3D>
            <cvv>123<<successful>true</cvv>successful>
         </Creditcard>return>
      </soapns2:doTransaction>doTransactionResponse>
    </soapenvsoap:Body>
</soapenvsoap:Envelope>

Anchor
request_creditrequest_creditresponse_with_bank_ref
response_with_bank_ref

Top

Code Block
languagexml
titleREQUEST - Crediting a transactionRESPONSE - Credit Card: PAYMENT or RESERVE (with bank reference)
linenumberstrue
<soapenv<soap:Envelope xmlns:soapenvsoap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:doTransactionResponse xmlns:soapns2="http://soap.api.controller.web.payjar.com/" xmlns:SOAPENV=".com/">
         <return>
            <resultCode>00</resultCode>
            http://schemas.xmlsoap.org/soap/envelope/"><resultMessage>Successful</resultMessage>
            <successful>true</successful>
            <displayMessage>Successful</displayMessage>
    <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">  <merchantReference>1234567890</merchantReference>
            <payUReference>21976214819</payUReference>
            <wsse:UsernameToken<paymentMethodsUsed wsuxsi:Idtype="UsernameToken-9ns2:creditCard" xmlns:wsuxsi="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsdwww.w3.org/2001/XMLSchema-instance">
        <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      <cardExpiry>122015</cardExpiry>
      here~~~</wsse:Password>         </wsse:UsernameToken><cardNumber>400000******1000</cardNumber>
    </wsse:Security>     </soapenv:Header>     <soapenv:Body> <gatewayReference>37149772</gatewayReference>
   <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">         <Api>ONE_ZERO</Api>    <information>VISA</information>
    <Safekey>~~~SAFEKEY goes here ~~~</Safekey>        <nameOnCard>John <TransactionType>CREDIT<Doe</TransactionType>nameOnCard>
        <AdditionalInformation>    </paymentMethodsUsed> 
   <merchantReference>~~~Merchant  ref goes here ~~~</merchantReference>    <customFields>
    <payUReference>~~~PayU ref goes here ~~~</payUReference>       <key>bankReference</key>
 </AdditionalInformation>         <Basket>     <value>DEMO12</value>
   <amountInCents>1000</amountInCents>         <currencyCode>ZAR<</currencyCode>customFields>
         </Basket>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</paymentMethodsUsed>cardExpiry>
         </return>       </ns2:doTransactionResponse>    </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/"><cardNumber>542028******1323</cardNumber>
                    <gatewayReference>37585977</gatewayReference>
              <soap:Body>     <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/"> <information>MASTERCARD</information>
        <return>            <nameOnCard>John <displayMessage>TransactionDoe</nameOnCard>
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">
                   method="POST"> <amountInCents>7215</amountInCents>
                    <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>
                    <nameOnCard>John zOskX5ebp5qR/Efje84jAfLfHEoUSlkyzlzPVcH2hHiWml5FakOQchTzf3TzzqhYHPgLaUwAHV/ZgzPwh7UdwH+sYJpOKA/EakO42qHG1UIoXTdQPaZAnIrEhDoe</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>
         <INPUT TYPE="hidden" NAME="MD" VALUE="37117846</ns2:doTransactionResponse>
    </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/">
            <return>
   <center><p><font type="Arial" size=2>Transfering to your bank for credit card authentication.        <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>
                </form><payUReference>185879181093</payUReference>
                <resultCode>P044</resultCode>
   <script language="Javascript">            <resultMessage>Rejected for fraud</resultMessage>
  <!--              <successful>false</successful>
  function  AutoSubmitForm() {document.downloadForm.submit();       </return>
        </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>
     AutoSubmitForm();
  <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
         <return>
    //--></script>]]></secure3DUrl>                 </secure3D><resultCode>00</resultCode>
            <successful>true<<resultMessage>Successful</successful>resultMessage>
        </return>     </ns2:doTransactionResponse><successful>true</successful>
     </soap:Body> </soap:Envelope>

...

Top

Code Block
languagexml
titleRESPONSE - Credit Card: PAYMENT or RESERVE (with bank reference)
linenumberstrue
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">      <displayMessage>Successful</displayMessage>
    <soap:Body>       <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/"> <merchantReference>1234567890</merchantReference>
            <payUReference>21976214819</payUReference>
     <return>       <paymentMethodsUsed   xsi:type="ns2:ebucks" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <resultCode>00</resultCode>             <resultMessage>Successful<<amountInCents>12000</resultMessage>amountInCents>
            <successful>true<</successful>paymentMethodsUsed>
            <displayMessage>Successful</displayMessage></return>
      </ns2:doTransactionResponse>
   </soap:Body>
 <merchantReference>1234567890</merchantReference>
            <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-instance">soap.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>

...