Helcim Commerce API » Processing Payments » Misc Payments »

Debit Card (External) Transaction

This API call let's you process a debit card (external) transaction. The response is an XML of the debit card (external) transaction.

Request Fields

Field Name	Type	Required	Description
transactionOtherType	String	Yes	debitCard
accountId	Integer	Yes	The Helcim Commerce account ID.
apiToken	String	Yes	API token used for authentication and access control.
orderNumber	Integer	Yes	The order number.
amount	Decimal	No	The transaction amount.
currency	String	Yes	The transaction currency.

Response Fields (XML)

Field Name	Type	Description
message	-	XML structure
response	Integer	1 or 0. Whether the transaction was approved or declined.
responseMessage	String	Result of debit card (external) transaction.
transactionOther	-	XML structure
id	String	The transaction ID
ternderType	String	The tender type used (cash, check, bank transfer, cash on delivery, credit card (external) transaction, debit card (external) transaction, misc).
date	String	The date of the transactions
time	String	The time of the transaction.
amount	Decimal	The amount of the transactions.
currency	String	The transaction currency.

Errors

For all API requests, there are also generic API authentication and user access restriction errors.

Response Code	Error Code	Message	Description
0	-	Missing Fields - Currency	The currency field was not entered.
0	-	Missing Order Number	The order number is missing.

Code Samples

XML Sample TransactionOtherType Debit Card (External) Response

HTML HTML Form Sample

Sample TransactionOtherType Debit Card (External) Response XML

<?xml version="1.0"?>
<message>
    <response>1</response>
    <responseMessage>New Transaction Created - Order Status: Paid</responseMessage>
    <transactionOther>
        <id>54506</id>
        <tenderType>Debit Card (External)</tenderType>
        <date>2017-07-07</date>
        <time>13:44:45</time>
        <amount>12.99</amount>
        <currency>CAD</currency>
    </transactionOther>
</message>

HTML Form Sample HTML

<input type="hidden" name="accountId" value="YOUR-ACCOUNT-ID">
<input type="hidden" name="apiToken" value="YOUR-API-TOKEN">
<input type="hidden" name="transactionOtherType" value="debitCard">
<input type="hidden" name="amount" value="12.99">
<input type="hidden" name="currency" value="CAD">