v1

latestOpenAPI 3.0.02026-07-2671142187.3 KB

Payment

Process a Refund Transaction

post/payment/refund

Headers

idempotency-keystring uuid required

A UUID-formatted idempotency key. Accepted format is 25-36 alphanumeric characters (including '-' and '_').

Request body

originalTransactionIdinteger required

The transaction ID of the purchase/capture transaction. In-person debit transactions cannot be refunded through payment API

amountnumber required

The amount to refund. Must be less or equal to the original purchase/capture amount.

ipAddressstring required

IP address of the customer making the transaction, used as part of fraud detection.

ecommerceboolean

Set to indicate that the transaction is e-commerce. When set, the Helcim Fraud Defender will provide further analysis.

Example request

{
  "originalTransactionId": 198763,
  "amount": 100.99,
  "ipAddress": "192.168.1.1",
  "ecommerce": true
}

Response

Successful

transactionIdnumber

The transaction id

cardBatchIdnumber

The id of associated card batch

dateCreatedstring

The date(Mountain Time) when the transaction is created.

statusstring

The status of the transaction. possible values are APPROVED | DECLINED

userstring

Full name of the user who processed the transaction. Default value is Helcim System

typestring

The type of the transaction. possible values are purchase | preauth | verify

amountnumber

The amount of processed transaction

currencystring

The abbreviation of the transaction's currency

avsResponsestring

AVS Response

cvvResponsestring

CVV Response

cardTypestring

Abbreviated card issuer name

VI - Visa
MC - MasterCard
AX - American Express
DI - Discover
DCI - Diners Club
JCB - JCB
UP - China Union Pay
MR - Maestro
AF - AFFN
AO - Alaska Option
CU - Credit Union 24
EB - EBT Network
EX - Accel
IL - Interlink
NT - Nets
NY - NYCE
PS - Pulse
ST - Star
SZ - Shazam
AT - ATH
IN - Interac
DB - Debit

approvalCodestring

Approval Code

cardTokenstring

Card token associated to the transaction

cardNumberstring

First-6 Last-4 numbers of the card number associated to the transaction

cardHolderNamestring

Cardholdername associated to the transaction

customerCodestring

Customer code associated to the transaction

invoiceNumberstring

Invoice number associated to the transaction

warningstring

Warnings

Example response

{
  "transactionId": 10,
  "cardBatchId": 11,
  "dateCreated": "2020-01-01 00:00:00",
  "status": "APPROVED",
  "user": "Helcim System",
  "type": "purchase",
  "amount": 11.99,
  "currency": "CAD",
  "avsResponse": "M",
  "cvvResponse": "Y",
  "cardType": "Visa",
  "approvalCode": "HCMAPPRV",
  "cardToken": "5454HCMXTEST5454",
  "cardHolderName": "John Smith",
  "customerCode": "CST1010",
  "invoiceNumber": "INV2022",
  "warning": "Failed to link customer to invoice"
}