Capture / Ticket Request

Pre-Auth (Auth-Only) transactions allow users to hold a specific amount for processing at a later time without needing to re-enter account details. A Capture/Ticket Request is used to finalize an Auth-Only (Ticket) transaction, ensuring the held amount is processed without requiring the account data to be entered again.
Follow the steps and references outlined in this section to perform a Capture/Ticket transaction.
Capture request used to post capture an Auth only transaction without re-entering account data.

Request Body

application/xml

RefId*string

Must match the RefId from the original transaction.

Lengthlength <= 50

RegisterId*string

Alphanumeric reference field.

Lengthlength <= 50

TPN?string

Alphanumeric TPN field.

Lengthlength <= 12

AuthKey?string

Required if the terminal is configured to use AuthKey.

Lengthlength <= 25

TransType*string

Identifies the type of transaction to run – Capture.

Lengthlength <= 20

Value in"Capture"

Amount*number

Base dollar amount of the original transaction.

Tip?number

Dollar amount of tip to add. Tip must be enabled on the terminal.

AcntLast4?string

Last 4 digits of the account number from the original Auth-Only (Ticket) transaction, used to verify the card being captured.

MerchantId?string

Optional for regular transactions when Multi MID (MMID) is not enabled; mandatory when MMID is enabled in which case the MerchantId must be the TPN (Terminal Provider Number) mapped to the target MID to ensure the transaction is routed correctly..

Lengthlength <= 12

CustomerEmail?string

Pre-fills the Send Email Receipt screen.

CustomerMobile?string

Pre-fills the Text Receipt screen.

IsTxnStatusScreenRequired?boolean

Indicates whether the terminal should display the transaction status screen after processing.

Response Body

`application/xml`

curl -X GET "https://example.com" \  -H "Content-Type: application/xml" \  -d '<request>    <AuthKey/>    <RegisterId>3</RegisterId>    <TPN/>    <TransType>Capture</TransType>    <Amount>100.00</Amount>    <Tip>10.00</Tip>    <AcntLast4/>    <RefId>2</RefId>    <MerchantId/>    <CustomerMobile/>    <CustomerEmail/>    <IsTxnStatusScreenRequired>true</IsTxnStatusScreenRequired>  </request>'

<response>
  <RefId>2</RefId>
  <RegisterId>3</RegisterId>
  <TPN>xxx</TPN>
  <ResultCode>0</ResultCode>
  <Message>Success</Message>
  <PaymentType>Credit</PaymentType>
</response>

Capture / Ticket Request

Request Body

Response Body

200application/xml

`application/xml`