Customizing Your Payment Checkout Page with Digitzs

The Digitzs Checkout Customization Page gives you the ability to tailor your payment page to match your brand and customer experience goals. Whether you're a business owner or team member managing customer transactions, this guide will walk you through what you can do—no coding needed.

---

🔗 Accessing the Customization Page

Click the link provided to access your customization panel:
👉 Digitzs Checkout Customization Page

Note: You'll need to provide your own credentials in the URL parameters:

• merchant_id=YOUR_MERCHANT_ID
• api_key=YOUR_API_KEY
• app_key=YOUR_APP_KEY

You may need credentials such as:

• Merchant ID
• API Key
• App Key

These are typically provided by your technical team or Digitzs account manager.

---

🛠️ Customization Options

Once you're inside the panel, you can configure the following:

🎨 Look and Feel

Make the checkout page match your brand:

• Customize colors (buttons, background, text)
• Choose font styles
• Preview changes live

Click Appearance to see the various style customization options.

This helps create a smooth and trustworthy experience for your customers.

---

📋 Optional and Required Fields

You decide which details you want to collect from your customers:

• Required Fields: things they must fill out (e.g., name, email, card number)
• Optional Fields: extras that are nice to have but not mandatory (e.g., phone number, company name)

---

⚡ Payment Behavior

Choose what happens after the customer fills out the form:

• Return a payment token only
  → The customer fills in their info, then the form returns secure token to charge later using the Payment API.

This is useful if you want more control over when payments are finalized (e.g., in a delayed billing, recurring payments or approval workflow).

---

✅ Saving and Testing Changes

1. Preview your changes to see how the checkout page looks.
2. Click Save to apply changes.
3. Run test payments in sandbox mode to make sure everything works as expected.

---

💬 Need Help?

If you're unsure about a setting or something isn't working:

• Reach out to your technical team
• Contact Digitzs Support
• Refer to the Digitzs documentation or account portal

🚀 Advanced Configuration

We allow you to personalize the checkout experience by adding URL query parameters. These parameters are the same parameters used by the checkout emulator to customize your form

Query Parameters for Customization

Parameter	Type	Required	Description
amount	Integer	✅ Yes	Amount in cents (e.g., 1000 for $10.00)
email	String	✅ Yes	Customer's email address
zip	String	✅ Yes	Customer's ZIP code
invoice	String	✅ Yes	Unique invoice number for the transaction
splitConfig	JSON	❌ No	Split payment configuration for multi-recipient transactions
cardHolderName	String	✅ Yes	Cardholder's name
mobileNumber	String	✅ Yes	Customer's phone number
isEmailEnabled	Boolean	✅ Yes	Show or hide email field in the UI. Note: Even if hidden, you should still pass the actual email value using the email parameter, as it's required for payment processing.
isZipCodeEnabled	Boolean	✅ Yes	Show or hide ZIP code field in the UI. Note: Even if hidden, you should still pass the actual ZIP code value using the zip parameter, as it's required for payment processing.
orderItems	JSON	✅ Yes	Order information

Example of orderItems json:

  "orderItems": [
    {
      "type": "string (optional)",
      "description": "string (optional)",
      "quantity": "number (required)",
      "price": "number (required)",
      "sku": "string (required)"
    }
  ]