---
updatedAt: 2026-02-26T13:10:41.000Z
agentTools:
  projectIndex: https://docs.ksa.ngenius-payments.com/llms.txt
---

# Pre-populate Cardholder's Name on Pay Page

The feature aims to enhance the user experience for merchants by automating the retrieval and display of the cardholder's name from the billing address.

<br />

**How does it work?**

Merchants now possess the ability to define a new attribute within `merchantAttributes `named `showPayerName`, which accepts a boolean value (either `true `or `false`). Depending on the value set for `showPayerName`, the system will automatically retrieve and pre-fill the cardholder's name on the payment page with the corresponding first and last names provided in the billing address.

Sample request to create order is below,

```json
{
    "action": "PURCHASE",
    "amount": {
        "currencyCode": "SAR",
        "value": 100
    },
    "merchantAttributes": {
        "paymentAttempts": "3",
        "cancelUrl": "http://www.abc.com",
        "offerOnly": "VISA",
        "showPayerName": true
    },
    "billingAddress": {
        "firstName": "Cardholder_firstname",
        "lastName": "Cardholder_lastname",
        "city": "Riyadh",
        "state": "Riyadh",
        "country": "Saudi Arabia",
        "countryCode": "SA",
        "postalCode": "12211"
    }
}
```

<br />

Below image shows payment page featuring the cardholder's name pre-filled based on the order request above:

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/4ee31a7be0997f841e91f687c70171ac9a59afd9b4dcfd37ffcf6d73700761b8-image.png",
        null,
        ""
      ],
      "align": "center",
      "border": true
    }
  ]
}
[/block]