This page provides API reference information for Velocity API's Get Transaction Status operation (get-transaction-status). See sample code for the operation below, and find parameter descriptions in the Request Parameters and Response Parameters subpages. For information on how to integrate this operation, see API.

Request

Endpoint: /mpoint/get-transaction-status
Method: GET

Code samples of the Get Transaction Status API request are below. For response parameter descriptions, see the Request Parameters subpage.

Transaction Status Request

Below is a sample request for a transaction status:

<?xml version="1.0" encoding="UTF-8"?>
<root>
	<get-transaction-status>
		<client-id>10101</client-id>
		<transactions>
			<transaction-id>5297501</transaction-id>
		</transactions>
	</get-transaction-status>
</root>

Session Status Request

Below is a sample request for a session status:

<?xml version="1.0" encoding="UTF-8"?>
<root>
	<get-transaction-status>
		<client-id>10101</client-id>
		<session_id>533234</session_id>
	</get-transaction-status>
</root>

Response

Velocity API returns a Get Transaction Status (get-transaction-status) response with information about the transaction or the session whose status you have requested.

Code samples of the Get Transaction Status API response are below. For response parameter descriptions, see the following sections in the Response Parameters subpage:

Card Payment Transaction Status

Below is a sample response with the transaction status of a card payment transaction.

<?xml version="1.0" encoding="UTF-8"?>
<root>
	<transaction accoutid="100630" approval-code="121000" card-id="7" clientid="10063" extid="CPM5670_8060858" id="8060858" language="en" mpoint-id="8060858" order-no="CPM5670" payment-method-id="1" psp-id="4" session-id="178752" session-type="" walletid="4">
		<amount conversionRate="1" country-id="103" currency="826" currency-code="GBP" decimals="2" format="{CURRENCY}{PRICE}" pending="0" symbol=" £">1000</amount>
		<card-mask>554433******0003</card-mask>
		<dummy-account-number>5544330000090003</dummy-account-number>
		<card-expiry>10/23</card-expiry>
		<card-name>Mastercard</card-name>
		<psp-name>WorldPay</psp-name>
		<accept-url>https://cpm-hpp2-sit2.cellpointmobile.com/views/redirect_response.php</accept-url>
		<cancel-url>https://cpm-hpp2-sit-01.cellpoint.dev/views/</cancel-url>
		<css-url>https://s3-ap-southeast-1.amazonaws.com/devcpmassets/marchant/et/style.css</css-url>
		<logo-url>https://hpp-uat-02.cellpointmobile.net/css/swag/img/cebu.png</logo-url>
		<google-analytics-id>%7B%22id%22%3A%22GTM-TJHF9HX%22%2C%22auth%22%3A%220bNRJejIX9R
vP164Mor_Tw%22%2C%22preview%22%3A%22env-61%22%2C%22env%22%3A%22sit%22%7D</google-analytics-id>
		<form-method>GET</form-method>
		<auto-redirect>true</auto-redirect>
		<createdDate>2021-03-04</createdDate>
		<createdTime>07:55:32</createdTime>
		<status>
			<status-message id="1001" position="1">Input Valid</status-message>
			<status-message id="1009" position="2">Payment Initialized with Payment Service Provider</status-message>
			<status-message id="1990" position="14">Callback Accepted</status-message>
			<status-message id="1990" position="17">Callback Accepted</status-message>
			<status-message id="1990" position="23">Callback Accepted</status-message>
			<status-message id="1990" position="25">Callback Accepted</status-message>
			<status-message id="1991" position="12">Callback Constructed</status-message>
			<status-message id="1991" position="15">Callback Constructed</status-message>
			<status-message id="1991" position="20">Callback Constructed</status-message>
			<status-message id="1991" position="22">Callback Constructed</status-message>
			<status-message id="1992" position="13">Callback Connected</status-message>
			<status-message id="1992" position="16">Callback Connected</status-message>
			<status-message id="1992" position="21">Callback Connected</status-message>
			<status-message id="1992" position="24">Callback Connected</status-message>
			<status-message id="2000" position="9">Payment authorized by PSP</status-message>
			<status-message id="2001" position="18">Payment captured by PSP</status-message>
			<status-message id="2005" position="5">3d verification required for Authorization</status-message>
			<status-message id="2006" position="7">3d verification successful</status-message>
			<status-message id="3010" position="3">Pre Auth Initiated</status-message>
			<status-message id="3014" position="4">Pre Auth Review</status-message>
			<status-message id="3117" position="10">Post Auth Screen Skip - Business Rules</status-message>
			<status-message id="4030" position="19">Session Complete</status-message>
			<status-message id="20012" position="11">Capture Initialized</status-message>
			<status-message id="2005001" position="6">Authentication Card is enrolled Attempt authentication using 3DSv1.0</status-message>
			<status-message id="2006001" position="8">Authentication Fully</status-message>
		</status>
		<sign>8aabe019e70972acaddb0bc09101e35e</sign>
		<client-info language="en" platform="app" profileid="-1">
			<mobile country-id="640" operator-id="64000">9876543210</mobile>
			<email>[email protected]</email>
			<customer-ref/>
			<device-id/>
		</client-info>
		<additional-data>
			<param name="pre_auth_ext_status_code">105</param>
			<param name="eci">02</param>
			<param name="xid">MDAwMDAwMDAwMDAwMDgwNjA4NTg=</param>
			<param name="merchant">CELLPOINT</param>
			<param name="issuer-approval-code">121000</param>
		</additional-data>
		<address>
			<first-name>Test</first-name>
			<last-name>Automation</last-name>
			<street>MyStreet</street>
			<street2/>
			<postal-code>99999</postal-code>
			<city>Test City</city>
			<state>MH</state>
			<country>
				<name>Philippines</name>
				<code>608</code>
				<alpha2code>PH</alpha2code>
				<alpha3code>PHL</alpha3code>
			</country>
		</address>
	</transaction>
</root>

PayPal Transaction Status

Below is a sample response with the transaction status of a payment using PayPal.

<?xml version="1.0" encoding="UTF-8"?>
<root>
	<transaction accoutid="100770" approval-code="" card-id="28" clientid="10077" extid="69U82640BX0039150" id="8059428" language="en" mpoint-id="8059428" order-no="WAIKALZ" payment-method-id="4" psp-id="24" session-id="177544" session-type="" walletid="0">
		<amount conversionRate="1" country-id="640" currency="608" currency-code="PHP" decimals="2" format="" pending="0" symbol="â±">55500</amount>
		<card-name>PayPal</card-name>
		<psp-name>PayPal</psp-name>
		<accept-url>https://hpp2.sit-01.cellpoint.dev/views/redirect_response.php</accept-url>
		<cancel-url>https://hpp2.sit-01.cellpoint.dev/views/redirect_response.php</cancel-url>
		<css-url>https://cpd-hpp2-devassests.s3.eu-central-1.amazonaws.com/10077</css-url>
		<logo-url>https://cpd-hpp2-devassests.s3.eu-central-1.amazonaws.com/10077/logo.png</logo-url>
		<google-analytics-id>%7B%22id%22%3A%22GTM-TJHF9HX%22%2C%22auth%22%3A%220bNRJejIX9RvP164Mor
_Tw%22%2C%22preview%22%3A%22env-61%22%2C%22env%22%3A%22sit%22%7D</google-analytics-id>
		<form-method>GET</form-method>
		<auto-redirect>true</auto-redirect>
		<createdDate>2021-02-27</createdDate>
		<createdTime>06:34:04</createdTime>
		<status>
			<status-message id="2001" position="1">Payment captured by PSP</status-message>
		</status>
		<sign>bf2f4194205c9839e67547b860c4a05b</sign>
		<client-info language="en" platform="spa" profileid="CEBUPROFILE123">
			<mobile country-id="640" operator-id="64000">2147483647</mobile>
			<email>[email protected]</email>
			<customer-ref>[email protected]</customer-ref>
			<device-id/>
		</client-info>
		<additional-data>
			<param name="invoiceid">8059428</param>
		</additional-data>
	</transaction>
</root>

GrabPay Transaction Status

Below is a sample response with the transaction status of a payment using GrabPay.

<?xml version="1.0" encoding="UTF-8"?>
<root>
	<transaction accoutid="100770" approval-code="" card-id="28" clientid="10077" extid="69U82640BX0039150" id="8059428" language="en" mpoint-id="8059428" order-no="WAIKALZ" payment-method-id="4" psp-id="24" session-id="177544" session-type="" walletid="0">
		<amount conversionRate="1" country-id="640" currency="608" currency-code="PHP" decimals="2" format="" pending="0" symbol="â±">55500</amount>
		<card-name>PayPal</card-name>
		<psp-name>PayPal</psp-name>
		<accept-url>https://hpp2.sit-01.cellpoint.dev/views/redirect_response.php</accept-url>
		<cancel-url>https://hpp2.sit-01.cellpoint.dev/views/redirect_response.php</cancel-url>
		<css-url>https://cpd-hpp2-devassests.s3.eu-central-1.amazonaws.com/10077</css-url>
		<logo-url>https://cpd-hpp2-devassests.s3.eu-central-1.amazonaws.com/10077/logo.png</logo-url>
		<google-analytics-id>%7B%22id%22%3A%22GTM-TJHF9HX%22%2C%22auth%22%3A%220bNRJejIX9RvP164Mor
_Tw%22%2C%22preview%22%3A%22env-61%22%2C%22env%22%3A%22sit%22%7D</google-analytics-id>
		<form-method>GET</form-method>
		<auto-redirect>true</auto-redirect>
		<createdDate>2021-02-27</createdDate>
		<createdTime>06:34:04</createdTime>
		<status>
			<status-message id="2001" position="1">Payment captured by PSP</status-message>
		</status>
		<sign>bf2f4194205c9839e67547b860c4a05b</sign>
		<client-info language="en" platform="spa" profileid="CEBUPROFILE123">
			<mobile country-id="640" operator-id="64000">2147483647</mobile>
			<email>[email protected]</email>
			<customer-ref>[email protected]</customer-ref>
			<device-id/>
		</client-info>
		<additional-data>
			<param name="invoiceid">8059428</param>
		</additional-data>
	</transaction>
</root>

Split Payment Session Status

Below is a sample response with the session status of a split payment session.

<?xml version="1.0" encoding="UTF-8"?>
<root>
	<session id="533234" total-amount="160000000" type="2">
		<amount alpha2code="CO" alpha3code="COL" code="170" country-id="405" currency="COP" currency-id="170" format="" symbol="$">0</amount>
		<status>4030</status>
	</session>
	<transaction accoutid="101011" approval-code="654321" card-id="7" clientid="10101" extid="000000033710000442590000100001" id="5297500" language="en" mpoint-id="5297500" order-no="QLG763" payment-method-id="1" psp-id="21" session-id="533234" session-type="2" txn-type-id="1" walletid="-1">
		<amount conversionRate="1" country-id="405" currency="170" currency-code="COP" decimals="2" format="" pending="0" symbol="$">80000000</amount>
		<card-mask>530371******8783</card-mask>
		<card-expiry>10/23</card-expiry>
		<card-name>Mastercard</card-name>
		<psp-name>GlobalCollect</psp-name>
		<accept-url>https://hpp2.sit-01.cellpoint.dev/views/redirect_response.php</accept-url>
		<cancel-url>https://hpp2.sit-01.cellpoint.dev/views/redirect_response.php</cancel-url>
		<css-url>https://cpd-hpp2-devassests.s3.eu-central-1.amazonaws.com/10101</css-url>
		<logo-url>https://cpd-hpp2-devassests.s3.eu-central-1.amazonaws.com/10101/logo.png</logo-url>
		<google-analytics-id>GTM-WPHV68Z</google-analytics-id>
		<form-method/>
		<auto-redirect>true</auto-redirect>
		<createdDate>2022-05-24</createdDate>
		<createdTime>11:27:53</createdTime>
		<status>
			<status-message id="3011" position="1">Pre Auth Success</status-message>
			<status-message id="2001" position="2">Payment captured by PSP</status-message>
		</status>
		<sign>e99999e8e781c600de232d1b4bbcb444</sign>
		<client-info language="en" platform="spa" profileid="-1">
			<mobile country-id="405" operator-id="40500">9377178759</mobile>
			<email>[email protected]</email>
			<customer-ref>[email protected]</customer-ref>
			<device-id/>
		</client-info>
		<additional-data>
			<param name="hmac">611111111114b302c4d2f6b5a1cb81da4ace9fd166ed9bc62eb3b513b087c45a80c654952e8b2dd5ca0e141a0e4b04f0741f274a6f5ab9fde0fcf4701264979e</param>
			<param name="card-holder-name">Test Name</param>
			<param name="pre_auth_ext_id">6533916842106908777777</param>
			<param name="pre_auth_ext_status_code">100</param>
			<param name="Response_Code">800</param>
			<param name="hold_fee_amount">2300</param>
			<param name="hold_fee_currency_code">COP</param>
			<param name="platform">WEBB2C</param>
			<param name="_ga">2.168694248.833265534.1632121657-2073837615.1627877376</param>
			<param name="office_id">BOGAV08AK</param>
		</additional-data>
		<address>
			<first-name>First</first-name>
			<last-name>Last</last-name>
			<street>123 Test St.</street>
			<street2/>
			<postal-code>711111</postal-code>
			<city>Kolkata</city>
			<state>Maharastra</state>
			<country>
				<name>Colombia</name>
				<code>170</code>
				<alpha2code>CO</alpha2code>
				<alpha3code>COL</alpha3code>
			</country>
			<mobile idc="63">9898989898</mobile>
			<email>[email protected]</email>
		</address>
	</transaction>
	<transaction accoutid="101011" approval-code="" card-id="0" clientid="10101" extid="" id="5310635" language="gb" mpoint-id="5310635" order-no="" payment-method-id="1" psp-id="0" session-id="533234" session-type="2" txn-type-id="40" walletid="-1">
		<amount conversionRate="1" country-id="405" currency="170" currency-code="COP" decimals="2" format="" pending="0" symbol="$">0</amount>
		<card-name>System Record</card-name>
		<psp-name>System Record</psp-name>
		<accept-url/>
		<cancel-url/>
		<css-url>https://cpd-hpp2-devassests.s3.eu-central-1.amazonaws.com/10101</css-url>
		<logo-url>https://cpd-hpp2-devassests.s3.eu-central-1.amazonaws.com/10101/logo.png</logo-url>
		<google-analytics-id>GTM-WPHV68Z</google-analytics-id>
		<form-method/>
		<auto-redirect>true</auto-redirect>
		<createdDate>2022-05-31</createdDate>
		<createdTime>10:26:48</createdTime>
		<status/>
		<sign>d33333333a42d4579bb375e6d5034ac7</sign>
		<client-info language="gb" platform="">
			<mobile country-id="0" operator-id="0"/>
			<email/>
			<customer-ref/>
			<device-id/>
		</client-info>
		<additional-data>
			<param name="hold_fee_amount">2300</param>
			<param name="hold_fee_currency_code">COP</param>
			<param name="platform">WEBB2C</param>
			<param name="_ga">2.168694248.833265534.1632121657-2073837615</param>
			<param name="office_id">BOGAV08AK</param>
		</additional-data>
	</transaction>
	<transaction accoutid="101011" approval-code="" card-id="0" clientid="10101" extid="" id="5326993" language="gb" mpoint-id="5326993" order-no="" payment-method-id="1" psp-id="0" session-id="533234" session-type="2" txn-type-id="40" walletid="-1">
		<amount conversionRate="1" country-id="405" currency="170" currency-code="COP" decimals="2" format="" pending="0" symbol="$">0</amount>
		<card-name>System Record</card-name>
		<psp-name>System Record</psp-name>
		<accept-url/>
		<cancel-url/>
		<css-url>https://cpd-hpp2-devassests.s3.eu-central-1.amazonaws.com/10101</css-url>
		<logo-url>https://cpd-hpp2-devassests.s3.eu-central-1.amazonaws.com/10101/logo.png</logo-url>
		<google-analytics-id>GTM-WPHV68Z</google-analytics-id>
		<form-method/>
		<auto-redirect>true</auto-redirect>
		<createdDate>2022-06-09</createdDate>
		<createdTime>20:17:34</createdTime>
		<status/>
		<sign>0edddddddd25a316cc15846c42684b12</sign>
		<client-info language="gb" platform="">
			<mobile country-id="0" operator-id="0"/>
			<email/>
			<customer-ref/>
			<device-id/>
		</client-info>
		<additional-data>
			<param name="hold_fee_amount">2300</param>
			<param name="hold_fee_currency_code">COP</param>
			<param name="platform">WEBB2C</param>
			<param name="_ga">2.168694248.833265534.1632121657-2073837615</param>
			<param name="office_id">BOGAV08AK</param>
		</additional-data>
	</transaction>
	<transaction accoutid="101011" approval-code="" card-id="0" clientid="10101" extid="" id="5388333" language="gb" mpoint-id="5388333" order-no="" payment-method-id="1" psp-id="0" session-id="533234" session-type="2" txn-type-id="40" walletid="-1">
		<amount conversionRate="1" country-id="405" currency="170" currency-code="COP" decimals="2" format="" pending="0" symbol="$">0</amount>
		<card-name>System Record</card-name>
		<psp-name>System Record</psp-name>
		<accept-url/>
		<cancel-url/>
		<css-url>https://cpd-hpp2-devassests.s3.eu-central-1.amazonaws.com/10101</css-url>
		<logo-url>https://cpd-hpp2-devassests.s3.eu-central-1.amazonaws.com/10101/logo.png</logo-url>
		<google-analytics-id>GTM-WPHV68Z</google-analytics-id>
		<form-method/>
		<auto-redirect>true</auto-redirect>
		<createdDate>2022-07-11</createdDate>
		<createdTime>21:07:58</createdTime>
		<status/>
		<sign>ef2222222ff47087730d42c83992f3c3</sign>
		<client-info language="gb" platform="">
			<mobile country-id="0" operator-id="0"/>
			<email/>
			<customer-ref/>
			<device-id/>
		</client-info>
		<additional-data>
			<param name="hold_fee_amount">2300</param>
			<param name="hold_fee_currency_code">COP</param>
			<param name="platform">WEBB2C</param>
			<param name="_ga">2.168694248.833265534.1632121657-2073837615</param>
			<param name="office_id">BOGAV08AK</param>
		</additional-data>
	</transaction>
</root>