Purchase

The purchase command allows you to initiate a transaction for an amount equal to the totalAmount specified in the request body.

Additionally you can separate the transaction into several smaller ones which is know as a partial transaction. This can occur when a customer uses a gift card with a remaining balance below the total purchase amount, in which case, subsequent transactions must be initiated until there is no remaining amount in the response. The initial transaction in the partial transaction flow will return a remainingAmount value that will be sent in follow-up transactions to bypass the tip select screen so customers aren't prompted to give a tip for each transaction. 

List of coding scenarios that use this endpoint:

1. Standard Transaction Flow

2. Partial Approval Transaction Flow

3. Tax Functionality

4. Transaction Canceled Terminal Flow

5. Idempotency Request

NOTE

Each transaction in the partial transaction flow is considered a separate transaction and will have its receipt.

Request Structure

Response Structure

Errors

If your response contains errors, visit the Errors page for a detailed description of each one.