Confirm Transaction

Read about how to use the Confirm Transaction request.

To confirm a transaction, use the following URL and a POST method to achieve this:

{Taxamo_A_URL}/api/v3/seller/transactions/{key}/confirm

where:

  • {Taxamo_A_URL} is the URL of the sandbox or production environment.
  • {key} is the transaction key value. This specifies which transaction you wish to confirm.

For example:

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

Details

Type

Value

Endpoint

/api/v3/seller/transactions/{key}/confirm

Method

POST

API Reference Documentation

Confirm Transaction

where {key} is the transaction key value. This specifies which transaction you wish to confirm.

Fields

For a full list of fields, see Fields Reference Overview.

Response Example

The following example shows the information returned by the API:

{
    "transaction": {
        "ship_to_address": {
            "city": "Paris",
            "country_code": "FR",
            "postal_code": "75008 ",
            "street_name": "Rue du Saint-Germain",
            "address_detail": "Chateuax 12",
            "building_number": "55",
            "tax_region": "EU"
        },
        "amount": 62.99,
        "required_fields": {
            "tax_required_fields": [],
            "audit_required_fields": [],
            "storage_required_fields": []
        },
        "marketplace_code": "Taxamo",
        "tax_country_codes": "FR",
        "key": "PoTgs5wAAG86O8NvyCmIBpBTKnNRg8CDMfw-zgw",
        "tax_amount": 6.3,
        "external_unique_id": null,
        "invoice_timestamp": "2021-07-15T11:49:32Z",
        "confirm_timestamp": "2021-07-15T11:50:00Z",
        "tax_liability_owner_codes": "Taxamo",
        "create_timestamp": "2021-07-15T11:49:32Z",
        "transaction_lines": [
            {
                "description": "Smoked herrings",
                "reverse_charge": false,
                "amount": 62.99,
                "tax_rule_applied": "physical-tax",
                "unit_price": 62.99,
                "taxes": [
                    {
                        "rate": 10,
                        "tax_name": "European VAT",
                        "rate_type": "Reduced",
                        "amount_fraction_taxable": 1,
                        "tax_base_amount": 62.99
                    }
                ],
                "tax_amount": 6.3,
                "import_address": {
                    "country_code": "FR",
                    "tax_region": "EU"
                },
                "tax_liability_rule": "physical-shipment-into-EU-goods-below-150-eur-with-ioss-non-EU-supplier",
                "platform_liability_assumed_amount": 62.99,
                "seller_tax_number": "IE3764989CH",
                "tax_region": "EU",
                "invoice_place": "The RDI Hub, Killarney Road, Killorglin, Co. Kerry, V93 KP68",
                "invoice_number": "FR2021-7-15-1",
                "tax_exempt": false,
                "additional_currencies": {
                    "consignment": {
                        "currency_code": "EUR",
                        "fx_date": "2021-07-15T11:49:32Z",
                        "fx_rate": 1,
                        "fx_source": "ECB"
                    }
                },
                "tax_country_code": "FR",
                "special_tax_scheme": "IOSS",
                "line_key": "bWSB5VXnAKfR2P1R",
                "custom_id": "51315A00-DC44-408E-A575-8CE42A32AE1B",
                "first_line_with_same_designator_index": 0,
                "tax_address_kind": "ship_to_address",
                "ship_from_address": {
                    "city": "London",
                    "country_code": "GB",
                    "postal_code": "SW1A 2AA",
                    "street_name": "Wessex End Street",
                    "building_number": "12",
                    "tax_region": "GB"
                },
                "tax_engine": "taxamo",
                "invoice_status": "R",
                "kind": "b2c",
                "invoice_image_url": "{Invoice_url}",
                "tax_number_service": "vies",
                "product_class": "P",
                "fees": [
                    {
                        "amount": {
                            "amount": 6.3,
                            "currency_code": "EUR"
                        },
                        "fee_key": "cf-7d535uzvGLwNP",
                        "rule": "tax-fee",
                        "type": "tax-fee",
                        "seller_code": "seller_vertex_5",
                        "currency_code": "EUR"
                    }
                ],
                "tax_liability_owner_code": "Taxamo",
                "line_num": 1,
                "is_seller_permanent": true,
                "quantity": 1,
                "ioss_number": "{IOSS_Number}",
                "invoice_capable": true,
                "total_amount": 69.29,
                "seller_code": "seller_vertex_5",
                "product_cn_code": "0305420000",
                "invoice_image_url_secret": "DcQR32DtrKoxSBHk",
                "tax_entity_name": "France",
                "tax_supported": true
            }
        ],
        "rev": 2,
        "discounts": [],
        "location_evidence": {},
        "vouchers": [],
        "product_classes": "P",
        "billing_address": {
            "city": "Paris",
            "country_code": "FR",
            "postal_code": "75008 ",
            "street_name": "Rue du Saint-Germain",
            "address_detail": "Chateuax 12",
            "building_number": "55",
            "tax_region": "EU"
        },
        "status": "C",
        "update_timestamp": "2021-07-15T11:49:32Z",
        "fees": [
            {
                "amount": {
                    "amount": 2,
                    "currency_code": "GBP"
                },
                "fee_key": "bIjg2-uGHIrTOmOU",
                "rule": "flat-fee",
                "type": "amount-fee",
                "seller_code": "seller_vertex_5"
            }
        ],
        "buyer_name": "Eric Papin",
        "tax_timestamp": "2021-07-15T11:49:32Z",
        "total_amount": 69.29,
        "invoice_image_url_secret": "DcQR32DtrKoxSBHk",
        "currency_code": "EUR"
    }
}


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

Did this page help you?