Refund (Return)

This API call let's you process a refund. The response is an XML of the processed refund.

Request Fields

Field Name	Type	Required	Description
transactionType	String	Yes	refund
accountId	Integer	Yes	The Helcim Commerce account ID.
apiToken	String	Yes	API token used for authentication and access control.
amount	Decimal	Yes	The amount of the transaction.
cardHolderName	String	No	The cardholder names.
cardNumber	Integer	Yes	The credit card number.
cardExpiry	Integer	Yes	The credit card expiration date.
cardCVV	Integer	No	The credit card CVV (digits on back of credit card).

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 transaction (Approved/Denied).
notice	String	Error/warning message from Helcim.
transaction	-	XML structure.
transactionId	Integer	The transaction ID.
type	String	The transaction type (purchase, refund, pre-auth, capture).
date	String	The date of the transactions
time	String	The time of the transaction.
cardHolderName	String	The card holder's name.
amount	Decimal	The amount of the transactions.
currency	String	The currency of the transaction.
cardnumber	String	The credit card number (first 4 and last 4 digits only).
cardToken	String	The credit card token.
expiryDate	Integer	The credit card expiry date.
cardType	String	The credit card type (Visa, Mastercard, Amex, Discovery).
avsResponse	String	The address verification response.
cvvResponse	String	The CVV verification response.
approvalCode	String	The approval code.
orderNumber	String	The order number.
customerCode	String	The customer code.

Errors

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

Response Code	Error Code	Message	Description
0	-	Invalid Amount	The transaction amount was not entered.
0	-	Declined - Invalid Card Number Invalid Expiry Date	The credit card number and/or expiry date was not entered or is invalid.

Capture (Force)

Batch Settlement

Response Fields

Void

Pre-Authorization (Preauth) with Customer Code

Preauthorization (Preauth) with Card Token

Refund (Return) with Card Token

Purchase (Sale)

Purchase Using a Card Token

Purchase Using Mag-Data

Purchase Using a Customer Code

Request Fields

Pre-Authorization (Preauth)

Verification - Only

Was this article helpful?

Click here if you return to the content

Code Samples

[XML] Sample Response - Refund Transaction Type

<?xml version="1.0"?>
<message>
    <response>1</response>
    <responseMessage>APPROVED</responseMessage>
    <notice></notice>
    <transaction>
        <transactionId>123038</transactionId>
        <type>refund</type>
        <date>2017-07-07</date>
        <time>11:21:16</time>
        <cardHolderName>John Smith</cardHolderName>
        <amount>10.00</amount>
        <currency>CAD</currency>
        <cardNumber>4242********4242</cardNumber>
        <cardToken>55669d8ec9f8c7e3f5af19</cardToken>
        <expiryDate>1020</expiryDate>
        <cardType>Visa</cardType>
        <avsResponse>X</avsResponse>
        <cvvResponse>M</cvvResponse>
        <approvalCode>T6E5ST</approvalCode>
        <orderNumber>ORDR11731</orderNumber>
        <customerCode>12A1141</customerCode>
    </transaction>
</message>

[HTML] HTML Form Sample

<input type="hidden" name="accountId" value="YOUR-ACCOUNT-ID">
<input type="hidden" name="apiToken" value="YOUR-API-TOKEN">
<input type="hidden" name="transactionType" value="refund">
<input type="hidden" name="amount" value="12.99">
<input type="hidden" name="cardHolderName" value="John Smith">
<input type="hidden" name="cardNumber" value="5454545454545454">
<input type="hidden" name="cardExpiry" value="1020">
<input type="hidden" name="cardCVV" value="100">

Refund (Return)

Request Fields

Response Fields (XML)

Errors

Related Articles

Was this article helpful?