Integrating with your Checkout Processes

Read about how to integrate your checkout processes with the Taxamo API's data model.

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.



If you need further help, contact support at https://www.vertexinc.com/en-gb/support-services/taxamo-customer-support.

Did this page help you?