Testing the API Integration

After you complete the configuration, you need to test it.

The test cases here are grouped together so you can test the features that you use. You may not need all of these or you may need more, depending on your implementation.

🚧

Caution

These test cases are suggested tests based on a typical installation. You also need to consider your own needs and create test cases to suit.

Connections

NameDescription
Connection and Authentication in the SandboxTo confirm that the connection to the Sandbox environment is correct, verify that the correct x-marketplace-seller-token token has been used to connect to the correct endpoint. You must also configure the test credit card details to authenticate a valid request.
Connection and Authentication in ProductionTo confirm that connection to the Production environment is correct, verify that the correct x-marketplace-seller-token token has been used to connect to the correct endpoint. You must also configure your credit card details to authenticate a valid request.

See API Authentication.

Transactions

After you create and confirm transactions using the API, you can view these in the dashboard in the Transaction List UI. To view it, go to TRANSACTIONS -> LIST.

If you click on a transaction, you can drill down to the details page where you can view the fields that are included in the transaction.

NameDescription
EU Tax LiabilityTest that transactions for each EU country (where you expect Taxamo to have the liability) use the expected VAT rate.
Confirmed and Stored TransactionsTest that the transactions are stored and confirmed by the service.
IOSSFor transactions that are confirmed by the service and where Taxamo has the liability, the ioss_number field is returned in the response from the API. Ensure that this is received and captured by your system. The IOSS number needs to be provided to the parcel carrier.
Shipping LocationsTest that the correct Ship to and Ship from country is provided in the transaction to the service.
Price Inclusivity and ExclusivityTest price inclusivity or exclusivity. You may include the VAT in the displayed amount on page on your site or not.

Test one or both of the following as required:
Test an order that where the price displayed includes the tax.
Test an order where the price displayed does not include the tax.
Custom IDsAdd your custom_id to the transaction to ensure your order reference is stored along with the transaction information. This ID is intended as a means for you to track the transaction in your system.
Multiple Line Orders - Tax Liability

Note: Multiple-line orders means an order with more than one transaction line.
Check an order with multiple lines that the VAT is added correctly.
Multiple Line Orders - TransactionCheck an order with multiple lines is stored and confirmed in the service.
Multiple Line Orders - InvoicesCheck the order with multiple lines creates an email with invoice to your test buyer.
Multiple Site CurrenciesIf your site allows sales in more than one currency, check that the appropriate currency code is sent in the transaction for each code. See Supported Countries and Currencies.
Currency CodesCheck the price in another currency to ensure the correct currency code is passed.

Invoices and Credit Notes

In the case of refunds, a credit note is issued against the original invoice.

NameDescription
Invoices or Credit Notes (Test Buyer)Test that the invoices or credit notes are sent to the test buyer.

Tax Liability

📘

Information

You also test the tax liability for transactions in the Transactions test cases section.

NameDescription
Unsupported CountriesTest a country that the service does not support. For example, create a transaction that is shipped to a country outside the EU. Ensure that your system handles these transactions and they are not sent to the service.
Taxamo is not LiableCreate an order where Taxamo is not liable. For example, a consignment of 160 EUR sent to Ireland.

Shipping (Postage)

NameDescription
ShippingTest an order that includes shipping, ensure shipping is added as product_class=S and is taxed appropriately.
Shipping - Order Confirmation and StorageCheck the order with shipping is stored and confirmed by the service.
Shipping - Line Item DescriptionsCheck that the invoice includes shipping and the line item description displays as expected.

Product Classification

NameDescription
Product Classification CodesIf you want to avail of reduced rates for applicable goods, you need to add a Product Code to your requests. See Configuring Product Codes.

Refunds

See Configuring Refunds.

NameDescription
Partial RefundCreate a partial refund. Ensure the refund is confirmed in the service and a credit note is generated and received by your test buyer.
Full RefundCreate a full refund. Ensure the refund is confirmed in the service and a credit note is generated and received by your test buyer.

Error Testing

See Handling Errors.

NameDescription
Error MessagesCreate an error to ensure that error messages are handled correctly.

Billing

See Configuring Billing Information.

NameDescription
Sandbox Credit CardConfirm that a test credit card has been selected on the billing page on the sandbox.
Production Credit CardConfirm that you have added your actual credit card details on the billing page in your production account.