Purchase

Description

API Name

Input

WsbgRequest object:

Field	Status	Format	Description
bankId	M	text	bank id at BG system
bankChannel	M	text	payment channel
bankRefNo	M	text	reference no from bank/merchant
custAccNo	M	text	cust account no at bank/merchant
custId	M	text	bill number to be paid
dateTrx	M	date	date transaction (request)
payeeCode	M	text	payee code
productCode	M	text	product code

Response Parameter

WsbgResponse object:

Field	Status	Format	Description
adminFee	O	numeric	admin fee
bankChannel	M	text	payment channel copy from request
bankId	M	text	bank id at BG system (copy from request)
bankRefNo	M	text	reference no from bank/merchant (copy from request)
billAmt	O	numeric	bill amount
billPeriod	O	text	bill period
billRefNo	O	text	reference no from biller
code	M	numeric	status code : 0 = success 1 = failed 2 = pending
custAccNo	M	text	cust account no at bank / merchant (copy from request)
custId	M	text	bill number to be paid (copy from request)
custName	O	text	customer's name
custRefNo	M	text	reference no from BG
date Trx	M	date	date transaction (response)
description	O	text	product description
kwh	O	text	unit of energy
message	O	text	error message from BG
meterNumber	O	text	meter number
meterStandCubication	O	text	meter stand and cubication
nominalVoucher	M	text	nominal voucher
paidAmt	O	numeric	paid amount (to be debeted = billAmt + adminFee)
payeeCode	M	text	payee code
priceCategorypower	O	text	prices category and power
pricesCategory	O	text	prices category and power
productCode	M	text	product code
resultCode	O	text	2 digit result code
secretCode	O	text	secret code
serialNumber	M	text	serial number
standMeter	O	text	stand meter
tenor	O	text	tenor
token	O	text	token

Use nominalVoucher as base for charging your customer

Example

Request

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns: soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:exp="http://exposed.webservice.pacarana.infinetworks.com">
    <soapenv:Header>
        <authorization xsi:type="xsd:string">xiRlCUxUFsG8tgv6LSzHkpwZgk8Tc/KIdpmkfeVS2oc=</authorization>
        <date xsi:type="xsd:dateTime">Thu, 10 OCT 2019 12:53:03 ICT</date>
    </soapenv:Header>
    <soapenv:Body>
        <exp:purchase soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
            <req xsi:type="pac:WsbgRequest" xmlns:pac="http://pacarana.infinetworks.com">
                <bankId xsi:type="xsd:string">10000001</bankId>
                <bankChannel xsi:type="xsd:string">6017</bankChannel>
                <bankRefNo xsi:type="xsd:string">201910100001</bankRefNo>
                <custAccNo xsi:type="xsd:string">1111111111</custAccNo>
                <custId xsi:type="xsd:string">081100000001</custId>
                <dateTrx xsi:type="xsd:dateTime">2019-10-10T16:50:00Z</dateTrx>
                <payeeCode xsi:type="xsd:string">10002</payeeCode>
                <productCode xsi:type="xsd:string">1007</productCode>
            </req>
        </exp:purchase>
    </soapenv:Body>
</soapenv:Envelope>

Response

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    x mlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soapenv:Body>
        <ns1:purchaseResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
            xmlns:ns1="http://exposed.webservice.pacarana.infinetworks.com">
            <purchaseReturn href="#id0" />
        </ns1:purchaseResponse>
        <multiRef id="id0" soapenc:root="0" soapenv:encodingS tyle="http://schemas.xmlsoap.org/soap/encoding/"
            xsi:type="ns2:WsbgResponse" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
            xmlns:ns2="http://pacarana.infinetworks.com">
            <adminFee xsi:type="xsd:decimal" xsi:nil="true" />
            <bankChannel xsi:type="xsd:string">6017</bankChannel>
            <bankId xsi:type="xsd:string">10000001</bankId>
            <bankRefNo xsi:type="xsd:string">201910100001</bankRefNo>
            <billAmt xsi:type="xsd:decimal" xsi:nil="true" />
            <billPeriod xsi:type="xsd:string" xsi:nil="true" />
            <billRefNo xsi:type="xsd:string" xsi:nil="true" />
            <code xsi:type="xsd:byte">0</code>
            <custAccNo xsi:type="xsd:string">1111111111</custAccNo>
            <custId xsi:type="xsd:string">081100000001</custId>
            <custName xsi:type="xsd:string" xsi:nil="true" />
            <custRefNo xsi:type="xsd:string">000000199380</custRefNo>
            <dateTrx xsi:type="xsd:dateTime">2019-10-10T16:50:00.000Z</dateTrx>
            <description xsi:type="xsd:string" xsi:nil="true" />
            <kwh xsi:type="xsd:string" xsi:nil="true" />
            <message xsi:type="xsd:string" xsi:nil="true" />
            <meterNumber xsi:type="xsd:string" xsi:nil="true" />
            <meterStandCubication xsi:type="xsd:string" xsi:n il="true" />
            <nominalVoucher xsi:type="xsd:string">100000.00</nominalVoucher>
            <paidAmt xsi:type="xsd:decimal" xsi:nil="true" />
            <payeeCode xsi:type="xsd:string">10002</payeeCode>
            <priceCategoryPower xsi:type="xsd:string" xsi:nil="true" />
            <pricesCategory xsi:type="xsd:string" xsi:nil="true" />
            <productCode xsi:type="xsd:string">1007</productCode>
            <resultCode xsi:type="xsd:string" xsi:nil="true" />
            <secretCode xsi:type="xsd:string" xsi:nil="true" />
            <serialNumber xsi:type="xsd:string">004100161011161751</serialNumber>
            <standMeter xsi:type="xsd:string" xsi:nil="true" />
            <tenor xsi:type="xsd:string" xsi:nil="true" />
            <token xsi:type="xsd:string" xsi:nil="true" />
        </multiRef>
    </soapenv:Body>
</soapenv:Envelope>