How to Display Interest Rate in Shopify Order Record?
The installment surcharge doesn't show up in the Shopify order record. Show it automatically in the admin with iyzico Admin.
Author: Efe Gündüz Nodus Works Shopify Agency Founder Published 6 min read
To display the installment surcharge in a Shopify order record, install iyzico Admin, iyzico's free app. It writes the surcharge from iyzico installment payments to an order metafield visible in Shopify Admin's order details. Otherwise the surcharge never reaches the order. The app doesn't work with PayTR, Param or other virtual POS providers and doesn't show the surcharge to customers.
For stores selling in installments on Shopify, iyzico does not automatically add the installment surcharge to the order record; the order total only shows the product price. iyzico Admin (listed in the App Store under its full name, iyzico Admin Metafields) is a free app developed by iyzico that automatically adds this surcharge to the order details in Shopify Admin. For brands with a high share of installment sales, this discrepancy complicates accounting reconciliation: the amount on the bank statement does not match the amount in the order record.
How to Display the Interest Rate Difference in Shopify Order Records?
To display the installment surcharge in a Shopify order record, install the iyzico Admin app; it automatically adds the surcharge from installment payments to the order details in Shopify Admin.
The app reads the surcharge amount from the iyzico payment result and writes it directly to the order's metafield. This is back-office/accounting data that the store owner sees when opening the order in Shopify Admin; it is not automatically shown to the customer in the order confirmation email or on their account page. Stores that want customers to see it must add this metafield to their theme or email template themselves; the app doesn't do this.
The application is based in Turkey, the interface is in Turkish, and developer support is provided via docs.iyzico.com. It is free and does not require any additional payment or subscription.
Why Isn't the Installment Surcharge Added to the Order Total Automatically?
The installment surcharge is calculated by the payment provider (iyzico), not by Shopify's order engine, so it doesn't match the order total. The installment option and the related surcharge are determined in iyzico's own interface during the payment step, and this information isn't passed back to Shopify by default.
In practice, this gap causes problems in two areas: month-end accounting reconciliation (where bank statements and order reports are compared manually) and partial refund calculations (where it is impossible to determine from the order record whether the refund amount should include the surcharge).
| Status / Process | Without iyzico Admin | With iyzico Admin |
|---|---|---|
| Order Amount | Only the product price is displayed. | Product price + installment surcharge (displayed in the Metafield). |
| Accounting Reconciliation | Requires manual comparison with the bank statement. | Can be read directly from the order record, making reconciliation easier. |
| Refund Calculation | The iyzico panel must also be checked separately. | The installment surcharge is visible on the order; refund processes can be clearly tracked through Shopify. |
Interest Difference Calculation Example: The Gap Between Order Amount and Collection
The surcharge grows with the number of installments, so the gap between the order amount and the amount actually collected widens accordingly. For a 1,000 ₺ product paid in 6 installments, the amount collected from the customer may range from 1,050 ₺ to 1,090 ₺ depending on the bank's surcharge rate; however, the order record in Shopify will still show 1,000 ₺.
| Number of Installments | Shopify Order Amount | Estimated Amount Charged (Including Installment Surcharge) | Difference Not Visible in the Order Record |
|---|---|---|---|
| Single Payment | 1,000 ₺ | 1,000 ₺ | 0 ₺ |
| 3 Installments | 1,000 ₺ | ~1,030 ₺ | ~30 ₺ |
| 6 Installments | 1,000 ₺ | ~1,070 ₺ | ~70 ₺ |
| 12 Installments | 1,000 ₺ | ~1,130 ₺ | ~130 ₺ |
In a store with 200 installment orders a month, if half of them are paid in 6 installments, a gap of about 7,000 ₺ builds up between the order records and the amount deposited in the bank account for that group alone. Each difference may look small, but together they become a month-end item the accounting team has to reconcile manually.
Manual Reconciliation vs. iyzico Admin Comparison
Without iyzico Admin, reconciling installment surcharges requires the store team to manually compare bank statements with order reports; once the app is installed, the surcharge appears directly in the order record and manual comparison is no longer needed. If you want to set up installment payments as part of your store build, our Shopify store setup service also covers iyzico and PayTR payment integration.
| Process | Manual Reconciliation | With iyzico Admin |
|---|---|---|
| Source of Installment Surcharge | Manually identified from the bank statement. | Automatically displayed in the order Metafield. |
| Month-End Reconciliation Time | Can take several hours depending on order volume. | Can be read directly and quickly from the order report. |
| Refund Amount Calculation | The iyzico panel must also be checked separately. | The installment surcharge is already visible on the order. |
| Risk of Error | High; manual comparison carries a risk of overlooking discrepancies. | Low; since the data is entered automatically, the risk of error is minimized. |
How to Install iyzico Admin?
- Open the iyzico Admin page in the Shopify App Store
- Click Add app and select your store
- Confirm the connection with your iyzico account
- The app requests permission to view and edit orders; in the App Store listing, this permission appears as the last 60 days of order history. The app writes the surcharge to the order after the payment is completed; the listing does not state that it processes past orders retroactively
- Once installation is complete, surcharges for new orders automatically appear in the metafield
Frequently Asked Questions
Is iyzico Admin paid? No, the app is completely free. It does not require any additional subscription or transaction fees.
Does iyzico Admin work with PayTR or other payment providers? No. The app can only read surcharges for installment transactions processed through iyzico.
Where does the installment surcharge appear in the order record? It appears in a metafield in the order details; you can see it when you open the order in Shopify Admin.
What data does the application access? According to its App Store listing, it requests permission to view the last 60 days of order history and edit orders, access to customers' device and activity data (location, IP address, browser and operating system), and the store owner's contact information. The order editing permission lets it write the surcharge to the order details after the payment is completed.
Can the customer see the installment surcharge on the order page? No, not by default. iyzico Admin writes the surcharge to a metafield in the admin, where only the store owner sees it; stores that want to show it to customers must add it to their theme or email templates themselves.
Conclusion
iyzico Admin solves a narrow but real operational problem: the installment surcharge not showing up in the order record. It is a free app that takes only a few minutes to set up for stores selling in installments with iyzico. You can check out the app on the Shopify App Store.