Versions Compared

Old Version 47

changes.mady.by.user Former user

Saved on

compared with

New Version Current

changes.mady.by.user Former user

Saved on

Key

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

Anchor
doctop
doctop

Click on 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>
              <shippingStateCode>WC</shippingStateCode>
              here~~~</wsse:Password><shippingMethod>P</shippingMethod>
              <<shppingFirstName>John</wsse:UsernameToken>shppingFirstName>
    </wsse:Security>     </soapenv:Header>     <soapenv:Body><shippingLastName>Doe</shippingLastName>
    <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">         <Api>ONE_ZERO</Api><shippingFax>27214688020</shippingFax>shippingFax>
           <Safekey>~~~SAFEKEY goes here ~~~</Safekey><shippingPhone>27214688021</shippingPhone>
          </shippingDetails>
<TransactionType>~~~a value of PAYMENT or RESERVE~~~</TransactionType>   </Basket>
     <AdditionalInformation>   <Fraud>
       <merchantReference>~~~Merchant ref goes here~~~<<checkFraudOverride>false</merchantReference>checkFraudOverride>
          <notificationUrl>http<merchantWebSite>http://www.example.com/notification-page/</notificationUrl>
        </AdditionalInformation>merchantWebSite>
        <Customer>  <pcFingerPrint>owhjiflkwhefqwoaef</pcFingerPrint>
        <countryCode>27<</countryCode>Fraud>
        <Creditcard>
 <countryOfResidence>ZAR</countryOfResidence>           <merchantUserId>0123465798<<amountInCents>12000</merchantUserId>amountInCents>
          <email>john.doe@example.com</email><cardExpiry>122014</cardExpiry>
          <firstName>John<<cardNumber>4111120000005078</firstName>cardNumber>
          <lastName> Doe </lastName>
<cvv>123</cvv>
         <mobile>0827777777</mobile>     <nameOnCard>Fred Fraud</nameOnCard>
    <regionalId>5612124567897</regionalId>      <verified/>
    <ip>127.0.0.1</ip>    </Creditcard>
    </Customer>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}�  <Basket>TransactionType=�PAYMENT� AuthenticationType=�HANDSHAKE�>
    <AdditionalInformation>
     <amountInCents>12000</amountInCents>   <merchantReference>CJR001</merchantReference>
    </AdditionalInformation>
  <currencyCode>ZAR</currencyCode>  <Customer>
        <description>Fraud Basket<<mobile>27827891249</description>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       </Creditcard>
    </soap:doTransaction>pmID="jh23d29832jhdo23hu" 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/" xmlns:soapSOAP-ENV="SOAP-ENV">
      <soapenv:Body>
      <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/" xmlns:SOAPENV="/">
         <Api>ONE_ZERO</Api>
         <Safekey>{00000000-0000-0000-0000-000000000000}</Safekey>
         <TransactionType>PAYMENT/RESERVE</TransactionType>
          http://schemas.xmlsoap.org/soap/envelope/"><AdditionalInformation>
     <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>           
       <wsse:UsernameToken wsu:Id="UsernameToken-9" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> </AdditionalInformation>
         <Customer>
            <countryCode>27</countryCode>
            <countryOfResidence>ZAR</countryOfResidence>
         <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username><merchantUserId>0123465798</merchantUserId>
           <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes <email>john.doe@example.com</email>
            <firstName>John</firstName>
            <lastName>Doe</lastName>
            here~~~</wsse:Password><mobile>0827777777</mobile>
            <<regionalId>5612124567897</wsse:UsernameToken>regionalId>
    </wsse:Security>     </soapenv:Header>Customer>
    <soapenv:Body>     <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/"> <Basket>
        <Api>ONE_ZERO</Api>    <amountInCents>12000</amountInCents> <!-- amount in zar <Safekey>~~~SAFEKEY goes here ~~~</Safekey>cents -->
        <TransactionType>~~~a value of PAYMENT or RESERVE~~~<<currencyCode>ZAR</TransactionType>currencyCode>
        <AdditionalInformation> </Basket>
         <deviceId>TERM003</deviceId><Ebucks>
          <merchantReference>~~~Merchant ref goes here ~~~</merchantReference>
      <amountInCents>12000</amountInCents> <!-- amount in eBucks cents (EB * 10) -->
   <notificationUrl> http://example.com/notification-page/</notificationUrl>     </Ebucks>
   </AdditionalInformation>     <Customfield>
   <Customer>         <key>ebucksOtp</key>
 <countryCode>27</countryCode>           <countryOfResidence>ZAR<<value>909059</countryOfResidence>value>
          <merchantUserId>0123465798<</merchantUserId>Customfield>
          <email>john.doe@example.com</email><Customfield>
            <firstName>John<<key>ebucksAccountNumber</firstName>key>
          <lastName> Doe <<value>80000278865</lastName>value>
          <mobile>0827777777<</mobile>Customfield>
      </soap:doTransaction>
   </soapenv:Body>
</soapenv:Envelope>

Anchor
request_credit
request_credit

Top

Code Block
languagexml
titleREQUEST - Crediting a transaction
linenumberstrue
<soapenv:Envelope  <regionalId>5612124567897</regionalId>
          <ip>127.0.0.1</ip>
        </Customer>
        <Basket>
          <amountInCents>12000</amountInCents>
          <currencyCode>ZAR</currencyCode>
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>
         <description>Fraud Basket</description>
          <!--Zero or more repetitions:-->
          <productLineItem><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  <amount>10000</amount>
              <costAmount>1000</costAmount>
              <description>Product 1</description>
     wsu:Id="UsernameToken-9" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
        <giftMessage>Happy Birthday</giftMessage>       <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username>
    <productCode>ABC0002</productCode>               <quantity>1</quantity>
              <recipientAddress1>21 Example Road</recipientAddress1>
  <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes
           <recipientCity>Cape Town<here~~~</recipientCity>wsse:Password>
              <recipientCountryCode>ZAR</recipientCountryCode></wsse:UsernameToken>
        </wsse:Security>
     <recipientPostalCode>8000</recipientPostalCode></soapenv:Header>
    <soapenv:Body>
         <recipientFirstName>John</recipientFirstName>
              <recipientLastName>Doe</recipientLastName>
          </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 <<TransactionType>CREDIT</shippingAddressCity>TransactionType>
            <AdditionalInformation>
 <shippingEmail> john.doe@example.com </shippingEmail>             <merchantReference>~~~Merchant ref <shippingCountryCode>ZAR</shippingCountryCode>goes here   ~~~</merchantReference>
          <shippingStateCode>WC</shippingStateCode>      <payUReference>~~~PayU ref goes       <shippingMethod>P</shippingMethod>here ~~~</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/">
  <checkFraudOverride>false</checkFraudOverride>
  <soap:Body>
        <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>        <successful>true</successful>
  <cardExpiry>122014</cardExpiry>           <cardNumber>4111120000005078<<displayMessage>Successful</cardNumber>displayMessage>
          <cvv>123</cvv>  <merchantReference>1234567890</merchantReference>
        <nameOnCard>Fred Fraud</nameOnCard>           <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� >
    <AdditionalInformation><paymentMethodsUsed xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <amountInCents>1000</amountInCents>
          <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>     </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:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.api.controller.web.payjar.comschemas.xmlsoap.org/soap/envelope/">
    <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>
            <TransactionType>PAYMENT</TransactionType>.payjar.com/">
        <return>
   <AuthenticationType>NA</AuthenticationType>         <displayMessage>Transaction Pending 3DS Completion</displayMessage>
<AdditionalInformation>            <fraud>
    <merchantReference>MerchRef001</merchantReference>                 <supportedPaymentMethods>CREDITCARD</supportedPaymentMethods><resultCode>V030</resultCode>
                <storePaymentMethod>true<<resultMessage>Success</storePaymentMethod>resultMessage>
            </AdditionalInformation>fraud>
            <Customer><merchantReference>0123456789</merchantReference>
                <countryCode>27</countryCode><payUReference>31982857915</payUReference>
            <paymentMethodsUsed    <merchantUserId>MechUser001</merchantUserId>xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <email>name.surname@mail.com</email><amountInCents>350</amountInCents>
                <firstName>Name<<cardExpiry>092014</firstName>cardExpiry>
                <lastName>Surname</lastName><cardNumber>456546******6016</cardNumber>
                <mobile>27887592452<<gatewayReference>37117846</mobile>gatewayReference>
                <regionalId>2345679888<<information>VISA</regionalId>
information>
           </Customer>     <nameOnCard>Jon Doe </nameOnCard>
     <Basket>                 <amountInCents>1000</amountInCents></paymentMethodsUsed>
                <currencyCode>ZAR</currencyCode><resultCode>P3DS</resultCode>
            <resultMessage>Transaction Pending 3DS  <description>Goods<Completion</description>resultMessage>
            </Basket><secure3D>
            <Creditcard>      <secure3DId>A5ufG1Q3sp3qGDxu5de3</secure3DId>
          <amountInCents>1000</amountInCents>           <secure3DUrl><![CDATA[<form name="downloadForm" action="http://acstest.bankserv.co.za/V3DSStart?osb=visa-3&VAA=B"
   <cardExpiry>122013</cardExpiry>             method="POST">
    <cardNumber>5111120000091349</cardNumber>            <table name="dataTable" border="0" cellpadding="0">
 <cvv>123</cvv>               <INPUT  <nameOnCard>N Surname</nameOnCard>TYPE="hidden" NAME="TransactionID" value="A5ufG1Q3sp3qGDxu5de3">
            </Creditcard>    <INPUT TYPE="hidden" NAME="PaReq"
  </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>        value="eNpVUtty2jAQfddXeNLHzliWbWzCLJohgZSkTbik0yZ9E2IpLmCD5Av46ys5dtK+nbO7Wp2zu/B9qxDHzygLhRweUWvxG51kPbyanrP463K3Ci7ZTL
                zOskX5ebp5qR/Efje84jAfLfHEoUSlkyzlzPVcH2hHiWml5FakOQchTzf3TzzqhYHPgLaUwAHV/ZgzPwh7UdwH+sYJpOKA/EakO42qHG1UIoXTdQPaZAnIrEh
               <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/"> zdeEx84B2hECh9nyb58cBpVVVuau2iysztxZAbZoA/dA2LyzSxvo5WfM48Ov56+IJy9XPu/GPSzkZf9Gnl9vq2+MQqK0gsBY5ct9jgdf3fIdFg9AbMGOriRMQ
         <Api>ONE_ZERO</Api>       B6uFLwO3Z4S1jMDR/jN6Y4HN/BswbgqlMJWdnY4RwPMxS9HUmNm+YyMCteSZWqNyPjlBzFjcDyOjwYYJJKnOxX5v33TQmP6weju1S5G5mfadCPWsno
  <Safekey>{86903CCB-79A9-42EE-0174-1ACE90185507}</Safekey>            <TransactionType>PAYMENT</TransactionType>  pZdP0QqF/qz3GyQb+q88XEbqqpaVQkZrws9K4bGUkza2r70PYOaHs6Bv13Un8BvvXHsA==">
       <AuthenticationType>TOKEN</AuthenticationType>         <INPUT <AdditionalInformation>
 TYPE="hidden" NAME="TermUrl" VALUE="http://staging.safeshop.co.za/s2s/Secure3D/Encode_Finish.asp">
        <merchantReference>MerchRef001</merchantReference>        <INPUT TYPE="hidden"  <supportedPaymentMethods>CREDITCARD</supportedPaymentMethods>NAME="MD" VALUE="37117846">
         </AdditionalInformation>       </table>
  <Customer>             <countryCode>27</countryCode> <center><p><font type="Arial" size=2>Transfering to your bank for credit card authentication.
  <merchantUserId>MechUser001</merchantUserId>             <email>name.surname@mail.com</email> <p> If you are not redirected please <a     <firstName>Name</firstName>
            <lastName>Surname</lastName>href="javascript:AutoSubmitForm()">click here</a> on the image to continue to access your banking
              <mobile>27887592452</mobile>  institution.<p>
          <regionalId>2345679888</regionalId>      <input type="image" src="http://staging.images.safeshop.co.za/PaymentMethods/Secure3D/VbyV_blue_120x69.gif"  </Customer>name="continue"
          <Basket>      value="Continue"></center>
      <amountInCents>1000</amountInCents>          </form>
  <currencyCode>ZAR</currencyCode>             <description>Goods</description> <script language="Javascript">
        </Basket>        <!--
         <Creditcard       function AutoSubmitForm() {document.downloadForm.submit();
   <pmId>DyZ7XBB5QxF5FEoIADAkMCQAUnlDEmIRVXNTa3xUYVUWfEUT</pmId>             <amountInCents>1000</amountInCents>}
            <cvv>123</cvv>    AutoSubmitForm();
     </Creditcard>       </soap:doTransaction>    </soapenv:Body> </soapenv:Envelope>

...

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--></script>]]></secure3DUrl>
                </secure3D>
            <successful>true</successful>
        </return>
    </ns2:doTransactionResponse>
    </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://docsschemas.oasis-openxmlsoap.org/wsssoap/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsdenvelope/">
   <soap:Body>
        <wsse:UsernameToken wsu:Id="UsernameToken-9"<ns2:doTransactionResponse xmlns:wsuns2="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">soap.api.controller.web.payjar.com/">
         <return>
            <resultCode>00</resultCode>
    <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username>     <resultMessage>Successful</resultMessage>
           <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes <successful>true</successful>
             here~~~</wsse:Password><displayMessage>Successful</displayMessage>
            <<merchantReference>1234567890</wsse:UsernameToken>merchantReference>
        </wsse:Security>     <<payUReference>21976214819</soapenv:Header>payUReference>
    <soapenv:Body>         <soap:doTransaction<paymentMethodsUsed xsi:type="ns2:creditCard" xmlns:ns2xsi="http://soapwww.api.controller.web.payjar.com/w3.org/2001/XMLSchema-instance">
            <Api>ONE_ZERO</Api>   <amountInCents>1000</amountInCents>
         <Safekey>~~~SAFEKEY goes here ~~~</Safekey>   <cardExpiry>122015</cardExpiry>
         <TransactionType>CREDIT</TransactionType>      <cardNumber>400000******1000</cardNumber>
      <AdditionalInformation>         <gatewayReference>37149772</gatewayReference>
       <merchantReference>~~~Merchant ref goes here ~~~</merchantReference>    <information>VISA</information>
            <payUReference>~~~PayU ref goes here<nameOnCard>John ~~~<Doe</payUReference>nameOnCard>
            </AdditionalInformation>paymentMethodsUsed> 
           <Basket> <customFields>
               <amountInCents>1000<<key>bankReference</amountInCents>key>
                <currencyCode>ZAR<<value>DEMO12</currencyCode>value>
            </Basket>customFields>
         </soap:doTransaction>return>
      </ns2: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>

...