The country_change callback

With KCO Global, an optional server-side callback, country_change is available.

NOTE: Multiple callbacks for a refine call should not be made. If you have already called address_update, do not also call country_change.


The country_change callback works as the address_update and shipping_option_update callbacks.

It uses the same:

  • Payload
  • Responses
  • Error handling

as the other callbacks.

When to use

The country_change callback should be called when the billing address country is changed.

Callback options

With KCO Global, all callbacks include these features:

  • currency is part of the payload
  • currency can be updated by the merchant
  • a 3xx redirect url is available (as for order validation callback)