Page Comparison

...

API requests:
- REQUEST - Credit Card request: PAYMENT or RESERVE
  This is the default API response for either a PAYMENT or RESERVE API call using credit cards as a payment method. Please make sure that you understand the difference between a PAYMENT and RESERVE api calls.
- REQUEST - Credit Card: PAYMENT or RESERVE (with Fraud enabled)
  PayU's Fraud service is an optional paid-for service. If integrating and signed up for fraud, please make sure to include the sections Basket.productLineItem, Basket.shippingDetails and Fraud
- REQUEST - Credit Card with HandshakeeBucks: PAYMENT
- REQUEST - Credit Card with Token (Save Card) - first requestREQUEST - Credit Card with Token (Save Card) - subsequent request Handshake
- REQUEST - Crediting a transaction
API response:

...

Top

...

- RESPONSE - Credit Card: PAYMENT or RESERVE
  This is the default API response for either a PAYMENT or RESERVE API call using credit cards.
- RESPONSE - Credit Card: PAYMENT or RESERVE (with 3D Secure enabled - card enrolled)
  This is the default API response for either a PAYMENT or RESERVE API call using credit cards, but the store is 3D enabled.
- RESPONSE - Credit Card: PAYMENT or RESERVE (with bank reference)
  Merchant can request to have the the bank reference returned in the doTransaction API reponse (by default it is not returned) for credit card payments. If enabled it will send the bank reference in the customer field parameter.
- RESPONSE - Credit Card: PAYMENT or RESERVE (with Fraud enabled - APPROVE)
  This is the default API response for either a PAYMENT or RESERVE API call using credit cards, where Fraud is enabled and an APPROVE response was recieved from the Fraud service provider.

...

- RESPONSE - Credit Card

...

- : PAYMENT or RESERVE

...

- (with Fraud enabled - CHALLENGE)
  This is the default API response for either a PAYMENT or RESERVE API call using credit cards, where Fraud is enabled and a CHALLENGE response was recieved from the Fraud service provider.
- RESPONSE - Credit Card: PAYMENT or RESERVE (with Fraud enabled - DENY)
  This is the default API response for either a PAYMENT or RESERVE API call using credit cards, where Fraud is enabled and a DENY response was recieved from the Fraud service provider.
- RESPONSE - eBucks: PAYMENT
  This is the default API response for either a PAYMENT or RESERVE API call using eBucks
- response_EFTPro_payment
  This is the default API response for EFT Pro payment

Anchor

	example_without_fraud
	example_without_fraud

Top

Code Block

language	xml
title	REQUEST - Credit Card request: PAYMENT or RESERVE
linenumbers	true

<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

language	xml
title	REQUEST - Credit Card: PAYMENT or RESERVE (with Fraud enabled)
linenumbers	true

<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>
        <wsse:UsernameToken wsu:Id="UsernameToken-9" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> <countryCode>27</countryCode>
          <countryOfResidence>ZAR</countryOfResidence>
          <merchantUserId>0123465798</merchantUserId>
          <email>john.doe@example.com</email>
          <firstName>John</firstName>
       <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username>   <lastName> Doe </lastName>
          <mobile>0827777777</mobile>
      <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>    <regionalId>5612124567897</regionalId>
          <ip>127.0.0.1</ip>
        </Customer>
        <Basket>
          </wsse:UsernameToken><amountInCents>12000</amountInCents>
          </wsse:Security><currencyCode>ZAR</currencyCode>
          <description>Fraud <Basket</soapenv:Header>description>
   <soapenv:Body>       <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/"><!--Zero or more repetitions:-->
          <Api>ONE_ZERO</Api><productLineItem>
           <Safekey>~~~SAFEKEY goes here ~~~<<amount>10000</Safekey>amount>
         <TransactionType>~~~a value of PAYMENT or RESERVE~~~</TransactionType><costAmount>1000</costAmount>
              <description>Product <AdditionalInformation>1</description>
            <merchantReference>~~~Merchant ref goes<giftMessage>Happy here~~~<Birthday</merchantReference>giftMessage>
              <notificationUrl>http://example.com/notification-page/</notificationUrl><productCode>ABC0002</productCode>
          </AdditionalInformation>    <quantity>1</quantity>
     <Customer>         <recipientAddress1>21 Example Road</recipientAddress1>
 <countryCode>27</countryCode>             <recipientCity>Cape <countryOfResidence>ZAR<Town</countryOfResidence>recipientCity>
              <merchantUserId>0123465798<<recipientCountryCode>ZAR</merchantUserId>recipientCountryCode>
              <email>john.doe@example.com</email><recipientPostalCode>8000</recipientPostalCode>
              <firstName>John<<recipientFirstName>John</firstName>recipientFirstName>
              <lastName>Doe<<recipientLastName>Doe</lastName>recipientLastName>
          </productLineItem>
 <mobile>0827777777</mobile>         <shippingDetails>
   <regionalId>5612124567897</regionalId>           <shippingAddress1>21  <ip>127.0.0.1</ip>Example Road</shippingAddress1>
          </Customer>    <shippingAddressCity>Cape Town </shippingAddressCity>
   <Basket>           <shippingEmail> john.doe@example.com <amountInCents>12000<</amountInCents>shippingEmail>
            <currencyCode>ZAR</currencyCode>  <shippingCountryCode>ZAR</shippingCountryCode>
          <description>Fraud Basket</description>   <shippingStateCode>WC</shippingStateCode>
      </Basket>        <shippingMethod>P</shippingMethod>
 <Creditcard>             <amountInCents>12000<<shppingFirstName>John</amountInCents>shppingFirstName>
              <cardExpiry>122014<<shippingLastName>Doe</cardExpiry>shippingLastName>
              <cardNumber>4111120000005078<<shippingFax>27214688020</cardNumber>shippingFax>shippingFax>
              <cvv>123<<shippingPhone>27214688021</cvv>shippingPhone>
          </shippingDetails>
 <nameOnCard>Fred Fraud</nameOnCard>      </Basket>
   </Creditcard>     <Fraud>
 </soap:doTransaction>    </soapenv:Body>
</soapenv:Envelope>

...

Top

Code Block

language	xml
title	REQUEST - Credit Card: PAYMENT or RESERVE (with Fraud enabled)
linenumbers	true

<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">     <checkFraudOverride>false</checkFraudOverride>
          <merchantWebSite>http://www.example.com/ </merchantWebSite>
          <pcFingerPrint>owhjiflkwhefqwoaef</pcFingerPrint>
        </Fraud>
        <Creditcard>
          <amountInCents>12000</amountInCents>
          <cardExpiry>122014</cardExpiry>
          <cardNumber>4111120000005078</cardNumber>
        <wsse:UsernameToken wsu:Id="UsernameToken-9" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" <cvv>123</cvv>
          <nameOnCard>Fred Fraud</nameOnCard>
          <verified/>
        <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username></Creditcard>
    </soap:doTransaction>
    <wsse</soapenv:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes
   Body>
</soapenv:Envelope>

Anchor

	with_handshake
	with_handshake

Top

Code Block

language	xml
title	REQUEST - Credit Card with Handshake
linenumbers	true

<DoTransaction Api=â€�1.0â€� Safekey=â€�{86903CCB-79A9-42EE-8637-1ACE90185507}â€� TransactionType=â€�PAYMENTâ€� AuthenticationType=â€�HANDSHAKEâ€�>
    <AdditionalInformation>
        here~~~<<merchantReference>CJR001</wsse:Password>merchantReference>
    </AdditionalInformation>
   </wsse:UsernameToken> <Customer>
   </wsse:Security>     </soapenv:Header><mobile>27827891249</mobile>
    </Customer>
<soapenv:Body>    <Basket>
<soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">       <amountInCents>1000</amountInCents>
 <Api>ONE_ZERO</Api>       <currencyCode>ZAR</currencyCode>
 <Safekey>~~~SAFEKEY goes here ~~~</Safekey>    <description>ORD111</description>
    <TransactionType>~~~a</Basket>
value of PAYMENT or RESERVE~~~</TransactionType><PaymentMethods>
        <AdditionalInformation><CreditCard pmID="jh23d29832jhdo23hu" CVV=â€�123â€� AmountInCents="2300" />
    </PaymentMethods>
 <deviceId>TERM003</deviceId>
          <merchantReference>~~~Merchant ref goes here ~~~</merchantReference>
          <notificationUrl> http://example.com/notification-page/</notificationUrl></DoTransaction>

Anchor

	save_card_1
	save_card_1

Top

Code Block

language	xml
title	REQUEST - eBucks (PAYMENT)
linenumbers	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.api.controller.web.payjar.com/" xmlns:SOAPENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="SOAP-ENV">
      <soapenv:Body>
 </AdditionalInformation>     <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">
  <Customer>           <countryCode>27</countryCode><Api>ONE_ZERO</Api>
          <countryOfResidence>ZAR</countryOfResidence><Safekey>{00000000-0000-0000-0000-000000000000}</Safekey>
          <merchantUserId>0123465798</merchantUserId><TransactionType>PAYMENT/RESERVE</TransactionType>
         <AdditionalInformation>
 <email>john.doe@example.com</email>           <firstName>John<<merchantReference>1234567890</firstName>
merchantReference>          <lastName> Doe </lastName>  
         <mobile>0827777777<</mobile>AdditionalInformation>
         <Customer>
 <regionalId>5612124567897</regionalId>           <ip>127.0.0.1</ip><countryCode>27</countryCode>
        </Customer>     <countryOfResidence>ZAR</countryOfResidence>
   <Basket>         <merchantUserId>0123465798</merchantUserId>
 <amountInCents>12000</amountInCents>           <currencyCode>ZAR</currencyCode><email>john.doe@example.com</email>
           <description>Fraud Basket<<firstName>John</description>firstName>
          <!--Zero or more repetitions:--><lastName>Doe</lastName>
           <productLineItem> <mobile>0827777777</mobile>
             <amount>10000<<regionalId>5612124567897</amount>regionalId>
         </Customer>
    <costAmount>1000</costAmount>     <Basket>
         <description>Product 1</description>  <amountInCents>12000</amountInCents> <!-- amount in zar cents -->
      <giftMessage>Happy Birthday</giftMessage>     <currencyCode>ZAR</currencyCode>
         <productCode>ABC0002<</productCode>Basket>
         <Ebucks>
    <quantity>1</quantity>        <amountInCents>12000</amountInCents> <!-- amount in eBucks cents (EB * <recipientAddress1>21 Example Road</recipientAddress1>10) -->
         </Ebucks>
     <recipientCity>Cape Town</recipientCity>  <Customfield>
            <recipientCountryCode>ZAR<<key>ebucksOtp</recipientCountryCode>key>
              <recipientPostalCode>8000<<value>909059</recipientPostalCode>value>
         </Customfield>
    <recipientFirstName>John</recipientFirstName>      <Customfield>
        <recipientLastName>Doe</recipientLastName>    <key>ebucksAccountNumber</key>
      </productLineItem>      <value>80000278865</value>
    <shippingDetails>     </Customfield>
      </soap:doTransaction>
  <shippingAddress1>21 Example Road</shippingAddress1>
              <shippingAddressCity>Cape Town </shippingAddressCity></soapenv:Body>
</soapenv:Envelope>

Anchor

	request_credit
	request_credit

Top

Code Block

language	xml
title	REQUEST - Crediting a transaction
linenumbers	true

<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>
         <shippingEmail> john.doe@example.com </shippingEmail><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  <shippingCountryCode>ZAR</shippingCountryCode>
              <shippingStateCode>WC</shippingStateCode>
              <shippingMethod>P</shippingMethod>
      wsu:Id="UsernameToken-9" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
       <shppingFirstName>John</shppingFirstName>         <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username>
  <shippingLastName>Doe</shippingLastName>               <shippingFax>27214688020</shippingFax>shippingFax>
              <shippingPhone>27214688021</shippingPhone>
          </shippingDetails>
        </Basket>
 <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes
      <Fraud>      here~~~</wsse:Password>
    <checkFraudOverride>false</checkFraudOverride>           <merchantWebSite>http://www.example.com/ </merchantWebSite>wsse:UsernameToken>
          <pcFingerPrint>owhjiflkwhefqwoaef</pcFingerPrint>
  </wsse:Security>
     </Fraud>soapenv:Header>
    <soapenv:Body>
   <Creditcard>           <amountInCents>12000</amountInCents>
          <cardExpiry>122014</cardExpiry><soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/">
            <cardNumber>4111120000005078<<Api>ONE_ZERO</cardNumber>Api>
          <cvv>123</cvv>  <Safekey>~~~SAFEKEY goes here  ~~~</Safekey>
    <nameOnCard>Fred Fraud</nameOnCard>           <verified/><TransactionType>CREDIT</TransactionType>
        </Creditcard>     </soap:doTransaction>
    </soapenv:Body>
</soapenv:Envelope>

...

Top

Code Block

language	xml
title	REQUEST - Credit Card with Handshake
linenumbers	true

<DoTransaction Api=â€�1.0â€� Safekey=â€�{86903CCB-79A9-42EE-8637-1ACE90185507}â€� TransactionType=â€�PAYMENTâ€� AuthenticationType=â€�HANDSHAKEâ€�><AdditionalInformation>
           <AdditionalInformation>     <merchantReference>~~~Merchant ref goes here <merchantReference>CJR001<~~~</merchantReference>
    </AdditionalInformation>       <Customer>     <payUReference>~~~PayU ref goes here <mobile>27827891249</mobile>~~~</payUReference>
            </Customer>AdditionalInformation>
            <Basket>
                <amountInCents>1000</amountInCents>
        <currencyCode>ZAR</currencyCode>         <description>ORD111<<currencyCode>ZAR</description>currencyCode>
    </Basket>     <PaymentMethods>    </Basket>
    <CreditCard pmID="jh23d29832jhdo23hu" CVV=â€�123â€� AmountInCents="2300" </>soap:doTransaction>
    </PaymentMethods>soapenv:Body>
</DoTransaction>soapenv:Envelope>

Anchor

	saveresponse_without_cardbank_1refsave
	response_without_cardbank_1ref

Top

Code Block

language	xml
title	REQUEST RESPONSE - Credit Card with Token (Save Card) - first request: PAYMENT or RESERVE
linenumbers	true

<soapenv<soap:Envelope xmlns:soapenvsoap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.api.controller.web.payjar.com/soap/envelope/">
    <soapenv:Header/>
    <soapenv:<soap:Body>
        <soap<ns2:doTransactiondoTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
            <Api>ONE_ZERO</Api>
            <Safekey>{86903CCB-79A9-42EE-0174-1ACE90185507}</Safekey>
            <TransactionType>PAYMENT</TransactionType>
     >
      <AuthenticationType>NA</AuthenticationType>    <return>
        <AdditionalInformation>    <resultCode>00</resultCode>
            <merchantReference>MerchRef001<<resultMessage>Successful</merchantReference>resultMessage>
                <supportedPaymentMethods>CREDITCARD</supportedPaymentMethods><successful>true</successful>
                <storePaymentMethod>true</storePaymentMethod><displayMessage>Successful</displayMessage>
            <<merchantReference>1234567890</AdditionalInformation>merchantReference>
            <Customer><payUReference>21976214819</payUReference>
            <paymentMethodsUsed    <countryCode>27</countryCode>xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <merchantUserId>MechUser001<<amountInCents>1000</merchantUserId>amountInCents>
                <email>name.surname@mail.com</email><cardExpiry>122015</cardExpiry>
                 <firstName>Name</firstName><cardNumber>400000******1000</cardNumber>
                <lastName>Surname<<gatewayReference>37149772</lastName>gatewayReference>
                <mobile>27887592452<<information>VISA</mobile>information>
               <nameOnCard>John <regionalId>2345679888<Doe</regionalId>nameOnCard>
            </Customer>paymentMethodsUsed>
         </return>
  <Basket>    </ns2:doTransactionResponse>
   </soap:Body>
        <amountInCents>1000</amountInCents></soap:Envelope>

Anchor

	response_with_3D
	response_with_3D

Top

Code Block

language	xml
title	RESPONSE - Credit Card: PAYMENT or RESERVE (with 3D Secure enabled - card enrolled)

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
           <currencyCode>ZAR</currencyCode>
                <description>Goods</description>
            </Basket><ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
        <return>
   <Creditcard>         <displayMessage>Transaction Pending       <amountInCents>1000</amountInCents>3DS Completion</displayMessage>
            <fraud>
   <cardExpiry>122013</cardExpiry>                 <cardNumber>5111120000091349</cardNumber><resultCode>V030</resultCode>
                <cvv>123<<resultMessage>Success</cvv>resultMessage>
                <nameOnCard>N Surname</nameOnCard></fraud>
            <<merchantReference>0123456789</Creditcard>merchantReference>
        </soap:doTransaction>     </soapenv:Body>
</soapenv:Envelope>

...

Top

Code Block

language	xml
title	Credit Card with Token (Save Card) Subsequent REQUEST:
linenumbers	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap<payUReference>31982857915</payUReference>
            <paymentMethodsUsed xsi:type="ns2:creditCard" xmlns:xsi="http://soapwww.api.controller.web.payjar.com/">w3.org/2001/XMLSchema-instance">
                <amountInCents>350</amountInCents>
    <soapenv:Header/>    <soapenv:Body>       <soap:doTransaction xmlns:ns2="http://soap.api.controller.web.payjar.com/"> <cardExpiry>092014</cardExpiry>
                <Api>ONE_ZERO</Api><cardNumber>456546******6016</cardNumber>
           <Safekey>{86903CCB-79A9-42EE-0174-1ACE90185507}</Safekey>     <gatewayReference>37117846</gatewayReference>
    <TransactionType>PAYMENT</TransactionType>          <AuthenticationType>TOKEN</AuthenticationType>  <information>VISA</information>
       <AdditionalInformation>         <nameOnCard>Jon Doe <merchantReference>MerchRef001<</merchantReference>
nameOnCard>
         <supportedPaymentMethods>CREDITCARD</supportedPaymentMethods>   </paymentMethodsUsed>
      </AdditionalInformation>      <resultCode>P3DS</resultCode>
   <Customer>         <resultMessage>Transaction Pending 3DS  <countryCode>27<Completion</countryCode>resultMessage>
            <merchantUserId>MechUser001</merchantUserId><secure3D>
            <email>name.surname@mail.com</email>    <secure3DId>A5ufG1Q3sp3qGDxu5de3</secure3DId>
        <firstName>Name</firstName>        <secure3DUrl><![CDATA[<form     <lastName>Surname</lastName>name="downloadForm" action="http://acstest.bankserv.co.za/V3DSStart?osb=visa-3&VAA=B"
            <mobile>27887592452</mobile>    method="POST">
        <regionalId>2345679888</regionalId>        <table  </Customer>
name="dataTable" border="0" cellpadding="0">
        <Basket>        <INPUT TYPE="hidden" NAME="TransactionID" value="A5ufG1Q3sp3qGDxu5de3">
 <amountInCents>1000</amountInCents>             <currencyCode>ZAR</currencyCode>  <INPUT TYPE="hidden" NAME="PaReq"
        <description>Goods</description>        value="eNpVUtty2jAQfddXeNLHzliWbWzCLJohgZSkTbik0yZ9E2IpLmCD5Av46ys5dtK+nbO7Wp2zu/B9qxDHzygLhRweUWvxG51kPbyanrP463K3Ci7ZTL
  </Basket>              zOskX5ebp5qR/Efje84jAfLfHEoUSlkyzlzPVcH2hHiWml5FakOQchTzf3TzzqhYHPgLaUwAHV/ZgzPwh7UdwH+sYJpOKA/EakO42qHG1UIoXTdQPaZAnIrEh
   <Creditcard             <pmId>DyZ7XBB5QxF5FEoIADAkMCQAUnlDEmIRVXNTa3xUYVUWfEUT</pmId>zdeEx84B2hECh9nyb58cBpVVVuau2iysztxZAbZoA/dA2LyzSxvo5WfM48Ov56+IJy9XPu/GPSzkZf9Gnl9vq2+MQqK0gsBY5ct9jgdf3fIdFg9AbMGOriRMQ
                <amountInCents>1000</amountInCents>B6uFLwO3Z4S1jMDR/jN6Y4HN/BswbgqlMJWdnY4RwPMxS9HUmNm+YyMCteSZWqNyPjlBzFjcDyOjwYYJJKnOxX5v33TQmP6weju1S5G5mfadCPWsno
            <cvv>123</cvv>    pZdP0QqF/qz3GyQb+q88XEbqqpaVQkZrws9K4bGUkza2r70PYOaHs6Bv13Un8BvvXHsA==">
     </Creditcard>       </soap:doTransaction>    </soapenv:Body>
</soapenv:Envelope>

...

Top

Code Block

language	xml
title	REQUEST - Crediting a transaction
linenumbers	true

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://soap.api.controller.web.payjar.com/" xmlns:SOAPENV<INPUT TYPE="hidden" NAME="TermUrl" VALUE="http://schemasstaging.safeshop.xmlsoapco.orgza/soaps2s/envelopeSecure3D/Encode_Finish.asp">
       <soapenv:Header>         <wsse:Security SOAP-ENV:mustUnderstand<INPUT TYPE="1hidden" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">NAME="MD" VALUE="37117846">
              <wsse:UsernameToken wsu:Id="UsernameToken-9" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"> </table>
                 <wsse:Username>~~~SOAP Username goes here~~~</wsse:Username>
    <center><p><font type="Arial" size=2>Transfering to your bank for credit card authentication.
           <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">~~~SOAP Password goes  <p> If you are not redirected please <a href="javascript:AutoSubmitForm()">click here</a> on here~~~</wsse:Password>the image to continue to access your banking
     </wsse:UsernameToken>         </wsse:Security>
  institution.<p>
   </soapenv:Header>     <soapenv:Body>         <soap:doTransaction xmlns:ns2<input type="image" src="http://soapstaging.apiimages.controllersafeshop.web.payjar.com/">co.za/PaymentMethods/Secure3D/VbyV_blue_120x69.gif" name="continue"
                <Api>ONE_ZERO</Api>value="Continue"></center>
             <Safekey>~~~SAFEKEY goes here ~~~</Safekey></form>
                <TransactionType>CREDIT</TransactionType>
<script language="Javascript">
           <AdditionalInformation>     <!--
           <merchantReference>~~~Merchant ref goes here ~~~</merchantReference> function AutoSubmitForm() {document.downloadForm.submit();
             <payUReference>~~~PayU ref goes here}
~~~</payUReference>             </AdditionalInformation>   AutoSubmitForm();
         <Basket>       //--></script>]]></secure3DUrl>
         <amountInCents>1000</amountInCents>       </secure3D>
         <currencyCode>ZAR</currencyCode>   <successful>true</successful>
         </Basket>
   return>
    </soapns2:doTransaction>doTransactionResponse>
    </soapenvsoap:Body>
</soapenvsoap:Envelope>

Anchor

	response_withoutwith_bank_ref
	response_withoutwith_bank_ref

Top

Code Block

language	xml
title	RESPONSE - Credit Card: PAYMENT or RESERVE (with bank reference)
linenumbers	true

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
         <return>
            <resultCode>00</resultCode>
            <resultMessage>Successful</resultMessage>
            <successful>true</successful>
            <displayMessage>Successful</displayMessage>
            <merchantReference>1234567890</merchantReference>
            <payUReference>21976214819</payUReference>
            <paymentMethodsUsed xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <amountInCents>1000</amountInCents>
               <cardExpiry>122015</cardExpiry>
               <cardNumber>400000******1000</cardNumber>
               <gatewayReference>37149772</gatewayReference>
             
 <information>VISA</information>                <nameOnCard>John Doe</nameOnCard>       <cardExpiry>122015</cardExpiry>
     </paymentMethodsUsed>          </return><cardNumber>400000******1000</cardNumber>
        </ns2:doTransactionResponse>    </soap:Body> </soap:Envelope>

...

Top

Code Block

language	xml
title	RESPONSE - Credit Card: PAYMENT or RESERVE (with 3D Secure enabled - card enrolled)

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <gatewayReference>37149772</gatewayReference>
               <information>VISA</information>
               <nameOnCard>John Doe</nameOnCard>
            </paymentMethodsUsed> 
    <soap:Body>     <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">  <customFields>
      <return>         <key>bankReference</key>
   <displayMessage>Transaction Pending 3DS Completion</displayMessage>         <value>DEMO12</value>
   <fraud>         </customFields>
       <resultCode>V030</resultCode>  </return>
     Â </ns2:doTransactionResponse>
   </soap:Body>
</soap:Envelope>

  <resultMessage>Success</resultMessage>
            </fraud>
            <merchantReference>0123456789</merchantReference>
            <payUReference>31982857915</payUReference>

Anchor

	response_with_fraud_approve
	response_with_fraud_approve

Top

Code Block

language	xml
title	RESPONSE - Credit Card: PAYMENT or RESERVE (with Fraud enabled - APPROVE)
linenumbers	true

<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>350</amountInCents>             <displayMessage>Successful</displayMessage>
   <cardExpiry>092014</cardExpiry>             <fraud>
   <cardNumber>456546******6016</cardNumber>                 <gatewayReference>37117846<<resultCode>V030</gatewayReference>resultCode>
                  <information>VISA</information>  <resultMessage>Success</resultMessage>
              <nameOnCard>Jon Doe </nameOnCard>fraud>
                <<merchantReference>mercRef_1403097874</paymentMethodsUsed>merchantReference>
            <resultCode>P3DS</resultCode>    <payUReference>185871924286</payUReference>
        <resultMessage>Transaction Pending 3DS Completion</resultMessage>     <paymentMethodsUsed   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns2:creditCard">
    <secure3D>                 <secure3DId>A5ufG1Q3sp3qGDxu5de3<<amountInCents>2156</secure3DId>amountInCents>
                <secure3DUrl><![CDATA[<form name="downloadForm" action="http://acstest.bankserv.co.za/V3DSStart?osb=visa-3&VAA=B"          <cardExpiry>012015</cardExpiry>
      method="POST">              <cardNumber>542028******1323</cardNumber>
  <table name="dataTable" border="0" cellpadding="0">                <gatewayReference>37585977</gatewayReference>
   <INPUT TYPE="hidden" NAME="TransactionID" value="A5ufG1Q3sp3qGDxu5de3">              <information>MASTERCARD</information>
  <INPUT TYPE="hidden" NAME="PaReq"                 value="eNpVUtty2jAQfddXeNLHzliWbWzCLJohgZSkTbik0yZ9E2IpLmCD5Av46ys5dtK+nbO7Wp2zu/B9qxDHzygLhRweUWvxG51kPbyanrP463K3Ci7ZTL<nameOnCard>John Doe</nameOnCard>
                zOskX5ebp5qR/Efje84jAfLfHEoUSlkyzlzPVcH2hHiWml5FakOQchTzf3TzzqhYHPgLaUwAHV/ZgzPwh7UdwH+sYJpOKA/EakO42qHG1UIoXTdQPaZAnIrEh</paymentMethodsUsed>
                zdeEx84B2hECh9nyb58cBpVVVuau2iysztxZAbZoA/dA2LyzSxvo5WfM48Ov56+IJy9XPu/GPSzkZf9Gnl9vq2+MQqK0gsBY5ct9jgdf3fIdFg9AbMGOriRMQ<resultCode>00</resultCode>
                B6uFLwO3Z4S1jMDR/jN6Y4HN/BswbgqlMJWdnY4RwPMxS9HUmNm+YyMCteSZWqNyPjlBzFjcDyOjwYYJJKnOxX5v33TQmP6weju1S5G5mfadCPWsno<resultMessage>Successful</resultMessage>
                pZdP0QqF/qz3GyQb+q88XEbqqpaVQkZrws9K4bGUkza2r70PYOaHs6Bv13Un8BvvXHsA=="><successful>true</successful>
            </return>
        </ns2:doTransactionResponse>
    <INPUT TYPE="hidden" NAME="TermUrl" VALUE</soap:Body>
</soap:Envelope>

Anchor

	response_with_fraud_challenge
	response_with_fraud_challenge

Top

Code Block

language	xml
title	RESPONSE - Credit Card: PAYMENT or RESERVE (with Fraud enabled - CHALLENGE)
linenumbers	true

<soap:Envelope xmlns:soap="http://staging.safeshopschemas.coxmlsoap.zaorg/s2ssoap/Secure3Denvelope/Encode_Finish.asp">
    <soap:Body>
           <INPUT TYPE="hidden" NAME="MD" VALUE="37117846<ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
                </table>
                <center><p><font type="Arial" size=2>Transfering to your bank for credit card authentication.<return>
                <displayMessage>Successful</displayMessage>
      <p> If you are not redirected please <a href="javascript:AutoSubmitForm()">click here</a> on<fraud>
the image to continue to access your banking             <resultCode>V035</resultCode>
   institution.<p>                 <input type="image" src="http://staging.images.safeshop.co.za/PaymentMethods/Secure3D/VbyV_blue_120x69.gif" name="continue"<resultMessage>CHALLENGE - 0330</resultMessage>
                value="Continue"></center></fraud>
                <<merchantReference>mercRef_1403098425</form>merchantReference>
                <script language="Javascript"><payUReference>185878360665</payUReference>
                 <!--<paymentMethodsUsed xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns2:creditCard">
                function AutoSubmitForm() {document.downloadForm.submit();  <amountInCents>7215</amountInCents>
              }      <cardExpiry>012015</cardExpiry>
          AutoSubmitForm();          <cardNumber>542028******1323</cardNumber>
      //--></script>]]></secure3DUrl>                 </secure3D>
<gatewayReference>37585978</gatewayReference>
           <successful>true</successful>         <<information>MASTERCARD</return>information>
    </ns2:doTransactionResponse>     </soap:Body>
</soap:Envelope>

...

Top

Code Block

language	xml
title	RESPONSE - Credit Card: PAYMENT or RESERVE (with bank reference)
linenumbers	true

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>           <nameOnCard>John Doe</nameOnCard>
                </paymentMethodsUsed>
               <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/"> <resultCode>00</resultCode>
                <resultMessage>Successful</resultMessage>
   <return>             <resultCode>00<<successful>true</resultCode>successful>
            <resultMessage>Successful</resultMessage></return>
        </ns2:doTransactionResponse>
        <successful>true</successful>
            <displayMessage>Successful</displayMessage>
            <merchantReference>1234567890</merchantReference>
            <payUReference>21976214819</payUReference>
    </soap:Body>
</soap:Envelope>

Anchor

	response_with_fraud_deny
	response_with_fraud_deny

Top

Code Block

language	xml
title	RESPONSE - Credit Card: PAYMENT or RESERVE (with Fraud enabled - DENY)
linenumbers	true

<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>           <fraud>
    <cardExpiry>122015</cardExpiry>                <cardNumber>400000******1000</cardNumber><resultCode>V039</resultCode>
                    <gatewayReference>37149772</gatewayReference><resultMessage>DENY - 0700</resultMessage>
                <information>VISA<</information>fraud>
               <nameOnCard>John Doe<<merchantReference>mercRef_1403098545</nameOnCard>merchantReference>
            </paymentMethodsUsed>    <payUReference>185879181093</payUReference>
         <customFields>       <resultCode>P044</resultCode>
         <key>bankReference</key>       <resultMessage>Rejected for fraud</resultMessage>
      <value>DEMO12</value>          <successful>false</successful>
  </customFields>          </return>
     Â <   </ns2:doTransactionResponse>
    </soap:Body>
</soap:Envelope>

Anchor

	response_witheBucks_fraud_approvePAYMENT
	response_witheBucks_fraud_approvePAYMENT

Top

Code Block

language	xml
title	RESPONSE - Credit Card: PAYMENT or RESERVE (with Fraud enabled - APPROVEeBucks (PAYMENT)
linenumbers	true

<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>
            <displayMessage>Successful<<resultMessage>Successful</displayMessage>resultMessage>
            <successful>true</successful>
    <fraud>        <displayMessage>Successful</displayMessage>
            <resultCode>V030</resultCode><merchantReference>1234567890</merchantReference>
            <payUReference>21976214819</payUReference>
            <paymentMethodsUsed   <resultMessage>Success</resultMessage>xsi:type="ns2:ebucks" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <<amountInCents>12000</fraud>amountInCents>
                <merchantReference>mercRef_1403097874</merchantReference></paymentMethodsUsed>
         </return>
      <payUReference>185871924286<</payUReference>ns2:doTransactionResponse>
                <paymentMethodsUsed xmlns:xsi</soap:Body>
</soap:Envelope>

Anchor

	response_EFTPro_payment
	response_EFTPro_payment

Top

Code Block

language	xml
title	RESPONSE - EFTPro payment
linenumbers	true

<soap:Envelope xmlns:soap="http://wwwschemas.w3xmlsoap.org/soap/2001/XMLSchema-instance" xsi:type="ns2:creditCardenvelope/">
   <soap:Body>
      <ns2:doTransactionResponse xmlns:ns2="http://soap.api.controller.web.payjar.com/">
        <amountInCents>2156</amountInCents> <return>
            <merchantReference>EFT_PRO_98453984398</merchantReference>
      <cardExpiry>012015</cardExpiry>      <payUReference>53390698880</payUReference>
            <paymentMethodsUsed  <cardNumber>542028******1323</cardNumber>xsi:type="ns2:eft" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                    <gatewayReference>37585977</gatewayReference><amountInCents>100</amountInCents>
            </paymentMethodsUsed>
       <information>MASTERCARD</information>     <redirect>
               <nameOnCard>John Doe</nameOnCard><method>HTTP_GET</method>
                </paymentMethodsUsed><type>EFT_PRO</type>
                <resultCode>00</resultCode><url>http://localhost:8080/PayJarWeb/redirectGet.do?PayUReference=53390698880</url>
                <resultMessage>Successful</resultMessage></redirect>
                <successful>true</successful>
 
          </return>
        </ns2:doTransactionResponse>
    </soap:Body>
</soap:Envelope>

Versions Compared

Old Version 53

New Version Current

Key