---
title: "Process a deregister: deletes a previously registered payment instrument"
method: POST
path: "/transaction/{apiKey}/deregister"
tags: ["transaction"]
---

# Process a deregister: deletes a previously registered payment instrument

`POST /transaction/{apiKey}/deregister`

## Request

- Base URL: `https://secure.tillpayments.com/api/v3`
- URL: `https://secure.tillpayments.com/api/v3/transaction/{apiKey}/deregister`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/tillpayments/apis/tillpayments-com-payment-platform/docs/transaction/:apiKey/deregister/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `apiKey` string, required

## Request body

- Deregister
  - `merchantTransactionId` string, required
  - `additionalId1` string
  - `additionalId2` string
  - `extraData` ExtraData
  - `pspPassthroughData` PspPassthroughData
  - `merchantMetaData` string
  - `referenceUuid` string
  - `tokenType` 'ALL' | 'PAN' | 'NT'

## Response `200`

Transaction response

- TransactionResponse
  - `success` boolean
  - `uuid` string
  - `purchaseId` string
  - `returnType` 'FINISHED' | 'REDIRECT' | 'HTML' | 'PENDING' | 'ERROR' | 'PENDING_DCC'
  - `redirectType` 'iframe' | 'fullpage' | '3ds'
  - `redirectUrl` string
  - `redirectQRCode` string: DataUrl
  - `htmlContent` string
  - `paymentDescriptor` string
  - `paymentMethod` string
  - `returnData` union
    - ReturnCardData
      - `_TYPE` 'cardData'
      - `type` string
      - `firstName` string
      - `lastName` string
      - `country` string
      - `cardHolder` string
      - `expiryMonth` string
      - `expiryYear` string
      - `binDigits` string
      - `firstSixDigits` string
      - `lastFourDigits` string
      - `fingerprint` string
      - `binBrand` string
      - `binBank` string
      - `binType` string
      - `binLevel` string
      - `binCountry` string
      - `threeDSecure` string
      - `eci` string
      - `merchantAdviceCode` string
      - `parsedMerchantAdviceCode` string
      - `schemeTransactionIdentifier` string
    - ReturnPhoneData
      - `_TYPE` 'phoneData'
      - `phoneNumber` string
      - `country` string
      - `operator` string
    - ReturnIbanData
      - `_TYPE` 'ibanData'
      - `accountOwner` string
      - `iban` string
      - `bic` string
      - `mandateId` string
      - `mandateDate` string
      - `bankName` string
      - `bankBranchName` string
      - `country` string
    - ReturnWalletData
      - `_TYPE` 'walletData'
      - `walletReferenceId` string
      - `walletOwner` string
      - `walletType` string
  - `scheduleData` ScheduleData
    - `scheduleId` string
    - `scheduleStatus` 'ACTIVE' | 'PAUSED' | 'CANCELLED' | 'ERROR' | 'CREATE-PENDING'
    - `scheduledAt` string
    - `merchantMetaData` string
  - `customerProfileData` CustomerProfileData
    - `profileGuid` string
    - `customerIdentification` string
    - `markAsPreferred` boolean
  - `riskCheckData` object
    - `riskCheckResult` 'APPROVED' | 'DECLINED' | 'REVIEW'
    - `riskScore` number
    - `threeDSecureRequired` boolean
  - `errors` object[]
    - `errorMessage` string
    - `errorCode` integer
    - `adapterMessage` string
    - `adapterCode` string
  - `adapterMessage` string
  - `adapterCode` string
  - `extraData` ExtraData
  - `dccData` object
    - `uuid` string
    - `originalAmount` string
    - `originalCurrency` string
    - `convertedAmount` string
    - `convertedCurrency` string
    - `conversionRate` number
    - `disclaimer` string

---

[API](https://skmtc.dev/tillpayments/apis/tillpayments-com-payment-platform.md) - [All operations](https://skmtc.dev/tillpayments/apis/tillpayments-com-payment-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/tillpayments/apis/tillpayments-com-payment-platform/revisions/feae5abc6a8b?raw)