Integrating with your Checkout Processes

Available Requests

The following table summarizes the available requests:

Request	Use Case
Calculate Tax	Calculate tax before a buyer's details are confirmed.
Store Transaction	Store a transaction before the buyer's details are verified.
Confirm Transaction	Confirm a transaction after the buyer's details are confirmed.
Refund Transaction	Issue a full or partial refund.
Retrieve Transaction	Retrieve a specified transaction from the Taxamo database.
Retrieve Transaction Requests	Retrieve all the requests for a specified transaction.

Integrating Tax Calculation

The tax calculation function allows you to retrieve a tax rate from Taxamo.

To model the tax calculation function, you use the Calculate Tax request. For more information, see Calculate Tax.

You can use this to integrate the tax calculation function with your checkout process. For example, you might use it to calculate the tax on a good that is displayed on a UI before a buyer makes a purchase.

Integrating Stored Transactions

The API models transactions where the buyer's details are not confirmed as stored transactions. This is analogous to how an unconfirmed payment might be held until the payment method is cleared in a clearing house for credit cards.

You use the Store Transaction request to integrate these type of transactions with your checkout process. For more information, see Store Transaction.

For example, you might use a Store Transaction request when a buyer places some goods in their basket but has not gone to the checkout to confirm the purchase.

Integrating Confirmed Transactions

The API models payments where the buyer's details are confirmed as confirmed transactions. The payment details are usually confirmed in these cases.

You use the Confirm Transaction request to integrate these type of transactions with your checkout process. For more information, see Confirm Transaction.

For example:

curl --request POST \
  --url https://seller-transaction-api.sandbox.marketplace.taxamo.com/api/v3/seller/transactions/PJyj7WQAAAAYTSOvTCmQLpBvs7KRe1lL6v3GSnQ/confirm \
  --header 'content-type: application/json' \
  --header "x-marketplace-seller-token: $TOKEN" \
  --data '{}'

Retrieving Transactions

You can use the Retrieve Transaction request to retrieve the details for a specified transaction key. For more information, see Retrieve Transaction.

Retrieving Transaction Requests

You can use the Retrieve Transaction Requests request to retrieve all the requests for a specified transaction key. For more information, see Retrieve Transaction Requests.

Configuring Refunds

For more information, see Configuring Refunds.