Get Transaction Status

Suggest Edits

14.Get Transaction Status

Velocity exposes an API for retrieving the transaction status based on the transaction ID and session status based on session ID. This API is useful to reverify a transaction status when, for example, the authorize API does not show a response because of network issues or after redirection flow.

Note: Consider the following items:

  • CPD recommends integrating the Get Status API, which is optional.
  • You can configure this API to view the transaction status on your web portal or on your server.

Refer to transaction Status Codes for details

You can use the following API to get the payment summary information:

Path NamePath Details
End Point[Velocity URL]/mpoint/get-transaction-status
Format/Content Typetext/xml
AuthenticationHTTP basic access authentication

14.1 Request

The following is an example for fetching 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>

The following is an example for fetching 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>

The parameters are listed and defined in the table below.

ParameterTypeRequiredDescription
Client-idStringYesA unique ID for Velocity, which CPD creates for a merchant.
account-idStringYesThe ID or number for a sub-account with which a payment transaction is associated. CPD provides the account number.
transaction-idStringYesCPD Transaction ID for which status is requested.

14.2 Response

The following are examples of a response for the Get Transaction Status API:

14.2.1 Card Payment Transaction Status

<?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 conversationRate="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>
        <card-expiry>10/23</card-expiry>
        <card-name>Master Card</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>8060858</postal-code>
            <city>Pune</city>
            <state>MH</state>
            <country>
                <name>Philippines</name>
                <code>608</code>
                <alpha2code>PH</alpha2code>
                <alpha3code>PHL</alpha3code>
            </country>
        </address>
    </transaction>
</root>

14.2.2 APM (PayPal) Transaction Status

<?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 conversationRate="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>

14.2.3 APM (GRAB PAY) Transaction Status

<?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 conversationRate="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>

14.2.4 Split Payment Session Status

<?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 conversationRate="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>Master Card</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>e9e738e8e781c600de232d1b4bbcb640</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">6146073de014b302c4d2f6b5a1cb81da4ace9fd166ed9bc62eb3b513b087c45a80c654952e8b2dd5ca0e141a0e4b04f0741f274a6f5ab9fde0fcf4701264979e</param>
            <param name="card-holder-name">Chris Harris</param>
            <param name="pre_auth_ext_id">6533916842106908704010</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>Rohan</first-name>
            <last-name>Deo</last-name>
            <street>141/2 Andul test</street>
            <street2 />
            <postal-code>711103</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="654321" card-id="8" clientid="10101" extid="000000033710000442600000100001" id="5297501" language="en" mpoint-id="5297501" order-no="QLG763" payment-method-id="1" psp-id="21" session-id="533234" session-type="2" txn-type-id="1" walletid="-1">
        <amount conversationRate="1" country-id="405" currency="170" currency-code="COP" decimals="2" format="" pending="0" symbol="$">80000000</amount>
        <card-mask>451307******5348</card-mask>
        <card-expiry>10/23</card-expiry>
        <card-name>VISA</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>
mobile>
            <email>[email protected]</email>
        </address>
    </transaction>        <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:28:17</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>d3fb3b3156f825de5afd0b80047493ef</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">6146073de014b302c4d2f6b5a1cb81da4ace9fd166ed9bc62eb3b513b087c45a80c654952e8b2dd5ca0e141a0e4b04f0741f274a6f5ab9fde0fcf4701264979e</param>
            <param name="card-holder-name">Chris Harris</param>
            <param name="pre_auth_ext_id">6533917086316951404009</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>Rohan</first-name>
            <last-name>Deo</last-name>
            <street>141/2 Andul test</street>
            <street2 />
            <postal-code>711103</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</
    <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 conversationRate="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>d331679f5a42d4579bb375e6d5034ac7</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.1627877376</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 conversationRate="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>0eddfdf2f525a316cc15846c42684b12</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.1627877376</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 conversationRate="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>ef2023d31ff47087730d42c83992f3c3</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.1627877376</param>
            <param name="office_id">BOGAV08AK</param>
        </additional-data>
    </transaction>
</root>

Updated about 1 year ago