---
title: "Process a capture: completes a payment previously authorized through Preauthorize"
method: POST
path: "/transaction/{apiKey}/capture"
tags: ["transaction"]
---

# Process a capture: completes a payment previously authorized through Preauthorize

`POST /transaction/{apiKey}/capture`

## Request

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

## Path parameters

- `apiKey` string, required

## Request body

- Capture
  - `merchantTransactionId` string, required
  - `additionalId1` string
  - `additionalId2` string
  - `extraData` ExtraData
  - `pspPassthroughData` PspPassthroughData
  - `merchantMetaData` string
  - `referenceUuid` string, required
  - `amount` string, required
  - `currency` string, required
  - `paymentToken` union
    - ExternallyProvisionedApplePayToken
      - `type` 'EXTERNAL-NETWORK' | 'EXTERNAL-GOOGLEPAY' | 'EXTERNAL-APPLEPAY', required
      - `token` string, required
      - `cryptogram` string
      - `paymentAccountReference` string
      - `tokenExpirationMonth` string, required
      - `tokenExpirationYear` string, required
      - `eciIndicator` string
    - ExternallyProvisionedGooglePayToken
      - `type` 'EXTERNAL-NETWORK' | 'EXTERNAL-GOOGLEPAY' | 'EXTERNAL-APPLEPAY', required
      - `token` string, required
      - `cryptogram` string
      - `paymentAccountReference` string
      - `tokenExpirationMonth` string, required
      - `tokenExpirationYear` string, required
      - `eciIndicator` string
    - ExternallyProvisionedNetworkToken
      - `type` 'EXTERNAL-NETWORK' | 'EXTERNAL-GOOGLEPAY' | 'EXTERNAL-APPLEPAY', required
      - `token` string, required
      - `cryptogram` string
      - `paymentAccountReference` string
      - `tokenExpirationMonth` string, required
      - `tokenExpirationYear` string, required
      - `eciIndicator` string
  - `description` string
  - `items` object[]
    - `identification` string
    - `name` string
    - `description` string
    - `quantity` union
      - integer
      - string
    - `price` union
      - number
      - string
    - `currency` string
    - `l2l3Data` object
      - `type` string
      - `unit` string
      - `unitPrice` string
      - `discount` string
      - `discountRate` string
      - `shippingAmount` string
      - `taxAmount` string
      - `taxRate` string
      - `commodityCode` string
      - `taxDetails` object[]
        - `type` string
        - `amount` string
        - `rate` string
        - `code` string
        - `taxId` string
        - `applied` string
        - `exemptionCode` string
    - `extraData` ExtraData
  - `splits` object[]
    - `identification` string
    - `amount` number
    - `currency` string
    - `sellerMerchantGuid` string
    - `sellerMerchantExternalId` string
    - `commissionFee` object
      - `amount` number
      - `currency` string
  - `isFinalCapture` boolean
  - `l2l3Data` L2L3Data
    - `taxAmount` string
    - `vatRegistrationNumber` string
    - `nationalTaxIncluded` string
    - `discountAmount` string
    - `commodityCode` string
    - `freightAmount` string
    - `freightTaxAmount` string
    - `dutyAmount` string
    - `taxDetails` object[]
      - `type` string
      - `amount` string
      - `rate` string
      - `code` string
      - `taxId` string
      - `applied` string
      - `exemptionCode` string

## 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)