Merchant Location

Overview

Merchant location data is a crucial component in the PayOS ecosystem, providing valuable insights for payment processing and fraud prevention. By understanding where transactions are initiated, merchants can better tailor their services and enhance security measures.

Importance of Merchant Location

Merchant location forms part of the default environment variables that a merchant can configure in their system. During session initiation calls, merchants can pass through the merchantLocation. This information can be a determining factor in how payments are executed, especially in scenarios where the merchant operates in multiple locations.

Example Scenarios:

1. Influencing Payment Methods:

   • If the merchantLocation is set to Kenya, and the merchant has regulatory access to receive payment methods local to Kenya, then those payment options can be rendered during the checkout process. This ensures that customers have access to familiar and trusted payment methods, enhancing their overall experience.

2. Transaction Execution Considerations:

   • The merchantLocation can also be relevant when executing a transaction. For instance, if a customer is paying with a card issued in a different country than the merchant’s location, additional security requirements may be appropriate. This could involve implementing extra verification steps, such as 3D Secure, to mitigate the risk of fraud.

How to Use Merchant Location Data

1. Integration with Rules Engine:

   • Use location data as a condition in your payment rules to customize payment flows.
   • Example: Prioritize mobile money options for transactions initiated in regions where mobile payments are prevalent.

2. Enhancing Customer Experience:

   • Tailor offers and services based on the customer’s location to improve engagement and satisfaction.

3. Monitoring and Reporting:

   • Use location data in reports to analyze transaction trends and optimize business strategies.

Example Rule Using Location Data

1
{
2
  "trigger": {
3
    "on": "determinePaymentOptions",
4
    "filter": {
5
      "paymentMethodCode": "mobileMoney"
6
    }
7
  },
8
  "rules": [
9
    {
10
      "condition": {
11
        "field": "customer.location.country",
12
        "operator": "IS ONE OF",
13
        "value": [
14
          "NG", // Nigeria
15
          "KE"  // Kenya
16
        ]
17
      },
18
      "action": {
19
        "type": "setPriority",
20
        "params": {
21
          "priority": 1
22
        }
23
      }
24
    }
25
  ],
26
  "defaultAction": {
27
    "type": "skip"
28
  },
29
  "workspaceId": "7f9f1882-a103-408d-ac96-46a7021e537a"
30
}