Webhook Format

Category

Triggered When

approved

Transaction status is APPROVED

declined

Transaction status is anything other than APPROVED (HOST_DECLINED, INVALID etc)

Field

Type

Description

id

string (UUID)

Unique event identifier. Use this for idempotency.

type

string

Event category: approved or declined

created

string (ISO 8601)

Timestamp of the event

merchantId

string

Your TNS merchant identifier. Note - this will be different to your Acquirers Bank Merchant ID.

data.transactionId

string (UUID)

The transaction identifier

data.action

string

Transaction action: SALE, AUTHORIZATION, CAPTURE, LINKED_REFUND, VOID

data.status

string

Transaction status: APPROVED, HOST_DECLINED, INVALID, SUSPECT

data.isApproved

boolean

Whether the transaction was approved. TRUE,FALSE

data.amount

integer

Amount in minor currency units (e.g. 1500 = $15.00)

data.currency

string

ISO 4217 currency code (e.g. EUR, USD, GBP)

data.cardType

string

Card scheme: VISA, MASTERCARD, AMEX, etc.

data.firstSix

string

First 6 digits of the card number

data.lastFour

string

Last 4 digits of the card number

data.responseCode

string

TNS platform response code

data.responseText

string

Human-readable response description

data.authCode

string

Authorisation code (present when approved)

data.originalTransactionId

string

Original transaction reference (for subsequent transactions such as refunds, voids, captures)

data.clientReference

string

Your merchant-supplied reference

data.receiptNumber

string

TNS receipt number