To facilitate the sale of digital goods, the service can collect different types of location evidence, depending on your needs.

You must specify at least three types of location evidence.

By default, these are processed in the following order. This can vary depending on your implementation:

Self-declared address
Credit card prefix limited to 8 digits
IP address
Billing address

You specify the evidence value in your Store Transaction request. For example, you can specify an IP address if you want to use that for the evidence value:

{
     "transaction": {
          "transaction_lines": [
               {
                    "product_class": "D"
               }
          ],
          "location_evidence": {
               "by_ip_address": {
                    "evidence_value": "123.123.123.123"
               },

The service returns the following:

{
     "transaction": {
          "transaction_lines": [
               {
                    "product_class": "D"
               }
          ],
          "location_evidence": {
               "by_ip_address": {
                    "resolved_country_code": "IE",
                    "evidence_value": "123.123.123.123"
               },

Location evidence types

For a default implementation, you must specify three of four possible types of evidence. These types are listed in the Location Evidence Object topic.

The following example shows the different types of evidence that can be returned by the service. Note that the billing and self-declared addresses are specified on the transaction level rather than the transaction-line level:

{
  "transaction": {
    "billing_address": {
      "country_code": "CA",
      "country_subdivision_code": "QC",
      "city": "Quebec",
      "postal_code": "12345",
      "street_name": "Main Street"
    },
    "self_declared_address": {
      "country_code": "CA",
      "country_subdivision_code": "QC"
    },
    "location_evidence": {
      "by_cc": {
        "resolved_country_code": "CA",
        "evidence_value": "1234567"
      },
      "by_ip_address": {
        "resolved_country_code": "CA",
        "evidence_value": "123.123.123.123"
      },
      "by_billing": {
        "resolved_country_code": "CA",
        "country_code": "CA"
      }
    }
  }