From 208c1190630e91c6b3debafeeab0af3be5fc0ff2 Mon Sep 17 00:00:00 2001
From: Kieran O'Brien <kieran.obrien@ittybittyapps.com>
Date: Fri, 21 May 2021 11:08:56 +1000
Subject: [PATCH 01/11] Fix mistake in checkout v2 example

---
 README.md | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 40accf7d..b5c1d985 100644
--- a/README.md
+++ b/README.md
@@ -126,7 +126,7 @@ class ExampleActivity: Activity {
     }
 
     override fun onCreate(savedInstanceState: Bundle?) {
-        super.onCreate(savedInstanceState)
+        // ...
 
         Afterpay.setCheckoutV2Handler(object : AfterpayCheckoutV2Handler {
             override fun didCommenceCheckout(onTokenLoaded: (Result<String>) -> Unit) {
@@ -144,10 +144,6 @@ class ExampleActivity: Activity {
                 TODO("Optionally update your application model with the selected shipping option")
             }
         })
-    }
-
-    override fun onCreate(savedInstanceState: Bundle) {
-        // ...
 
         val afterpayCheckoutButton = findViewById<Button>(R.id.button_afterpay)
         afterpayCheckoutButton.setOnClickListener {

From e3c6ac74164bc620e0074b6315ce3f65dd3c9b34 Mon Sep 17 00:00:00 2001
From: Kieran O'Brien <kieran.obrien@ittybittyapps.com>
Date: Fri, 21 May 2021 11:12:20 +1000
Subject: [PATCH 02/11] Fix broken links in README

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index b5c1d985..1feba6f7 100644
--- a/README.md
+++ b/README.md
@@ -13,8 +13,8 @@ The Afterpay Android SDK makes it quick and easy to provide an excellent payment
 - [Features](#features)
 - [Getting Started](#getting-started)
     - [Configuring the SDK](#configuring-the-sdk)
-    - [Launching the Checkout (v1)](#launching-the-checkout-(v1))
-    - [Launching the Checkout (v2)](#launching-the-checkout-(v2))
+    - [Launching the Checkout (v1)](#launching-the-checkout-v1)
+    - [Launching the Checkout (v2)](#launching-the-checkout-v2)
 - [UI Components](#ui-components)
     - [Widget](#widget)
     - [Badge](#badge)

From 875a71690535975e33d7ed16b678a28b8932bab1 Mon Sep 17 00:00:00 2001
From: Kieran O'Brien <kieran.obrien@ittybittyapps.com>
Date: Mon, 24 May 2021 14:23:45 +1000
Subject: [PATCH 03/11] Consolidate locale-related config docs

---
 README.md | 17 +++++++----------
 1 file changed, 7 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 1feba6f7..c0288068 100644
--- a/README.md
+++ b/README.md
@@ -55,9 +55,9 @@ The SDK provides easy integration of the Afterpay web login and checkout process
 
 ### Configuring the SDK
 
-Each merchant has configuration specific to their account which is accessible from the `/configuration` API endpoint. This configuration is used by the SDK for rendering UI components and is applied globally using the [`Afterpay.setConfiguration`][docs-configuration] method.
+Each merchant has configuration specific to their account which is accessible from the `/configuration` API endpoint. This configuration is used by the SDK for rendering UI components with the correct branding and assets, T&Cs, web links, and currency formatting, and is applied globally using the [`Afterpay.setConfiguration`][docs-configuration] method.
 
-The following sample demonstrates how the SDK can be configured using the data supplied by the Afterpay API. It is up to you to decide how to best supply the locale which will determine the terms and conditions provided and currency formatting of the SDK.
+The following sample demonstrates how the SDK can be configured using the data supplied by the Afterpay API. It is up to you to decide how best to supply the locale.
 
 Environment is required only for checkout v2; it's recommended to use `AfterpayEnvironment.PRODUCTION` for release builds and `AfterpayEnvironment.SANDBOX` for all others.
 
@@ -73,7 +73,10 @@ Afterpay.setConfiguration(
 )
 ```
 
-> **NOTE:** The merchant account is subject to change and it is recommended to update this configuration **once per day**. The example project provides a [reference][example-configuration] demonstrating how this may be implemented.
+> **NOTES:**
+> - The configuration must always be set when using the SDK, and before any included components are initialised.
+> - The merchant account is subject to change and it is recommended to update this configuration **once per day**. The example project provides a [reference][example-configuration] demonstrating how this may be implemented.
+> - Configuring the SDK with a UK locale will display Clearpay assets and branding, T&Cs, and currency formatting.
 
 ### Launching the Checkout (v1)
 
@@ -115,9 +118,7 @@ class ExampleActivity: Activity {
 
 ### Launching the Checkout (v2)
 
-Launch the Afterpay express checkout flow by starting the intent provided by the SDK for the given options. For more information on express checkout, including the available options and callbacks, please check the [API reference][express-checkout].
-
-> **NOTE:** Configuration must always be set before calling checkout v2.
+Launch the Afterpay checkout v2 flow by starting the intent provided by the SDK for the given options. For more information on express checkout, including the available options and callbacks, please check the [API reference][express-checkout].
 
 ```kotlin
 class ExampleActivity: Activity {
@@ -239,8 +240,6 @@ app:afterpayColorScheme="blackOnMint|mintOnBlack|blackOnWhite|whiteOnBlack"
 app:afterpayButtonText="payNow|buyNow|checkout|placeOrder"
 ```
 
-> **NOTE:** Setting the configured locale to `Locale.UK` (`"en_GB"`) will display Clearpay assets and branding.
-
 ### Price Breakdown
 
 The price breakdown component displays information about Afterpay instalments and handles a number of common configurations.
@@ -272,8 +271,6 @@ When no payment amount has been set or the merchant account configuration has no
 
 The **Info** link at the end of the component will display a window containing more information about Afterpay for the user.
 
-> **NOTE:** The way the configured currency is formatted and the destination for the info link is determined by the configured locale.
-
 ## Security
 
 To limit the possibility of a man-in-the-middle attack during the checkout process, certificate pinning can be configured for the Afterpay portal. Please refer to the Android [Network Security Configuration][network-config] documentation for more information.

From 2ee68369c1f3ea7aa3d80a7cf9ff6f67038f1862 Mon Sep 17 00:00:00 2001
From: Kieran O'Brien <kieran.obrien@ittybittyapps.com>
Date: Mon, 24 May 2021 14:25:21 +1000
Subject: [PATCH 04/11] Update widget intro docs

---
 README.md | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index c0288068..5de8dd8c 100644
--- a/README.md
+++ b/README.md
@@ -175,11 +175,9 @@ class ExampleActivity: Activity {
 
 ### Widget
 
-The widget displays the consumer's payment schedule, provided by either a token or monetary amount, after checkout and can be updated to reflect changes such as promotional discounts or shipping costs. The widget will also present any issues that might prevent the order from completing. 
+The checkout widget displays the consumer's payment schedule, and can be updated as the order total changes. It should be shown if the order value is going to change after the Afterpay Express checkout has finished. For example, the order total may change in response to shipping costs and promo codes. It can also be used to show if there are any barriers to completing the purchase, like if the customer has gone over their Afterpay payment limit.
 
-The widget can be added to a layout or instantiated in code but an instance must always be initialised with one of the two `init()` functions.
-
-> **NOTE:** Configuration must always be set before initialising the widget.
+The widget can be added to a layout or instantiated in code but an instance must always be initialised with either a checkout token (from checkout v2) or with a monetary amount.
 
 ### Adding the Widget
 ```kotlin

From 01d8a74714eaad026375fb6854a462f45fce5cdb Mon Sep 17 00:00:00 2001
From: Kieran O'Brien <kieran.obrien@ittybittyapps.com>
Date: Mon, 24 May 2021 14:33:44 +1000
Subject: [PATCH 05/11] Update widget init and handler docs

---
 README.md | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 5de8dd8c..9f39beab 100644
--- a/README.md
+++ b/README.md
@@ -177,9 +177,12 @@ class ExampleActivity: Activity {
 
 The checkout widget displays the consumer's payment schedule, and can be updated as the order total changes. It should be shown if the order value is going to change after the Afterpay Express checkout has finished. For example, the order total may change in response to shipping costs and promo codes. It can also be used to show if there are any barriers to completing the purchase, like if the customer has gone over their Afterpay payment limit.
 
-The widget can be added to a layout or instantiated in code but an instance must always be initialised with either a checkout token (from checkout v2) or with a monetary amount.
+The widget can be added to a layout or instantiated in code but an instance must always be initialised in one of the two ways demonstrated below and provided with the required callbacks which will notify your app when the widget is updated or an error occurs, or when an attempt to load an external URL is made.
 
 ### Adding the Widget
+
+Initialising the widget with a token received upon completion of checkout v2 will populate it with information about the transaction.
+
 ```kotlin
 class ReceiptFragment : Fragment() {
 
@@ -204,6 +207,12 @@ class ReceiptFragment : Fragment() {
 }
 ```
 
+Alternatively, if checkout has not been completed or not using checkout v2, the widget may be initialised with a `BigDecimal` representing the total cost of the purchase.
+```kotlin
+view.findViewById<AfterpayWidgetView>(R.id.afterpay_widget)
+    .init("50.00".toBigDecimal(), ::onWidgetExternalLink, ::onWidgetUpdate, ::onWidgetError)
+```
+
 ### Updating the widget
 ```kotlin
 widget.update("50.00".toBigDecimal())

From 57ff7b57bc9cce58e5f088ef1d2d9b1aada4ef22 Mon Sep 17 00:00:00 2001
From: Kieran O'Brien <kieran.obrien@ittybittyapps.com>
Date: Mon, 24 May 2021 14:57:15 +1000
Subject: [PATCH 06/11] Update widget update docs

---
 README.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 9f39beab..2b78ba4e 100644
--- a/README.md
+++ b/README.md
@@ -213,7 +213,10 @@ view.findViewById<AfterpayWidgetView>(R.id.afterpay_widget)
     .init("50.00".toBigDecimal(), ::onWidgetExternalLink, ::onWidgetUpdate, ::onWidgetError)
 ```
 
-### Updating the widget
+### Updating the Widget
+
+The widget can be updated to reflect changes to the order total caused by promo codes, shipping options, etc.
+
 ```kotlin
 widget.update("50.00".toBigDecimal())
 ```

From 341b53478123776b7dbcd0c5c85c19db5f402869 Mon Sep 17 00:00:00 2001
From: Kieran O'Brien <kieran.obrien@ittybittyapps.com>
Date: Mon, 24 May 2021 15:02:16 +1000
Subject: [PATCH 07/11] Update widget styling docs

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index 2b78ba4e..fc885725 100644
--- a/README.md
+++ b/README.md
@@ -213,6 +213,22 @@ view.findViewById<AfterpayWidgetView>(R.id.afterpay_widget)
     .init("50.00".toBigDecimal(), ::onWidgetExternalLink, ::onWidgetUpdate, ::onWidgetError)
 ```
 
+### Styling the Widget
+
+By default the widget will show the Afterpay logo and header but these may be independently disabled when initialising the widget.
+
+```kotlin
+view.findViewById<AfterpayWidgetView>(R.id.afterpay_widget)
+    .init(
+        "50.00".toBigDecimal(),
+        ::onWidgetExternalLink,
+        ::onWidgetUpdate,
+        ::onWidgetError,
+        showLogo = true,
+        showHeading = false
+    )
+```
+
 ### Updating the Widget
 
 The widget can be updated to reflect changes to the order total caused by promo codes, shipping options, etc.

From 16a0f8c6bbc492aae0658c4634c8a506b341df6f Mon Sep 17 00:00:00 2001
From: Kieran O'Brien <kieran.obrien@ittybittyapps.com>
Date: Mon, 24 May 2021 15:17:19 +1000
Subject: [PATCH 08/11] Add widget screenshot to docs

---
 README.md         |   3 +++
 images/widget.png | Bin 0 -> 23187 bytes
 2 files changed, 3 insertions(+)
 create mode 100644 images/widget.png

diff --git a/README.md b/README.md
index fc885725..d2a70740 100644
--- a/README.md
+++ b/README.md
@@ -179,6 +179,8 @@ The checkout widget displays the consumer's payment schedule, and can be updated
 
 The widget can be added to a layout or instantiated in code but an instance must always be initialised in one of the two ways demonstrated below and provided with the required callbacks which will notify your app when the widget is updated or an error occurs, or when an attempt to load an external URL is made.
 
+![Payment Schedule Widget][widget]
+
 ### Adding the Widget
 
 Initialising the widget with a token received upon completion of checkout v2 will populate it with information about the transaction.
@@ -332,6 +334,7 @@ This project is licensed under the terms of the Apache 2.0 license. See the [LIC
 <!-- Links: -->
 [badge-ci]: https://github.com/afterpay/sdk-android/workflows/Build%20and%20Test/badge.svg?branch=master&event=push
 [badge-ktlint]: https://img.shields.io/badge/code%20style-%E2%9D%A4-FF4081.svg
+[widget]: images/widget.png
 [badge-black-on-mint]: images/badge_black_on_mint.png
 [badge-mint-on-black]: images/badge_mint_on_black.png
 [badge-black-on-white]: images/badge_black_on_white.png
diff --git a/images/widget.png b/images/widget.png
new file mode 100644
index 0000000000000000000000000000000000000000..ecc119a854ad4c1ceb90367b899bb3c7b81adc88
GIT binary patch
literal 23187
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

literal 0
HcmV?d00001


From 9373f194c9e0bf556071a44220e896640941bbdf Mon Sep 17 00:00:00 2001
From: Kieran O'Brien <kieran.obrien@ittybittyapps.com>
Date: Mon, 24 May 2021 15:38:54 +1000
Subject: [PATCH 09/11] Update docs to reference component widths/heights

---
 README.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index d2a70740..c0ce2f51 100644
--- a/README.md
+++ b/README.md
@@ -179,6 +179,8 @@ The checkout widget displays the consumer's payment schedule, and can be updated
 
 The widget can be added to a layout or instantiated in code but an instance must always be initialised in one of the two ways demonstrated below and provided with the required callbacks which will notify your app when the widget is updated or an error occurs, or when an attempt to load an external URL is made.
 
+The widget will resize to fit the internal content and should not be made smaller so as to maintain legibility.
+
 ![Payment Schedule Widget][widget]
 
 ### Adding the Widget
@@ -241,6 +243,8 @@ widget.update("50.00".toBigDecimal())
 
 ### Badge
 
+The Afterpay badge can be added to your layout and scaled to suit the needs of your app. Per branding guidelines it requires a minimum width of `64dp`.
+
 ![Black on Mint badge][badge-black-on-mint]
 ![Mint on Black badge][badge-mint-on-black]
 
@@ -254,7 +258,7 @@ app:afterpayColorScheme="blackOnMint|mintOnBlack|blackOnWhite|whiteOnBlack"
 
 ### Payment Buttons
 
-A selection of payment buttons is available to suit most common purchasing scenarios.
+The payment button may be added to your layout and scaled to suit the needs of your app but to maintain legibility the width must not exceed `256dp`.
 
 ![Black on Mint pay now button][button-black-on-mint]
 ![Mint on Black pay now button][button-mint-on-black]

From 2bf41720fb21fe0eaba8693583fb42ca214018ae Mon Sep 17 00:00:00 2001
From: Kieran O'Brien <kieran.obrien@ittybittyapps.com>
Date: Mon, 24 May 2021 15:39:12 +1000
Subject: [PATCH 10/11] Update button text selection docs

---
 README.md | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index c0ce2f51..5bd5e05f 100644
--- a/README.md
+++ b/README.md
@@ -261,10 +261,16 @@ app:afterpayColorScheme="blackOnMint|mintOnBlack|blackOnWhite|whiteOnBlack"
 The payment button may be added to your layout and scaled to suit the needs of your app but to maintain legibility the width must not exceed `256dp`.
 
 ![Black on Mint pay now button][button-black-on-mint]
-![Mint on Black pay now button][button-mint-on-black]
+![Mint on Black buy now button][button-mint-on-black]
 
-![Black on White pay now button][button-black-on-white]
-![White on Black pay now button][button-white-on-black]
+![Black on White checkout with button][button-black-on-white]
+![White on Black place order with button][button-white-on-black]
+
+The button may be styled with different text to suit some common purchasing scenarios:
+- Pay Now
+- Buy Now
+- Checkout with
+- Place order with
 
 **Attributes**
 ```xml

From 8b432784776764dc974871e79271d08bd4587dde Mon Sep 17 00:00:00 2001
From: Kieran O'Brien <kieran.obrien@ittybittyapps.com>
Date: Tue, 25 May 2021 09:06:39 +1000
Subject: [PATCH 11/11] Make reference to tokenless mode

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 5bd5e05f..b3966ac3 100644
--- a/README.md
+++ b/README.md
@@ -211,7 +211,7 @@ class ReceiptFragment : Fragment() {
 }
 ```
 
-Alternatively, if checkout has not been completed or not using checkout v2, the widget may be initialised with a `BigDecimal` representing the total cost of the purchase.
+Alternatively, if checkout has not been completed or your app is not using checkout v2, the widget may be initialised in tokenless mode with a `BigDecimal` representing the total cost of the purchase.
 ```kotlin
 view.findViewById<AfterpayWidgetView>(R.id.afterpay_widget)
     .init("50.00".toBigDecimal(), ::onWidgetExternalLink, ::onWidgetUpdate, ::onWidgetError)