Making Payments

To process a subsequent payment using a Token/Customer Number that has already been registered within Bambora, you can stream the following API requests through to Bambora and receive a response for each transaction in real time.

Payments on Registered Customer Number

SOAP Method: SubmitSinglePayment

POSThttps://demo.bambora.co.nz/interface/api/dts.asmx

Example 1 - Credit card payment on registered Customer Number

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:dts="http://www.ippayments.com.au/interface/api/dts">
<soapenv:Header/>
<soapenv:Body>
<dts:SubmitSinglePayment>
<dts:trnXML>
<![CDATA[
<Transaction>
      <CustomerStorageNumber>your_customerstoragenumber</CustomerStorageNumber>
      <CustNumber>your_custnumber</CustNumber>
      <CustRef>your_custref</CustRef>
      <Amount>1000</Amount>
      <TrnType>1</TrnType>
      <AccountNumber>your_accountnumber</AccountNumber>
      <CreditCard Registered="True"></CreditCard>
      <Security>
                  <UserName>your_api_username</UserName>
                  <Password>your_api_password</Password>
      </Security>
</Transaction>
]]>    
</dts:trnXML>
</dts:SubmitSinglePayment>
</soapenv:Body>
</soapenv:Envelope>

Example 2 - Direct debit payment on registered Customer Number

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:dts="http://www.ippayments.com.au/interface/api/dts">
<soapenv:Header/>
<soapenv:Body>
<dts:SubmitSinglePayment>
<dts:trnXML>
<![CDATA[
<Transaction>
      <CustomerStorageNumber>your_customerstoragenumber</CustomerStorageNumber>
      <CustNumber>your_custnumber</CustNumber>
      <CustRef>your_custref</CustRef>
      <Amount>1000</Amount>
      <TrnType>7</TrnType>
      <AccountNumber>your_accountnumber</AccountNumber>
      <DirectEntry Registered="True"></DirectEntry>
      <Security>
                  <UserName>your_api_username</UserName>
                  <Password>your_api_password</Password>
      </Security>
</Transaction>
]]>    
</dts:trnXML>
</dts:SubmitSinglePayment>
</soapenv:Body>
</soapenv:Envelope>

RESPONSE

<Response>
    <ResponseCode>0</ResponseCode>
    <Timestamp>23-Feb-2017 16:06:41</Timestamp>
    <Receipt>90891389</Receipt>
    <SettlementDate>23-Feb-2017</SettlementDate>
    <DeclinedCode></DeclinedCode>
    <DeclinedMessage></DeclinedMessage>
</Response>

For further details on the API parameters, please refer to Payment API.

Payments on Token

SOAP Method: SubmitSinglePayment

POSThttps://demo.bambora.co.nz/interface/api/dts.asmx

Example 1 - Credit card payment on existing Token

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:dts="http://www.ippayments.com.au/interface/api/dts">
<soapenv:Header/>
<soapenv:Body>
<dts:SubmitSinglePayment>
<dts:trnXML>
<![CDATA[
<Transaction>
      <CustomerStorageNumber>your_customerstoragenumber</CustomerStorageNumber>
      <CustNumber>your_custnumber</CustNumber>
      <CustRef>your_custref</CustRef>
      <Amount>1000</Amount>
      <TrnType>1</TrnType>
      <AccountNumber>your_accountnumber</AccountNumber>
      <CreditCard>
            <TokeniseAlgorithmID>2</TokeniseAlgorithmID>
            <CardNumber>9660066265305097</CardNumber>
      </CreditCard>
      <Security>
            <UserName>your_api_username</UserName>
            <Password>your_api_password</Password>
      </Security>
</Transaction>
]]>    
</dts:trnXML>
</dts:SubmitSinglePayment>
</soapenv:Body>
</soapenv:Envelope>

RESPONSE

<Response>
    <ResponseCode>0</ResponseCode>
    <Timestamp>23-Feb-2017 16:06:41</Timestamp>
    <Receipt>90127302</Receipt>
    <SettlementDate>23-Feb-2017</SettlementDate>
    <DeclinedCode></DeclinedCode>
    <DeclinedMessage></DeclinedMessage>
    <CreditCardToken>9660066265305097</CreditCardToken>
    <TruncatedCard>123456******1234</TruncatedCard>
    <ExpM>02</ExpM>
    <ExpY>2019</ExpY>
    <CardType>Visa</CardType>
</Response>

For further details on the API parameters, please refer to Payment API.