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

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

Anchor

	response_without_bank_ref
	response_without_bank_ref

Top

Code Block

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

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <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>           <amountInCents>12000</amountInCents><resultMessage>Successful</resultMessage>
          <cardExpiry>122014</cardExpiry>           <cardNumber>4111120000005078</cardNumber><successful>true</successful>
          <cvv>123</cvv>  <displayMessage>Successful</displayMessage>
        <nameOnCard>Fred Fraud</nameOnCard>   <merchantReference>1234567890</merchantReference>
       <verified/>     <payUReference>21976214819</payUReference>
   </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â€�><paymentMethodsUsed xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <AdditionalInformation>         <merchantReference>CJR001</merchantReference><amountInCents>1000</amountInCents>
               <<cardExpiry>122015</AdditionalInformation>cardExpiry>
      <Customer>         <mobile>27827891249</mobile><cardNumber>400000******1000</cardNumber>
               </Customer><gatewayReference>37149772</gatewayReference>
              <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

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

: 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>.controller.web.payjar.com/">
        <return>
   <TransactionType>PAYMENT</TransactionType>         <displayMessage>Transaction Pending 3DS  <AuthenticationType>NA<Completion</AuthenticationType>displayMessage>
            <AdditionalInformation><fraud>
                <merchantReference>MerchRef001<<resultCode>V030</merchantReference>resultCode>
                <supportedPaymentMethods>CREDITCARD<<resultMessage>Success</supportedPaymentMethods>resultMessage>
                <storePaymentMethod>true</storePaymentMethod></fraud>
            <<merchantReference>0123456789</AdditionalInformation>merchantReference>
            <Customer><payUReference>31982857915</payUReference>
            <paymentMethodsUsed    <countryCode>27</countryCode>xsi:type="ns2:creditCard" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <merchantUserId>MechUser001<<amountInCents>350</merchantUserId>amountInCents>
                <email>name.surname@mail.com</email><cardExpiry>092014</cardExpiry>
                <firstName>Name</firstName><cardNumber>456546******6016</cardNumber>
                <lastName>Surname<<gatewayReference>37117846</lastName>gatewayReference>
                <mobile>27887592452<<information>VISA</mobile>information>
                <regionalId>2345679888</regionalId>
            </Customer><nameOnCard>Jon Doe </nameOnCard>
            <Basket></paymentMethodsUsed>
                <amountInCents>1000</amountInCents><resultCode>P3DS</resultCode>
            <resultMessage>Transaction Pending 3DS  <currencyCode>ZAR<Completion</currencyCode>resultMessage>
                <description>Goods</description>
         <secure3D>
  </Basket>             <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 TYPE="hidden" NAME="TransactionID" value="A5ufG1Q3sp3qGDxu5de3">
       <nameOnCard>N Surname</nameOnCard>        <INPUT TYPE="hidden" NAME="PaReq"
  </Creditcard>         </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="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>          <AdditionalInformation> <INPUT TYPE="hidden" NAME="TermUrl" VALUE="http://staging.safeshop.co.za/s2s/Secure3D/Encode_Finish.asp">
      <merchantReference>MerchRef001</merchantReference>           <supportedPaymentMethods>CREDITCARD</supportedPaymentMethods>
 <INPUT TYPE="hidden" 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  </Customer>
type="image" src="http://staging.images.safeshop.co.za/PaymentMethods/Secure3D/VbyV_blue_120x69.gif" name="continue"
        <Basket>        value="Continue"></center>
    <amountInCents>1000</amountInCents>             <currencyCode>ZAR<</currencyCode>form>
            <description>Goods</description>     <script language="Javascript">
    </Basket>            <!--
     <Creditcard           function  <pmId>DyZ7XBB5QxF5FEoIADAkMCQAUnlDEmIRVXNTa3xUYVUWfEUT</pmId>AutoSubmitForm() {document.downloadForm.submit();
            <amountInCents>1000</amountInCents>    }
        <cvv>123</cvv>        AutoSubmitForm();
 </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="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

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

<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

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>
        <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

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/"><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

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

<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

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>
           </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

language	xml
title	RESPONSE - eBucks (PAYMENT)
linenumbers	true

<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

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

<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

language	xml
title	RESPONSE - EFTPro payment
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>     <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>

...

Versions Compared

Old Version 49

New Version Current

Key