transaction

Process a register: registers a customer's payment instrument for future use (Debit or Preauthorize)

Changed on Nov 7, 2026

post/transaction/{apiKey}/register

Request

Base URL
https://gateway.tillpayments.com/api/v3
Auth
HTTP basic
TypeScript
https://skmtc.dev/tillpayments/apis/till-payments-gateway/docs/transaction/:apiKey/register/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

apiKeystring required

API Key of Connector

Request body

merchantTransactionIdstring required

additionalId1string

additionalId2string

extraDataExtraData

pspPassthroughDataPspPassthroughData

merchantMetaDatastring

successUrlstring

cancelUrlstring

errorUrlstring

callbackUrlstring

transactionTokenstring

descriptionstring

languagestring

referenceUuidstring

UUID of a previous register transaction on the same merchant. Used by the register-with-expiry-update flow to point at the existing token whose expiry date should be patched. When set together with extraData.expiryMonthUpdate / expiryYearUpdate, the request becomes a card-data-less expiry refresh — no PAN/CVV is required.

Response

Transaction response

successboolean

uuidstring

purchaseIdstring

redirectType'iframe' | 'fullpage' | '3ds'

redirectUrlstring

redirectQRCodestring

DataUrl

htmlContentstring

paymentDescriptorstring

paymentMethodstring

adapterMerchantTransactionIdstring

Adapter/PSP-side merchant transaction identifier recorded for transaction matching and reconciliation. Omitted when unavailable.

amountstring

surchargeAmountstring

gstAmountstring

totalAmountstring

adapterMessagestring

adapterCodestring

extraDataExtraData

Example response

{
  "returnData": {
    "cardUpdatedAt": "2024-05-07 00:00:00",
    "cardUpdatePausedUntil": "2024-05-07"
  }
}

Changes

Nov 7, 202642c40d316a83 Revision changes
- warning
  changed the pattern of the request property // from ^[\-]?\d+$ to ^[\-\+]?\d{1,4}$
- info
  added the new optional request property /
- info
  added the new optional request property
- info
  added the new Eftpos enum value to the request property /
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
Apr 27, 20255d765c6bfe90 Revision changes
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status

Operation history (3 revisions)