Update Items

On this page you will find all necessary information about How to Update items. Make sure you check Embed Checkout article, before continuing reading this article.

When updating items in the cart, the merchant should:

Send updated cart to Checkout
Refresh app to show the updated price

1. Send updated cart to Checkout

In order to send updated cart to Checkout application, merchant has to send a PUT request with “Partner access token” as authorization with JSON data to /api/partner/payments/{purchaseid}/items. “Purchase ID” has to be included in the URL.

More information about generating a “Partner access token” here: Obtain partner access token for the purchase

More information about getting a “Purchase ID” for a current session here: Initialize payment

# Send updated cart to Checkout
PUT {api_url}/api/partner/payments/{purchaseid}/items
Authorization: Bearer {partner_access_token}
Content-type: application/json
 
{
  "items": [
    {
      "description": "Test Item 1",
      "notes": "Test Notes 1",
      "amount": 100,
      "taxCode": "20",
      "taxAmount": 20,
      "quantity": 2
    }
  ]
}

Property	Data type	Description
`items`	[]	List Item

Item:

Property	Data type	Description
Description	string	Name of item
Notes	string	Optional notes
Amount	decimal	Item cost
TaxCode	string	Tax code
TaxAmount	decimal	Tax amount
Quantity	decimal	Quantity

Example

<?php
$api_url = "https://stage.checkout-api.avarda.com";
// "Partner access token" generated by calling `$api_url/api/partner/tokens` see more info: <https://docs.avarda.com/checkout-3/getting-started/#obtain-partner-access-token>
$partner_access_token = "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1dCI6InBpVmxsb1FEU01LeGgxbTJ5Z3FHU1ZkZ0ZwQSIsImtpZCI6...";
// "PurchaseId" of the current session
$purchase_id = "GVPF5b";
 
 
// Send PUT request to update items
$update_items_url = "$api_url/api/partner/payments/$purchase_id/items";
$update_data = array(
    "items" => array(array(
        "description" => "Test Item 1",
        "notes" => "Test Notes 1",
        "amount" => 200,
        "taxCode" => "20%",
        "taxAmount" => 40,
        "quantity" => 2
    )),
);
 
$options = array(
    'http' => array(
        'header'  => "Content-type: application/json\r\nAuthorization: Bearer $partner_access_token\r\n",
        'method'  => 'PUT',
        'content' => json_encode($update_data)
    )
);
$context  = stream_context_create($options);
$update_result = file_get_contents($update_items_url, false, $context);
if ($update_result === false) { /* Handle error */
} else {
    $update_response = json_decode($update_result);
    echo "Updated Successfully";
};

2. Refresh app to show the updated price

This ensures that the form will be reloaded with the actual price.

window.avardaCheckout.refreshForm();

PHP integration example

Check the PHP demo example of Checkout 3.0 integration in our public repository on GitHub: https://github.com/avarda-ab/checkout3-phpdemo (opens in a new tab)

External Payment Methods Pay on delivery