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

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.

---

💸 Fees Structure

Control how service or processing fees are applied:

• Fixed fees (e.g., $2 per transaction)
• Percentage-based fees (e.g., 2.9% of the total)
• Choose whether fees are:
  • Passed on to the customer (they pay extra)
  • Absorbed by your business (you receive a little less)

Click Additional Features then go to Fees to setup fees for your checkout form.

This gives flexibility in how costs are handled between you and 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)

Click Additional Features then go to Customer Information to hide or show fields.

This ensures you're collecting just what you need—no more, no less.

---

⚡ Payment Behavior

Choose what happens after the customer fills out the form:

• Immediately process the payment
  → The customer is charged as soon as they submit.
• 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	❌ No	Customer's ZIP code
invoice	String	❌ No	Unique invoice number for the transaction
splitConfig	JSON	❌ No	Split payment configuration for multi-recipient transactions
cardHolderName	String	❌ No	Cardholder's name
mobileNumber	String	❌ No	Customer's phone number
isEmailEnabled	Boolean	❌ No	Show or hide email field
isZipCodeEnabled	Boolean	❌ No	Show or hide ZIP code field
orderItems	json	❌ No	Order information
fee_amount	Float	❌ No	Amount in decimal (e.g., 1.34 for $1.34) or absolute percent 2.3 for 2.3%
fee_type	String	❌ No	fixed or percent
fee_mode	String	❌ No	pass_through or absorbed

Example of Fee scenarios:

Fixed Fee (Pass-Through) Fee: $2.00 Mode: pass_through totalAmount: $102.00 netAmount: $100.00

Fixed Fee (Absorbed) Fee: $2.00 Mode: absorbed totalAmount: $100.00 netAmount: $98.00

Percent Fee (Pass-Through) Fee: 2.5% Mode: pass_through totalAmount: $102.50 netAmount: $100.00

Percent Fee (Absorbed) Fee: 2.5% Mode: absorbed totalAmount: $100.00 netAmount: $97.56 (Fee calc: 100 - (100 / 1.025) ≈ 2.44)

Example of orderItems json:

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